Skip to content

Commit f087767

Browse files
committed
Clarify that the async upload endpoint will return 404 in some cases
1 parent 285cd2b commit f087767

File tree

2 files changed

+20
-0
lines changed

2 files changed

+20
-0
lines changed
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Clarify that the async upload endpoint will return 404 in some cases.

data/api/client-server/content-repo.yaml

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,25 @@ paths:
126126
"errcode": "M_FORBIDDEN",
127127
"error": "Cannot upload this content"
128128
}
129+
"404":
130+
description: |-
131+
The user has provided an invalid MXC ID. Some reasons for this error include:
132+
133+
- The MXC ID was not created with [POST /_matrix/media/v1/create](/client-server-api/#post_matrixmediav1create).
134+
- The MXC ID has expired.
135+
136+
A [standard error response](/client-server-api/#standard-error-response)
137+
will be returned with the `errcode` `M_NOT_FOUND`.
138+
content:
139+
application/json:
140+
schema:
141+
$ref: definitions/errors/error.yaml
142+
examples:
143+
response:
144+
value: {
145+
"errcode": "M_NOT_FOUND",
146+
"error": "Unknown media ID"
147+
}
129148
"409":
130149
description: |-
131150
The endpoint was called with a media ID that already has content. A

0 commit comments

Comments
 (0)