Passa al contenuto principale

Emojis

Actions in the category "Emojis".

Create server emoji​

Upload a new custom emoji to a server.

Required permissions: Manage expressions.

Inputs

NameTypeRequiredDetails
NameTextYesThe emoji name (1-32 chars, letters/numbers/underscore only). Length: 1 to 32 characters. Must match ^[a-zA-Z0-9_]+$.
Image URLURLYesURL of the image (PNG, JPG, GIF; max 256KB).
Allowed rolesList of RoleNoRestrict emoji use to these roles.
Audit log reasonTextNoReason shown in the audit log. Maximum length: 512 characters.

Outputs

NameTypeDetails
EmojiServer emojiThe created emoji.

Rename server emoji​

Change the name of an existing custom emoji.

Required permissions: Manage expressions.

Inputs

NameTypeRequiredDetails
EmojiServer emojiYesThe emoji to rename.
New nameTextYesThe new emoji name (1-32 chars, letters/numbers/underscore only). Length: 1 to 32 characters. Must match ^[a-zA-Z0-9_]+$.
Audit log reasonTextNoReason shown in the audit log. Maximum length: 512 characters.

Outputs

NameTypeDetails
EmojiServer emojiThe updated emoji.

Set emoji role restrictions​

Update which roles are allowed to use a custom emoji.

Required permissions: Manage expressions.

Inputs

NameTypeRequiredDetails
EmojiServer emojiYesThe emoji to update.
Allowed rolesList of RoleYesRoles that may use the emoji (empty = all members).
Audit log reasonTextNoReason shown in the audit log. Maximum length: 512 characters.

Outputs

NameTypeDetails
EmojiServer emojiThe updated emoji.

Delete server emoji​

Permanently delete a custom emoji from a server.

Required permissions: Manage expressions.

Inputs

NameTypeRequiredDetails
EmojiServer emojiYesThe emoji to delete.
Audit log reasonTextNoReason shown in the audit log. Maximum length: 512 characters.

Outputs

NameTypeDetails
EmojiServer emojiThe deleted emoji.

Fetch server emojis​

List all custom emojis in a server.

Outputs

NameTypeDetails
EmojisList of Server emojiAll custom emojis in the server.

Fetch server emoji by ID​

Look up a single custom emoji by its ID.

Inputs

NameTypeRequiredDetails
Emoji IDDiscord IDYesThe Discord ID of the emoji.

Outputs

NameTypeDetails
EmojiServer emojiThe emoji, or empty if not found. May be empty.

Fetch application emojis​

List the emojis owned by the bot's application.

Outputs

NameTypeDetails
EmojisList of Server emojiThe application's emojis.

Fetch application emoji by ID​

Fetches a single application emoji by its Discord ID.

Inputs

NameTypeRequiredDetails
IDDiscord IDYesThe ID of the application emoji to fetch.

Outputs

NameTypeDetails
EmojiApplication emojiThe application emoji, or empty if not found. May be empty.

Create application emoji​

Creates a new application-owned emoji from an image URL.

Inputs

NameTypeRequiredDetails
NameTextYesName of the emoji (1-32 chars, alphanumeric and underscore). Length: 1 to 32 characters. Must match ^[a-zA-Z0-9_]+$.
ImageURLYesURL of the image to use for the emoji.

Outputs

NameTypeDetails
EmojiApplication emojiThe newly created application emoji.

Rename application emoji​

Renames an existing application emoji.

Inputs

NameTypeRequiredDetails
EmojiApplication emojiYesThe application emoji to rename.
New NameTextYesThe new name for the emoji.

Outputs

NameTypeDetails
EmojiApplication emojiThe renamed application emoji.

Delete application emoji​

Permanently deletes an application emoji.

Inputs

NameTypeRequiredDetails
EmojiApplication emojiYesThe application emoji to delete.

Fetch emoji from mention​

Reads a Discord emoji mention ("<:name:id>" or "<a:name:id>") and resolves it to a server emoji.

Inputs

NameTypeRequiredDetails
MentionTextYesEmoji mention in the format <:name:id> or <a:name:id>. Must match ^<a?:[a-zA-Z0-9_]+:[0-9]+>$.

Outputs

NameTypeDetails
EmojiServer emojiThe resolved emoji, or empty. May be empty.
Need more help?
Can't find what you're looking for? Our team is happy to help.