Skip to navigation
AgentFS APIAgent Filesystem

Users Access Token Mint

Preview
View as Markdown

Mints a short-lived, non-refreshable token for an active managed user created by this app. Requires confidential app credentials and pilot admission. Creator user/team IDs are provenance, including after transfer. Every requested scope must be supported and available to the app.

Required scope: private:agent_filesystem.users.manage OR private:agent_filesystem.tenant.users.manage

Endpoint format: RPC

Authentication: App

This endpoint does not support apps with the app folder permission.

Authentication

AuthorizationBearer

App-level OAuth 2.0 token (no user context). Use Authorization: Bearer <token>.

Obtain by calling the token endpoint with grant_type=client_credentials.

Only available on endpoints that declare app auth support.

OR
AuthorizationBearer

App-level OAuth 2.0 token (no user context). Use Authorization: Bearer <token>.

Obtain by calling the token endpoint with grant_type=client_credentials.

Only available on endpoints that declare app auth support.

Request

This endpoint expects an object.
scopeslist of stringsRequired

OAuth scopes for the token. Every scope must be available to the Provider app and supported for managed-user issuance.

userobjectRequired
Active managed user owned by the authenticated Provider app.
Variant:
agent_filesystem.UserSelector.user_public_idobjectRequired
Selects the user by its public user ID for this Provider app.

Response headers

X-Dropbox-Request-IdstringOptional
A unique identifier for the request, useful for debugging and support.

Response

Successful response
access_tokenstring1-8192 characters

User access token with the requested OAuth scopes. The token can call supported Dropbox file APIs and Agent Filesystem management routes. It cannot be refreshed or used with Dropbox-API-Select-User.

expires_inuint1-4294967295
Number of seconds until the access token expires.

Errors

401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error