Download a thumbnail of content from the content repository
NOTE: Replaced by GET /_matrix/client/v1/media/thumbnail/{serverName}/{mediaId} (requires authentication).
Download a thumbnail of content from the content repository. See the Thumbnails section for more information.
WARNING: [Changed in v1.11] This endpoint MAY return 404 M_NOT_FOUND for media which exists, but is after the server froze unauthenticated media access. See Client Behaviour for more information.
Request
- Base URLhttps://matrix.org
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
The server name from the mxc:// URI (the authority component).
The media ID from the mxc:// URI (the path component).
Query parameters
The desired width of the thumbnail. The actual thumbnail may be larger than the size specified.
The desired height of the thumbnail. The actual thumbnail may be larger than the size specified.
The desired resizing method. See the Thumbnails section for more information.
Indicates to the server that it should not attempt to fetch the media if it is deemed remote. This is to prevent routing loops where the server contacts itself.
Defaults to true if not provided.
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.
Indicates to the server that it may return a 307 or 308 redirect response that points at the relevant media content. When not explicitly set to true the server must return the media content itself.
Indicates preference for an animated thumbnail from the server, if possible. Animated thumbnails typically use the content types image/gif, image/png (with APNG format), image/apng, and image/webp instead of the common static image/png or image/jpeg content types.
When true, the server SHOULD return an animated thumbnail if possible and supported. When false, the server MUST NOT return an animated thumbnail. For example, returning a static image/png or image/jpeg thumbnail. When not provided, the server SHOULD NOT return an animated thumbnail.
Servers SHOULD prefer to return image/webp thumbnails when supporting animation.
When true and the media cannot be animated, such as in the case of a JPEG or PDF, the server SHOULD behave as though animated is false.
Response
A thumbnail of the requested content.
Changes
No recorded changes to this operation across all 1 revision of this API.