From ff1a39e36a9d4450ce5921c43fbef40810d28d55 Mon Sep 17 00:00:00 2001 From: Hugh Nimmo-Smith Date: Thu, 20 Nov 2025 15:02:34 +0000 Subject: [PATCH] List M_RESOURCE_LIMIT_EXCEEDED under correct error code section (#2232) Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com> --- .../newsfragments/2232.clarification | 1 + content/client-server-api/_index.md | 22 +++++++++---------- 2 files changed, 12 insertions(+), 11 deletions(-) create mode 100644 changelogs/client_server/newsfragments/2232.clarification diff --git a/changelogs/client_server/newsfragments/2232.clarification b/changelogs/client_server/newsfragments/2232.clarification new file mode 100644 index 00000000..78304051 --- /dev/null +++ b/changelogs/client_server/newsfragments/2232.clarification @@ -0,0 +1 @@ +`M_RESOURCE_LIMIT_EXCEEDED` is now listed as a common error code. diff --git a/content/client-server-api/_index.md b/content/client-server-api/_index.md index 637a5566..c4b632bb 100644 --- a/content/client-server-api/_index.md +++ b/content/client-server-api/_index.md @@ -136,6 +136,17 @@ code if the endpoint is implemented, but the incorrect HTTP method is used. {{% added-in v="1.17" %}} The device ID supplied by the application service does not belong to the user ID during [identity assertion](/application-service-api/#identity-assertion). +`M_RESOURCE_LIMIT_EXCEEDED` +The request cannot be completed because the homeserver has reached a +resource limit imposed on it. For example, a homeserver held in a shared +hosting environment may reach a resource limit if it starts using too +much memory or disk space. The error MUST have an `admin_contact` field +to provide the user receiving the error a place to reach out to. +Typically, this error will appear on routes which attempt to modify +state (e.g.: sending messages, account data, etc) and not routes which +only read state (e.g.: [`/sync`](#get_matrixclientv3sync), +[`/user/{userId}/account_data/{type}`](#get_matrixclientv3useruseridaccount_datatype), etc). + `M_UNKNOWN` An unknown error has occurred. @@ -221,17 +232,6 @@ The request or entity was too large. The resource being requested is reserved by an application service, or the application service making the request has not created the resource. -`M_RESOURCE_LIMIT_EXCEEDED` -The request cannot be completed because the homeserver has reached a -resource limit imposed on it. For example, a homeserver held in a shared -hosting environment may reach a resource limit if it starts using too -much memory or disk space. The error MUST have an `admin_contact` field -to provide the user receiving the error a place to reach out to. -Typically, this error will appear on routes which attempt to modify -state (e.g.: sending messages, account data, etc) and not routes which -only read state (e.g.: [`/sync`](#get_matrixclientv3sync), -[`/user/{userId}/account_data/{type}`](#get_matrixclientv3useruseridaccount_datatype), etc). - `M_CANNOT_LEAVE_SERVER_NOTICE_ROOM` The user is unable to reject an invite to join the server notices room. See the [Server Notices](#server-notices) module for more information.