Sign in
Custom emojis

List custom emojis

get/v1/custom_emojis

Query parameters

start_cursorstring

If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.

page_sizeinteger

The number of items from the full list desired in the response. Maximum: 100

namestring

If supplied, filters custom emojis by exact name match. Useful for resolving a custom emoji name to its ID.

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Response

object'list' required

Always list

type'custom_emoji' required

Always custom_emoji

has_moreboolean required

Whether there are more results available.

next_cursorstring uuid required

Changes

Changed in 5 of the 17 revisions of this API.181

  • c90a4587bc951See the full diff
    • ●

      added the new idempotency_key_reused enum value to the allOf[subschema #2]/code response property for the response status 409

      response-property-enum-value-added

  • ae20477af71b11See the full diff
    • ▲

      added subschema #1 subschema #2 subschema #3 to the response body oneOf list for the response status 403

      response-body-one-of-added

    • ○

      removed publicApiCommonErrorResponse subschema #2 from the response body allOf list for the response status 403

      response-body-all-of-removed

  • 28d140865fc62See the full diff
    • ●

      added the new agent_credit_limit_reached enum value to the allOf[subschema #2]/code response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new workspace_credits_exhausted enum value to the allOf[subschema #2]/code response property for the response status 403

      response-property-enum-value-added

  • 301eea0116d92See the full diff
    • ●

      added the new invalid_beta enum value to the allOf[subschema #2]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new invalid_credit_limit enum value to the allOf[subschema #2]/code response property for the response status 400

      response-property-enum-value-added

  • 681ee94f046c3See the full diff
    • ●

      added the new agent_deleted enum value to the allOf[subschema #2]/code response property for the response status 409

      response-property-enum-value-added

    • ●

      added the new directory_not_found enum value to the allOf[subschema #2]/code response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new status_change_not_allowed enum value to the allOf[subschema #2]/code response property for the response status 403

      response-property-enum-value-added