v33

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-26273770.9 KB

Mint a short-lived scoped token whose scopes limit what the holder can do, e.g. install a specific asset on a device through the registry. The token is verified offline by services holding the token signing public key and cannot be revoked, so keep TTLs short. It is bound to the authenticated caller's organization.

post/v1/scoped_tokens

Request body

scopesstring[] required

Scopes in the form <resource>:<id|*>:<action>, e.g. device:*:install, asset:asset_01h455vb4pex5vsknk084sn02q:read or applerelay:*:connect. Resource IDs are the customer-visible IDs returned by the API.

ttlSecondsinteger

How long the token stays valid. Defaults to 3600 (1 hour), maximum is 14400 (4 hours).

Response

OK

tokenstring required

The scoped token, to be sent as a Bearer token or the token query parameter.

scopesstring[] required
expiresAtstring date-time required