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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.getbifrost.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your provider API key or Bifrost authentication token. Virtual keys (prefixed with sk-bf-) can also be passed here.

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

Minimal user view embedded on user-keyed session rows.

​
virtual_key
object

Minimal virtual-key view embedded in session rows.

​
session_id
string | null