Upload a custom emoji

This endpoint is used to upload a custom emoji for use in the user's organization. Access to this endpoint depends on the organization's configuration.

POST https://studyscience.wyzepal.com/api/v1/realm/emoji/{emoji_name}

Usage examples

#!/usr/bin/env python3

import wyzepal

# Pass the path to your wyzepalrc file here.
client = wyzepal.Client(config_file="~/wyzepalrc")

# Upload a custom emoji; assume `emoji_path` is the path to your image.
with open(emoji_path, 'rb') as fp:
    emoji_name = 'my_custom_emoji'
    result = client.call_endpoint(

curl -X POST https://studyscience.wyzepal.com/api/v1/realm/emoji/{emoji_name} \
    -F "data=@/path/to/img.png" \


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 WyzePal UI handles emoji).

Maximum file size

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


Example response

A typical successful JSON response may look like:

    "msg": "",
    "result": "success"