Skip to content

Create a new API token scoped to this organization

POST
/api/v2/organizations/{organization}/tokens

Authorizations

Parameters

Path Parameters

organization
required
string

Organization identifier

Example
test-org

Request Body required

object
name
required

Name for the token

string
My deploy token

Responses

201

Token created. The plain token is returned once and cannot be retrieved again.

object
token

The plain text token (shown once)

string
name
string
created_at
string format: date-time

400

Bad request.

object
message
required

Error message

string
The requested resource was not found
error
required

Error flag

boolean
true
{
"message": "The requested resource was not found",
"error": true
}

403

Access is forbidden.

object
message
required

Error message

string
The requested resource was not found
error
required

Error flag

boolean
true
{
"message": "The requested resource was not found",
"error": true
}