api-tokens

Create a personal access token

Issues a new personal access token for the authenticated user. The token value appears exactly once, in this response — store it before discarding the response, because it cannot be retrieved again.

post/api/v1/me/api-tokens

Request

  • Base URL: https://api.izap.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.izap.ai/api/v1/me/api-tokens
  • Auth: HTTP bearer

Request body

namestring required

Human-readable label for the token.

expires_in_daysinteger nullable

Days until the token expires. Null for a non-expiring token.

scopesstring[] nullable

Optional permission scopes (Permission enum values). Omitted or empty means full access within the credential's normal permissions.

Response

Successful Response

idstring uuid required
namestring required
token_prefixstring required

Non-secret leading chars, e.g. 'izap_pat_AbC'.

last_fourstring nullable

Last four chars of the token, for recognition.

scopesstring[] nullable

Permission scopes. Null means full access within the credential's normal permissions.

expires_atstring date-time nullable required
revokedboolean required
last_used_atstring date-time nullable required
createdstring date-time required
tokenstring required

The plaintext token. Store it now; it cannot be retrieved again.

Changes

No recorded changes to this operation across all 1 revision of this API.