Error

A valid request URL is required to generate request examples

{
  "status": "pending_oauth",
  "message": "<string>",
  "oauth_config_id": "<string>",
  "authorize_url": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "mcp_client_id": "<string>",
  "complete_url": "<string>",
  "status_url": "<string>",
  "next_steps": [
    "<string>"
  ]
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

MCP

Reauthorize an MCP client

Redoes the OAuth consent flow for an already-authorized OAuth-based MCP client, without delete-and-recreate. The flow always runs against the credentials currently stored on the client’s OAuth config.

auth_type “oauth”: serves both a standalone admin-triggered reauth (e.g. the upstream provider revoked the credential and the client sits in needs_reauth) and the follow-up to rotating oauth_config via PUT /api/mcp/client/ (which cascades every bound token to needs_reauth).
auth_type “per_user_oauth”: repairs the retained admin discovery credential used for periodic tool-list refresh. Only allowed while that credential actually sits in needs_reauth (409 otherwise); end-user credentials are untouched either way.

Complete the returned flow like any other admin OAuth flow: open authorize_url in a browser, poll status_url until “authorized”, then POST complete_url.

POST

/

api

/

mcp

/

client

/

{id}

/

reauthorize

Error

A valid request URL is required to generate request examples

{
  "status": "pending_oauth",
  "message": "<string>",
  "oauth_config_id": "<string>",
  "authorize_url": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "mcp_client_id": "<string>",
  "complete_url": "<string>",
  "status_url": "<string>",
  "next_steps": [
    "<string>"
  ]
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

{
  "event_id": "<string>",
  "type": "<string>",
  "is_bifrost_error": true,
  "status_code": 123,
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "event_id": "<string>"
  },
  "extra_fields": {
    "model_requested": "<string>",
    "request_type": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

id

string

required

MCP client ID

Response

Reauthorization flow initiated

Response when initiating an OAuth flow

status

enum<string>

Available options:

pending_oauth

message

string

oauth_config_id

string

ID of the OAuth config created for this flow

authorize_url

string

URL to redirect the user to for authorization

expires_at

string<date-time>

When the OAuth authorization request expires

mcp_client_id

string

The MCP client ID that initiated this OAuth flow

complete_url

string

Relative URL to POST once the flow is authorized (/api/mcp/client/{oauth_config_id}/complete-oauth). Note the path parameter is the oauth_config_id, not the MCP client ID.

status_url

string

Relative URL to poll for the flow status (/api/oauth/config/{oauth_config_id}/status). Wait for status "authorized" before calling complete_url.

next_steps

string[]

Human-readable steps to complete the flow (authorize, poll, complete)

⌘I