API Tokens

Create a new named API token

Changed on

Generates a new API token with the given name. The raw token value is returned only in this response and cannot be retrieved again. Store it securely. Use as Authorization: Bearer qat_... for API access.

post/tokens/{email}/

Request

  • Base URL
    https://quads.example.com/api/v3
  • URL
    https://quads.example.com/api/v3/tokens/{email}/
  • Auth
    HTTP bearer

Path parameters

emailstring required

User email

Request body

namestring required

Example request

{
  "name": "CI pipeline"
}

Response

Token created. The token field contains the raw value (shown only once).

idinteger
namestring
token_prefixstring

First 12 characters of the token for identification

created_atstring
last_usedstring nullable
tokenstring

Raw token value (shown only once)

Example response

{
  "id": 1,
  "name": "CI pipeline",
  "token_prefix": "qat_Ab3xKm9p",
  "created_at": "Tue, 19 May 2026 12:00:00 GMT",
  "token": "qat_Ab3xKm9pQ7..."
}

Changes