Skip to content

Create API token

PUT
/api/v1/api-token
curl --request PUT \
--url https://example.com/api/v1/api-token \
--header 'Content-Type: application/json' \
--data '{ "name": "example", "expiration": "2026-04-15T12:00:00Z", "user": "example" }'

Creates a new API token

expand
string
Media type application/json
object
name
required

Token name

string
>= 1 characters
expiration

Optional expiration date (must be in future)

string format: date-time
user
required

User ID (15 chars)

string
Example generated
{
"name": "example",
"expiration": "2026-04-15T12:00:00Z",
"user": "example"
}

Created

Media type application/json
object
id
required

Token ID (15 chars)

string
name
required

Token name

string
user
required

User ID that owns this token

string
expiration

Optional expiration date

string format: date-time
created
string format: date-time
updated
string format: date-time
Example generated
{
"id": "example",
"name": "example",
"user": "example",
"expiration": "2026-04-15T12:00:00Z",
"created": "2026-04-15T12:00:00Z",
"updated": "2026-04-15T12:00:00Z"
}

Bad Request

Internal Server Error