Create a token

Create a new service account token for API authentication

POST

/auth/v1/seed/auth/tokens

curl --request POST \
  --url /auth/v1/seed/auth/tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"ci-deploy","scopes":["read","write"],"expires_in_seconds":7776000}'

Body parameters

name

string

required

A display name for the token. Used to identify the token in the dashboard and API responses.

scopes

string[]

required

Permissions granted to the token. One or more of `"read"`, `"write"`, `"admin"`.

expires_in_seconds

integer

Number of seconds until the token expires. Omit to create a token that never expires.

[Warning] The raw token value is only returned once at creation time. It cannot be retrieved again. Store it securely — if lost, you must delete the token and create a new one.

Previous → Set retention policy

Next List tokens →