Create agent bootstrap token

Issue a short-lived, single-use sponsor token for agent bootstrap under the current organization.

post/v1/agent/bootstrap_tokens

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/agent/bootstrap_tokens
  • Auth: HTTP bearer

Request body

labelstring nullable

Optional label carried into the issued agent API key.

scopesstring[]

Optional requested scopes; self-serve sponsor tokens are limited to read:sec.

ttlSecondsinteger

Optional lifetime in seconds. The service clamps the effective value to 60 through 86,400 seconds.

Response

Sponsor token issued. The secret is returned once.

object'agent_bootstrap_token' required
idstring required
orgIdstring required
actorPrincipalIdstring required
labelstring nullable required
tokenPrefixstring required
scopesstring[] required
livemodeboolean required
expiresAtstring date-time required
usedAtstring date-time nullable required
usedByPrincipalIdstring nullable required
createdAtstring date-time required
updatedAtstring date-time required
secretstring required

One-time sponsor-token secret. Store only long enough to send it to the bootstrap agent.

requestIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.