POST
/admin.emoji.renameRename a custom emoji
Renames a custom emoji in an Enterprise Grid organization. Provide the current emoji name and the replacement value in new_name.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
Form data identifying the emoji and its replacement name. token, name, and new_name are required.
tokenstringrequired
Authentication token. Requires scope: `admin.teams:write`
namestringrequired
The name of the emoji to be renamed. Colons (`:myemoji:`) around the value are not required, although they may be included.
new_namestringrequired
The new name of the emoji.
200Returns an object containing `ok: true` when the custom emoji is renamed.
okbooleanrequired
defaultReturns an object containing `ok: false` when the custom emoji cannot be renamed.
okbooleanrequired
Error handling
token, name, and new_name are required. The token must have the admin.teams:write scope, and name may include surrounding colons.