Skip to content

Provision a short-lived (or non-expiring) agent token

POST
/api/v1/auth/tokens/provision-agent
curl --request POST \
--url https://api.pkgplease.com/api/v1/auth/tokens/provision-agent \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "ttl_seconds": 3600, "never_expires": true, "label": "example", "metadata": {} }'
Media typeapplication/json
object
ttl_seconds
number
default: 3600 <= 86400
never_expires
boolean
label
string
metadata
object

Agent token issued (prefix pkgpls_agt_)

Media typeapplication/json
object
token
string
Examplegenerated
{
"token": "example"
}

Invalid ttl_seconds or no resolvable user identity

Media typeapplication/json
object
error
required
string
Examplegenerated
{
"error": "example"
}

Caller token type not permitted to provision

Media typeapplication/json
object
error
required
string
Examplegenerated
{
"error": "example"
}