v1

latestOpenAPI 3.1.0Apache 2.02026-07-264001921002.3 KB

OAuth

Get per-user OAuth flow detail

Returns the pending OAuth flow row metadata: which MCP client is being authorized, which identity (user / VK / session) the resulting token will be bound to, and whether an active token already exists for that binding (has_active_token).

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

get/api/oauth/per-user/flows/{id}

Path parameters

idstring required

Flow row ID

Response

Flow detail

idstring required

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

status'pending' | 'authorized' | 'failed' | 'expired' required

oauth_config_idstring required

user_idstring nullable

session_idstring nullable

expires_atstring date-time required

created_atstring date-time required

has_active_tokenboolean 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.