Skip to content

emoji_delete

Remove a custom emoji and its image file from the server.

{
"cmd": "emoji_delete",
"emoji_id": "4"
}
Field Type Required Description
emoji_id string or integer Yes The emoji’s ID, such as "4" or 4. Must be digits only.
{
"cmd": "emoji_delete",
"id": "4",
"deleted": true
}

deleted is false when no emoji has that ID. This is not an error.

The server doesn’t broadcast the deletion. Messages and reactions that use the emoji keep their text, but its image URL returns 404.

Requires manage_emojis. A user in timeout gets a rate_limit frame instead.

val When
Invalid emoji_delete data: emoji_id must be an integer emoji_id is missing or isn’t a non-negative whole number.
Custom asset storage is unavailable The emoji index file can’t be read.
Failed to save custom asset The updated index couldn’t be written.