Expressions¶

An expression is a custom emoji or a sticker. Guild-owned expressions are managed on Guild emojis and Guild stickers. This page covers the routes that read an expression without membership of its guild, the lists of every expression the caller can use, and expression packs.

All routes are relative to https://tebhos.com/api/v1 and require authentication. Routes marked user-only refuse a valid bot token with 403 ACCESS_DENIED; the others also accept bot tokens. Error bodies follow Errors.

Expression IDs are snowflake strings. Every route that takes an emoji_id or sticker_id also accepts the legacy UUID form described in Emoji IDs. An unknown ID returns 404 NOT_FOUND.

Emoji metadata object¶

A custom emoji as seen from outside its guild.

{
  "id": "1501314428688998182",
  "legacy_id": "b4497791-c19c-4b6b-9a2f-df4bc155a9f7",
  "guild_id": "1489002177550843904",
  "name": "party_parrot",
  "animated": true,
  "allow_cloning": true
}

Sticker metadata object¶

A sticker as seen from outside its guild.

Get emoji metadata¶

GET /emojis/{emoji_id}/metadata

Returns the emoji metadata object of any guild emoji. No membership of the owning guild and no permission is required.

Rate limit: guild:emoji:metadata, 60 per 10 seconds per client.

curl https://tebhos.com/api/v1/emojis/1501314428688998182/metadata \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN"

Get sticker metadata¶

GET /stickers/{sticker_id}/metadata

Returns the sticker metadata object of any guild sticker. No membership of the owning guild and no permission is required.

Rate limit: guild:sticker:metadata, 60 per 10 seconds per client.

Get sticker¶

GET /stickers/{sticker_id}

Returns one sticker for display, for example when a message shows a sticker from a guild the reader is not in. No membership is required. Unlike the other routes, the fields are camelCase:

List my guild emojis¶

GET /users/@me/guild-emojis

Returns every custom emoji of every guild the caller is a member of, as {"items": [...]}. Clients use it to build an emoji picker. Each item has id, legacy_id, guild_id, guild_name, name, image_url and animated. Guilds are grouped in order of guild name.

Sending an emoji from another guild in a guild channel, in a message or as a new reaction, requires both USE_EXTERNAL_EMOJIS in that guild and TEBHOS Pro; otherwise the request fails with 403 FORBIDDEN. Direct messages have no such check.

List my guild stickers¶

GET /users/@me/guild-stickers

Returns every sticker of every guild the caller is a member of, as {"items": [...]}. Each item has id, legacy_id, guild_id, guild_name, name, description and image_url.

Sending a sticker from another guild in a guild channel requires both USE_EXTERNAL_STICKERS in that guild and TEBHOS Pro; otherwise the request fails with 403 FORBIDDEN. A message can carry at most 3 stickers.

Expression packs¶

An expression pack is a personal collection of emojis (an emoji pack) or stickers (a sticker pack) owned by one account rather than a guild. Packs are a TEBHOS Pro feature: an account can create and install packs only while it has TEBHOS Pro.

Every pack route is user-only and has no route rate limit.

Pack limits¶

Reaching a limit returns 400 BAD_REQUEST.

Pack summary object¶

{
  "id": "1502001122334455667",
  "name": "Workshop reactions",
  "description": null,
  "type": "emoji",
  "creator_id": "1489002177550843905",
  "created_at": "2026-09-14T09:12:44+00:00",
  "updated_at": "2026-09-14T09:12:44+00:00"
}

List my packs¶

GET /packs

Returns the caller's created and installed packs, grouped by type:

{
  "emoji": {"installed_limit": 50, "created_limit": 50, "installed": [], "created": []},
  "sticker": {"installed_limit": 50, "created_limit": 50, "installed": [], "created": []}
}

Each list holds pack summary objects. The limits are 0 for an account without TEBHOS Pro.

Create pack¶

POST /packs/{pack_type}

Creates an empty pack and returns its pack summary object. {pack_type} is emoji or sticker; any other value returns 400 BAD_REQUEST.

Modify pack¶

PATCH /packs/{pack_id}

Renames a pack and returns its pack summary object. Only the creator can change a pack (403 FORBIDDEN otherwise).

Delete pack¶

DELETE /packs/{pack_id}

Deletes a pack. Only the creator can delete it. Returns 204.

Pack items¶

The creator manages a pack's items with these routes. The pack must be of the matching type, otherwise the request fails with 400 BAD_REQUEST; a pack owned by someone else returns 403 FORBIDDEN.

For pack items, image must be a data: URL (for example data:image/png;base64,...); raw base64 is refused. The declared media type decides the format, and a GIF, an animated PNG or an animated WebP is marked animated. The item routes return the created or updated item without user.

The delete routes accept the query parameter purge=true, which also deletes the stored image file.

Pack invites¶

GET /packs/{pack_id}/invites lists the pack's invite codes and POST /packs/{pack_id}/invites creates one. Only the creator can use them.

A pack can have at most 1000 invites. Each pack invite object has code, type (2 for an emoji pack, 3 for a sticker pack), pack (the pack summary plus creator), inviter, expires_at, temporary, created_at, uses and max_uses.

Install pack¶

POST /packs/{pack_id}/install

Adds a pack to the caller's installed packs and returns 204. Any existing pack can be installed. Installing needs TEBHOS Pro and counts toward the installed limit for the pack's type.

DELETE /packs/{pack_id}/install removes an installed pack and returns 204.