AGagentarea
v1
protected
oauth-connect

Oauth Preflight

Changed on

Report whether a connection can be authorized, and with what.

Every outcome is a 200: "this server has no OAuth" is an answer the UI renders, not a failure it has to decode.

get/v1/workspaces/{workspace}/oauth/preflight

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

workspacestring required

Slug of the workspace the request acts in

Query parameters

instance_idstring uuid nullable

MCP instance to inspect

server_idstring uuid nullable

Catalog MCP spec to inspect before any instance exists

catalog_item_idstring uuid nullable

Catalog API to inspect before connecting it

Response

Successful Response

authorization_endpointstring nullable
connectedboolean required
credential_source'platform' | 'dynamic' nullable
detailstring
issuerstring nullable
redirect_uristring required
scopesstring[]
status'ready' | 'oauth_app_required' | 'unsupported' required

Changes