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

pull/1709/merge
Benjamin Bouvier 3 weeks ago committed by GitHub
parent e0bd054373
commit 6cd7038d01
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

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

@ -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

Loading…
Cancel
Save