peskybird
API reference › Your account

Check your token

GEThttps://peskybird.app/api/push/token
Auth App token

Checks a token without sending anything: its name, the topics it may send to and its account.

Checks a token without sending: its name, the topics it may send to and its account.

Response 200

The token.

  • idstringRequired

    ULID: 26 Crockford base32 characters, lexically sortable. Message ids double as the sync cursor.

  • namestringRequired

    App token name, 1 to 64 chars.

    at most 64 characters
  • suffixstringRequired

    Last 4 characters of the token, for display only.

    at most 4 characters
  • topicScopestring[]

    Topic names this token may send to. Absent means every topic.

    at most 64 items
  • createdAtdate-timeRequired

    RFC 3339 / ISO 8601 timestamp with offset; UTC recommended.

  • accountobject

    The account the token sends for, on multi-tenant servers.

    Fields (2)
    • idstringRequired

      Account id; part of the routing hash on multi-tenant servers.

    • namestringRequired

      Account display name, shown in the app. The account owner may rename it.

      at most 128 characters

Errors

401unauthorized: The Authorization header is missing, or the token is not valid or has been revoked.
403forbidden: The token may not send to this topic, or the account does not allow what was asked. details.reason says which: topic_limit, images_not_enabled or account_suspended.
429rate_limited: The account reached its daily limit, or the token sent too fast.

Every error uses the same envelope. Error format and codes