Skip to main content
GET
Oauth Preflight

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace
string
required

Slug of the workspace the request acts in

Maximum string length: 120
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Query Parameters

instance_id
string<uuid> | null

MCP instance to inspect

server_id
string<uuid> | null

Catalog MCP spec to inspect before any instance exists

catalog_item_id
string<uuid> | null

Catalog API to inspect before connecting it

Response

Successful Response

What the UI needs before it can offer Connect.

ready — Connect runs unattended, with the client credential_source names: the operator's platform app, or one registered dynamic-ally. oauth_app_required — ask for a client ID/secret first. unsupported — this cannot be authorized with OAuth; detail says why.

connected
boolean
required
redirect_uri
string
required
status
enum<string>
required
Available options:
ready,
oauth_app_required,
unsupported
authorization_endpoint
string | null
credential_source
enum<string> | null
Available options:
platform,
dynamic
detail
string
default:""
issuer
string | null
scopes
string[]
Last modified on October 12, 2026