Skip to main content
POST
Submit an MCP OAuth callback URL

Authorizations

X-Session-API-Key
string
header
required

Path Parameters

job_id
string
required

Body

application/json

Callback URL copied from a browser OAuth redirect.

callback_url
string
required
Minimum string length: 1

Response

Successful Response

Current state of an install-time OAuth MCP probe.

job_id
string
required
ok
boolean
required
status
enum<string>
required
Available options:
pending,
authorizing,
succeeded,
failed
authorization_url
string | null
callback_ready
boolean
default:false
error
string | null
error_kind
enum<string> | null
Available options:
timeout,
connection,
unknown
oauth_state
MCPOAuthStateResponse · object | null
tool_result
MCPToolCallResult · object | null

Verbatim outcome of the requested tool_call.

The endpoint stays provider-neutral: many servers report upstream failures (e.g. Slack's {"ok": false, "error": "invalid_auth"}) as ordinary text content with isError unset, so interpreting the payload is the caller's job.

tools
string[] | null