Emoji Resource

Emoji Object

Emoji Structure
FieldTypeDescription
id?snowflakeemoji id
name?string (can be null only in reaction emoji objects)emoji name
roles?array of role object idsroles allowed to use this emoji
user?user objectuser that created this emoji
require_colons?booleanwhether this emoji must be wrapped in colons
managed?booleanwhether this emoji is managed
animated?booleanwhether this emoji is animated
available?booleanwhether this emoji can be used, may be false due to loss of Server Boosts
Emoji Example
json
{
  "id": "41771983429993937",
  "name": "LUL",
  "roles": ["41771983429993000", "41771983429993111"],
  "user": {
    "username": "Luigi",
    "discriminator": "0002",
    "id": "96008815106887111",
    "avatar": "5500909a3274e1812beb4e8de6631111",
    "public_flags": 131328
  },
  "require_colons": true,
  "managed": false,
  "animated": false
}
Gateway Reaction Standard Emoji Example
json
{
  "id": null,
  "name": "🔥"
}
Gateway Reaction Custom Emoji Examples
json
{
  "id": "41771983429993937",
  "name": "LUL",
  "animated": true
}
json
{
  "id": "41771983429993937",
  "name": null
}

Endpoints

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
X-Audit-Log-Reason

Create a new emoji for the guild. Requires the MANAGE_EMOJIS_AND_STICKERS permission. Returns the new emoji object on success. Fires a Guild Emojis Update Gateway event.

JSON Params
FieldTypeDescription
namestringname of the emoji
imageimage datathe 128x128 emoji image
rolesarray of snowflakesroles allowed to use this emoji

Modify Guild Emoji

PATCH/guilds/{guild.id}/emojis/{emoji.id}
X-Audit-Log-Reason

Modify the given emoji. Requires the MANAGE_EMOJIS_AND_STICKERS permission. Returns the updated emoji object on success. Fires a Guild Emojis Update Gateway event.

JSON Params
FieldTypeDescription
namestringname of the emoji
roles?array of snowflakesroles allowed to use this emoji

Delete Guild Emoji

DELETE/guilds/{guild.id}/emojis/{emoji.id}
X-Audit-Log-Reason

Delete the given emoji. Requires the MANAGE_EMOJIS_AND_STICKERS permission. Returns 204 No Content on success. Fires a Guild Emojis Update Gateway event.