Create an access token

Creates a new API token. The secret is returned once in this response and cannot be retrieved again — store it securely.

Creates a token and returns its secret once.

POST/auth/tokens

Authorizationstringheaderrequired

Bearer token — `Bearer dxb_live_…`.

namestringbodyrequired

A descriptive name for the token.

scopesarraybodyrequired

The scopes to grant, e.g. `["read","write"]`.

projectsarraybody

Restrict the token to specific project slugs.

Response

201Token created

$_cURL

curl --request POST \
  --url https://api.doxbrix.io/v1/auth/tokens \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "scopes": [],
  "projects": []
}'

{ "id": "tok_01J8", "name": "ci-publisher", "scopes": ["write","publish"], "token": "dxb_live_xxxxxxxx" }