Media

Download content from the content repository.

NOTE: Clients SHOULD NOT generate or use URLs which supply the access token in the query string. These URLs may be copied by users verbatim and provided in a chat message to another user, disclosing the sender's access token.

Clients MAY be redirected using the 307/308 responses below to download the request object. This is typical when the homeserver uses a Content Delivery Network (CDN).

get/_matrix/client/v1/media/download/{serverName}/{mediaId}

Request

Base URL
https://matrix.org
Auth
- API key in query parameter access_token
- or HTTP bearer
TypeScript
https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/v1/media/download/:serverName/:mediaId/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

serverNamestring mx-server-name required

The server name from the mxc:// URI (the authority component).

mediaIdstring required

The media ID from the mxc:// URI (the path component).

Query parameters

timeout_msinteger

The maximum number of milliseconds that the client is willing to wait to start receiving data, in the case that the content has not yet been uploaded. The default value is 20000 (20 seconds). The content repository SHOULD impose a maximum value for this parameter. The content repository MAY respond before the timeout.

Response

The content that was previously uploaded.

Changes

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