Clarify that the async upload endpoint will return 404 in some cases (#1983)

This commit is contained in:
Benjamin Bouvier 2024-11-06 12:28:47 +01:00 committed by GitHub
parent e0bd054373
commit 6cd7038d01
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 20 additions and 0 deletions

View file

@ -0,0 +1 @@
Clarify that the async upload endpoint will return 404 in some cases.

View file

@ -126,6 +126,25 @@ paths:
"errcode": "M_FORBIDDEN", "errcode": "M_FORBIDDEN",
"error": "Cannot upload this content" "error": "Cannot upload this content"
} }
"404":
description: |-
The user has provided an invalid MXC ID. Some reasons for this error include:
- The MXC ID was not created with [POST /_matrix/media/v1/create](/client-server-api/#post_matrixmediav1create).
- The MXC ID has expired.
A [standard error response](/client-server-api/#standard-error-response)
will be returned with the `errcode` `M_NOT_FOUND`.
content:
application/json:
schema:
$ref: definitions/errors/error.yaml
examples:
response:
value: {
"errcode": "M_NOT_FOUND",
"error": "Unknown media ID"
}
"409": "409":
description: |- description: |-
The endpoint was called with a media ID that already has content. A The endpoint was called with a media ID that already has content. A