Skip to content

CustomEmojiRequest

A request of a holder of create_custom_emojis for a new local custom emoji, or for a new image of one they made, which a holder of manage_custom_emojis approves or rejects. A request is not an emoji: no picker, post, reaction, or other server shows its image until it is approved.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
kind
required

What a custom emoji request asks for: create a new local custom emoji, or image a new image of a local emoji that the requester made.

string
Allowed values: create image
state
required

The state of a custom emoji request: pending until an administrator decides it, then approved or rejected; withdrawn by the requester before that; or lapsed, a request for a new image of an emoji that was deleted.

string
Allowed values: pending approved rejected withdrawn lapsed
shortcode
required

The shortcode of the new emoji, without the colons around it, or of the emoji whose image the request replaces.

string
emoji_id

The emoji of an image request, and the emoji that an approved create request made; absent otherwise.

string format: uuid
url

The URL of the requested image, animated when it is; absent once it cannot be shown (the upload of a request that ended goes with the unattached uploads).

string format: uri
static_url

The URL of a still image of the requested image; absent with url.

string format: uri
reason

The reason of a rejection that the administrator gave; absent for none.

string
created_at
required

When the request was made.

string format: date-time
decided_at

When the request was approved, rejected, withdrawn, or lapsed; absent while it is pending.

string format: date-time

Example generated

{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"kind": "create",
"state": "pending",
"shortcode": "example",
"emoji_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"url": "https://example.com",
"static_url": "https://example.com",
"reason": "example",
"created_at": "2026-04-15T12:00:00Z",
"decided_at": "2026-04-15T12:00:00Z"
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site