Create new API token
POST /api-tokens
Authorizations
Section titled “Authorizations ”Request Body
Section titled “Request Body ”object
ID of the team this token will provide access to
Human-readable name for the token (1-255 characters)
Permission level for the token: ‘admin’, ‘member’, or ‘readonly’
Optional expiration date (ISO 8601). If null or not set, token never expires
Responses
Section titled “ Responses ”API token created successfully
object
The plaintext API token. IMPORTANT: This is the only time the token is shown. Store it securely immediately.
Metadata about the created token
object
Unique identifier for the API token (nanoid format)
ID of the team this token provides access to
Human-readable name for identifying this token
Prefix of the token for identification (e.g., ‘cat_tok_’)
Last 4 characters of the token for verification
Permission level: ‘admin’ (full access), ‘member’ (standard access), ‘readonly’ (read-only access)
ID of the user who created this token
When the token expires (ISO 8601), or null if no expiration
When the token was last used for an API request (ISO 8601)
Whether the token is active and can be used for authentication
When the token was created (ISO 8601)
When the token was last modified (ISO 8601)
Bad Request - Validation error or invalid input
object
Unauthorized - Authentication required or invalid token
object
Forbidden - Insufficient permissions
object
Not Found - Resource does not exist