emojis_modify
emojis_modify
Section titled “emojis_modify”Category: emojis
Update a guild emoji’s name and/or role restrictions.
When to use
Section titled “When to use”- Rename an emoji; restrict to a role tier.
When NOT to use
Section titled “When NOT to use”- Replacing the image — Discord does not allow editing emoji bytes; create a new one and delete the old.
| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Guild owning the emoji |
emoji_id | string | yes | Emoji to modify |
name | string | no | New name (2-32 chars) |
roles | array | no | Replacement role list (empty array = everyone) |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{id, name, animated, roles\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
id | unknown | yes | |
name | unknown | yes | |
animated | boolean | yes | |
roles | array | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | no |