v1

latestOpenAPI 3.1.0Apache 2.02026-07-264001921002.3 KB

MCP

Get per-user-headers submission flow

Returns the pending submission flow row plus the live MCP client's schema (required header names + optional admin header names). Used by the /workspace/mcp-sessions/auth?flow=<id>&kind=headers landing page to render the values form.

Requires management API authentication via Authorization: Bearer <API key>.

get/api/mcp/per-user-headers/flows/{id}

Path parameters

idstring required

Flow row ID

Response

Flow detail

idstring required

flow_mode'user' | 'vk' | 'session' required

status'pending' | 'completed' | 'expired' required

user_idstring nullable

session_idstring nullable

expires_atstring date-time required

created_atstring date-time required

required_header_keysstring[] required

Header names the end-user must supply on this submission

admin_header_keysstring[]

Names (not values) of static admin headers attached to every per-user request. Surfaced so the user understands what context will accompany their values.

submitted_keysstring[]

Names of header keys already on the caller's existing credential. Populated whenever a credential exists for the binding (both active and needs_update states — orphaned credentials are filtered server-side). Values are never returned. has_active_credential only flips to true when the credential is in active state.

has_active_credentialboolean required

True when a credential already exists for the flow's (mode, identity, mcp_client) triple. The submission UI uses this to render an "edit" affordance instead of a fresh form.