oauth

create OAuth account

post/w/{workspace}/oauth/create_account

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/w/{workspace}/oauth/create_account
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

workspacestring required

Request body

refresh_tokenstring required

OAuth refresh token. For authorization_code flow, this contains the actual refresh token. For client_credentials flow, this must be set to an empty string.

expires_ininteger required
clientstring required
grant_typestring
cc_client_idstring

OAuth client ID for resource-level credentials (client_credentials flow only)

cc_client_secretstring

OAuth client secret for resource-level credentials (client_credentials flow only)

cc_instancestring

Instance name for built-in providers whose client-credentials token URL is instance-templated; substituted into the fixed-host registry template server-side (client_credentials flow only). The token URL is never caller-supplied.

cc_token_urlstring

Bring-your-own token endpoint override (client_credentials flow only). Only honored together with cc_client_id/cc_client_secret and mutually exclusive with cc_instance; ignored/rejected on the shared-instance path.

mcp_server_urlstring

MCP server URL for MCP OAuth token refresh

scopesstring[]

OAuth scopes to use for token refresh. Overrides instance-level scopes.

Response

account set

Changes

No recorded changes to this operation across all 298 revisions of this API.