Skip to navigation

Create an app token; tenant grants coming soon

Pre-release
View as Markdown

Authenticate with the Agent Filesystem app key and secret. The grant type determines the returned credential:

  • client_credentials returns a short-lived app access token.
  • Coming soon: authorization_code exchanges the single-use code returned by tenants/create for a tenant access token and an offline refresh token.
  • Coming soon: refresh_token refreshes the tenant access token.

Agent runtime tokens are minted at agents/access_token/mint. Managed-user tokens are minted at users/access_token/mint using HTTP Basic authentication with the app key and secret.

Request

This endpoint expects an object.
grant_typeenumRequired
Allowed values:
codestringOptional

Required for authorization_code.

refresh_tokenstringOptional

Required for refresh_token.

Response

Issued access token
access_tokenstring
token_typeenum
Allowed values:
expires_ininteger>=1
refresh_tokenstringOptional

Coming soon: returned only when the tenant authorization code is exchanged.

scopestringOptional