Skip to main content
POST
Create an identity token

Authorizations

Authorization
string
header
required

A personal access token (POST /v1/auth/tokens) or a machine identity token (POST /v1/projects/{project_id}/identities/{identity_id}/tokens), both prefixed qumo_pat_. A token's scopes cap what it can do; see Scopes and permissions. A personal token names no organization: on a route whose path names no project or organization, pass ?organization_id=.

Path Parameters

project_id
string<uuid>
required

The project's id.

identity_id
string<uuid>
required

The identity's id.

Body

application/json
scopes
enum<string>[]
required

The scopes that cap what the token can do. At least one.

Minimum array length: 1

A token scope. * asks for every scope. See Scopes and permissions.

Available options:
*,
project:read,
usage:read,
audit:read,
audit:admin,
iam:read,
iam:admin,
organization:admin,
billing:admin,
signing_keys:admin
Example:
expires_at
string<date-time> | null

When the token expires. Omit or null for a token that does not expire.

Example:

"2027-01-01T00:00:00Z"

Response

The created token, including its value.

A newly created identity token, including its value.

id
string<uuid>
required
Example:

"7d9f1b3e-5a7c-4e9b-b1d3-f5a7c9e1b3d5"

created_at
string<date-time>
required
Example:

"2026-10-14T09:15:02Z"

expires_at
string<date-time> | null
required

When the token expires; null if it does not.

Example:

"2027-01-01T00:00:00Z"

scopes
enum<string>[]
required

A token scope. * asks for every scope. See Scopes and permissions.

Available options:
*,
project:read,
usage:read,
audit:read,
audit:admin,
iam:read,
iam:admin,
organization:admin,
billing:admin,
signing_keys:admin
Example:
value
string
required

The token. Returned only when it is created; send it as Authorization Bearer.

Example:

"qumo_pat_4f9a1c7e2b8d6035e1a9c4f7b2d8e6a1c3f5b7d9e0a2c4f6b8d0e2a4c6f8b1d3"