zulip/templates/zerver/api/upload-custom-emoji.md

{generate_api_title(/realm/emoji/{emoji_name}:post)}

{generate_api_description(/realm/emoji/{emoji_name}:post)}

Usage examples

{start_tabs}

{tab|python}

{generate_code_example(python)|/realm/emoji/{emoji_name}:post|example}

{generate_code_example(javascript)|/realm/emoji/{emoji_name}:post|example}

{tab|curl}

{generate_code_example(curl)|/realm/emoji/{emoji_name}:post|example}

{end_tabs}

Parameters

As described above, the image file to upload must be provided in the request's body.

Emoji name

The emoji name can only contain letters, numbers, dashes, and spaces. Upper and lower case letters are treated the same, and underscores (_) are treated the same as spaces (consistent with how the Zulip UI handles emoji).

Maximum file size

The maximum file size for uploads can be configured by the administrator of the Zulip server by setting MAX_EMOJI_FILE_SIZE_MIB in the server's settings. MAX_EMOJI_FILE_SIZE_MIB defaults to 5MB.

Response

Example response

{generate_code_example|/realm/emoji/{emoji_name}:post|fixture(200)}

{generate_code_example|/realm/emoji/{emoji_name}:post|fixture(400)}