Skip to content
Snippets Groups Projects
admin.md 19.02 KiB

Media repository administration

All the API calls here require your user ID to be listed in the configuration as an administrator. After that, your access token for your homeserver will grant you access to these APIs. The URLs should be hit against a configured homeserver. For example, if you have t2bot.io configured as a homeserver, then the admin API can be used at https://t2bot.io/_matrix/media/unstable/admin/....

Media attributes

Media in the media repo can have attributes associated with it.

Currently the only attribute is a purpose, which defines how the media repo is to treat the media. By default this is set to none, meaning the media repo will not treat it as special in any way. Setting the purpose to pinned will prevent the media from being quarantined, but not purged.

Get media attributes

URL: GET /_matrix/media/unstable/admin/media/<server>/<media id>/attributes?access_token=your_access_token

The response will be the current attributes for the media.

Set media attributes

URL: POST /_matrix/media/unstable/admin/media/<server>/<media id>/attributes/set?access_token=your_access_token