Emoji Resource

Routes for controlling emojis do not follow the normal rate limit conventions. These routes are specifically limited on a per-guild basis to prevent abuse. This means that the quota returned by our APIs may be inaccurate, and you may encounter 429s.

Emoji Object

Emoji Structure
FieldTypeDescription
idsnowflakeemoji id
namestringemoji name
rolesarray of role object idsroles this emoji is whitelisted to
user?user objectuser that created this emoji
require_colonsboolwhether this emoji must be wrapped in colons
managedboolwhether this emoji is managed

List Guild Emojis

GET/guilds/{guild.id}/emojis
Returns a list of emoji objects for the given guild.

Get Guild Emoji

GET/guilds/{guild.id}/emojis/{emoji.id}
Returns an emoji object for the given guild and emoji IDs.

Create Guild Emoji

POST/guilds/{guild.id}/emojis
Create a new emoji for the guild. Returns the new emoji object on success. Fires a Guild Emojis Update Gateway event.
Passing the roles field will be ignored unless the application is whitelisted as an emoji provider. For more information and to request whitelisting please contact [email protected]
JSON Params
FieldTypeDescription
namestringname of the emoji
imagebase64 image datathe 128x128 emoji image
rolesarray of snowflakesroles for which this emoji will be whitelisted

Modify Guild Emoji

PATCH/guilds/{guild.id}/emojis/{emoji.id}
Modify the given emoji. Returns the updated emoji object on success. Fires a Guild Emojis Update Gateway event.
Passing the roles field will be ignored unless the application is whitelisted as an emoji provider. For more information and to request whitelisting please contact [email protected]
JSON Params
FieldTypeDescription
namestringname of the emoji
rolesarray of snowflakesroles to which this emoji will be whitelisted

Delete Guild Emoji

DELETE/guilds/{guild.id}/emojis/{emoji.id}
Delete the given emoji. Returns 204 No Content on success. Fires a Guild Emojis Update Gateway event.