Sign in

v51

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-01245104440.0 KB
Users

Issue user authentication token

Issue a new authentication token for the user. The clear-text token value is returned only in this response and cannot be retrieved afterwards. A user may issue tokens for themselves; issuing tokens for another user requires MANAGE_USERS access right.

post/v1/users/{user-id}/tokens

Path parameters

user-idinteger required

User ID

Request body

validForinteger required

Validity period in seconds from now. Must be a positive value.

persistentboolean

True to issue a persistent (database-backed) token, false for an ephemeral one.

descriptionstring

Optional human-readable token description.

Response

Token issued successfully

idinteger

Token ID (0 for ephemeral tokens).

userIdinteger

ID of the user the token was issued for.

persistentboolean

True if the token is persisted in the database (long-lived API token).

serviceboolean

True if this is a service token.

descriptionstring

Human-readable token description.

issuingTimeinteger

Token issuing time (UNIX timestamp, seconds).

expirationTimeinteger

Token expiration time (UNIX timestamp, seconds).

valuestring

Clear-text token value. Present only in the response to the create operation; never returned when listing tokens.