Themes
A theme is a CSS file stored under a random ID. Anyone with the ID can load it from the Media Proxy without signing in. There is no route to change or delete a theme.
Create theme
Section titled “Create theme”POST/v1/users/@me/themesStores a CSS file and returns its ID. Bots and OAuth2 tokens can't use this route.
JSON body
Section titled “JSON body”| Field | Type | Description |
|---|---|---|
| css | string | The CSS text (1 character to 8 MiB as UTF-8) |
Response body
Section titled “Response body”| Field | Type | Description |
|---|---|---|
| id | string | The theme ID (16 lowercase hexadecimal characters) |
Response
Section titled “Response”| Status | Body | Condition |
|---|---|---|
| 201 | response body | The theme was stored |
| 400 | error response | FILE_SIZE_TOO_LARGE when the CSS is over 8 MiB |
| 403 | error response | ACCESS_DENIED when the caller is a bot or uses an OAuth2 bearer token |
| 403 | error response | CONTENT_BLOCKED when the CSS has a blocked phrase or URL |
The rate limit is 20 requests per minute, on the theme:share:create bucket.