Media

Upload content to an `mxc://` URI that was created earlier.

This endpoint permits uploading content to an mxc:// URI that was created earlier via POST /_matrix/media/v1/create.

put/_matrix/media/v3/upload/{serverName}/{mediaId}

Request

Path parameters

serverNamestring mx-server-name required

The server name from the mxc:// URI returned by POST /_matrix/media/v1/create (the authority component).

mediaIdstring required

The media ID from the mxc:// URI returned by POST /_matrix/media/v1/create (the path component).

Query parameters

filenamestring

The name of the file being uploaded

Headers

Content-Typestring

Optional. The content type of the file being uploaded.

Clients SHOULD always supply this header.

Defaults to application/octet-stream if it is not set.

Request body application/octet-stream

string required

The content to be uploaded.

Example request

"<bytes>"

Response

The upload was successful.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.