Skip to main content
GET
/
api
/
oauth
/
per-user
/
flows
/
{id}
Error
A valid request URL is required to generate request examples
{
  "id": "<string>",
  "mcp_client": {
    "client_id": "<string>",
    "name": "<string>"
  },
  "oauth_config_id": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "has_active_token": true,
  "user_id": "<string>",
  "user": {
    "id": "<string>",
    "name": "<string>"
  },
  "virtual_key": {
    "id": "<string>",
    "name": "<string>"
  },
  "session_id": "<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

Flow row ID

Response

Flow detail

Response for GET /api/oauth/per-user/flows/{id}. Mirrors the headers-side MCPHeadersFlowDetail — identity binding for display plus the bits the consent UI needs to decide its copy.

​
id
string
required
​
flow_mode
enum<string>
required
Available options:
user,
vk,
session
​
status
enum<string>
required
Available options:
pending,
authorized,
failed,
expired
​
mcp_client
object
required

Minimal MCP client view embedded in session rows.

​
oauth_config_id
string
required
​
expires_at
string<date-time>
required
​
created_at
string<date-time>
required
​
has_active_token
boolean
required

True when an active token already exists for the flow's binding. A pending flow with this set means OAuth was re-initiated unnecessarily; the consent page can render this as "already authenticated" instead of prompting again.

​
user_id
string | null
​
user
object | null

Minimal user view embedded on user-keyed session rows.

​
virtual_key
object | null

Minimal virtual-key view embedded in session rows.

​
session_id
string | null