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
id?snowflakeemoji id
namestringemoji name
roles?array of role object idsroles this emoji is whitelisted to
user?user objectuser that created this emoji
require_colons?boolwhether this emoji must be wrapped in colons
managed?boolwhether this emoji is managed
animated?boolwhether this emoji is animated
Emoji Example
{
  "id": "41771983429993937",
  "name": "LUL",
  "roles": [ "41771983429993000", "41771983429993111" ],
  "user": {
    "username": "Luigi",
    "discriminator": "0002",
    "id": "96008815106887111",
    "avatar": "5500909a3274e1812beb4e8de6631111"
  },
  "require_colons": true,
  "managed": false,
  "animated": false
}
Gateway Reaction Standard Emoji Example
{
  "id": null,
  "name": "🔥"
}
Gateway Reaction Custom Emoji Example
{
  "id": "41771983429993937",
  "name": "LUL"
}

List Guild Emojis

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

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. Requires the 'MANAGE_EMOJIS' permission. Returns the new emoji object on success. Fires a Guild Emojis Update Gateway event.
Emojis and animated emojis have a maximum file size of 256kb. Attempting to upload an emoji larger than this limit will fail and return 400 Bad Request and an error message, but not a JSON status code.
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. Requires the 'MANAGE_EMOJIS' permission. Returns the updated emoji object on success. Fires a Guild Emojis Update Gateway event.
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. Requires the 'MANAGE_EMOJIS' permission. Returns 204 No Content on success. Fires a Guild Emojis Update Gateway event.