Create an access token

POST

/api/tokens

curl --request POST \
  --url https://api-dev.wrktr.com/api/tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "expiresInDays": "Infinity" }'

Only from a signed-in web session (a token can’t create tokens): the CLI’s wrktr token create opens the browser for this. The token is returned once.

Authorizations

• bearer

Request Body^required

Media typeapplication/json

object

name

required

string

>= 1 characters <= 100 characters

expiresInDays

Any of:

unknown

Any of:

number

number

string

string

Allowed values: Infinity -Infinity NaN

null

null

Responses

200

NewToken

Media typeapplication/json

object

token

required

string

info

required

object

id

required

string

name

required

string

prefix

required

string

createdAt

required

Any of:

number

number

string

string

Allowed values: Infinity -Infinity NaN

lastUsedAt

required

Any of:

unknown

Any of:

number

number

string

string

Allowed values: Infinity -Infinity NaN

null

null

expiresAt

required

Any of:

unknown

Any of:

number

number

string

string

Allowed values: Infinity -Infinity NaN

null

null

Example

{
  "info": {
    "createdAt": "Infinity",
    "lastUsedAt": "Infinity",
    "expiresAt": "Infinity"
  }
}

401

Unauthorized

Media typeapplication/json

object

_tag

required

string

Allowed values: Unauthorized

message

required

string

Example

{
  "_tag": "Unauthorized"
}

403

Forbidden

Media typeapplication/json

object

_tag

required

string

Allowed values: Forbidden

message

required

string

Example

{
  "_tag": "Forbidden"
}