Get a connector's organization connection
/v1/mcp-integrations/{slug}/org-connectionGet a connector's organization connection.
For an OAUTH_AUTO connector: the upstream account an organization admin connected, which agents on an MCP key use. Returns connected: false when there is none. Tokens are never returned.
Requires read access to the connector: for a workspace-owned connector, an organization admin key or a key of that workspace; for an organization-level connector, any organization member. Returns 404 when the connector does not exist in the organization.
Authorization
AuthorizationBearer va_A platform API key (
va_...), created under Settings > API keys. Scoped to an organization or one workspace, with an admin or member role. Used by the management API.
Path parameters
slugstringrequiredThe connector's slug (
mcpi-...).
Query parameters
organizationstringrequiredThe organization's identifier (slug).
Responses
connectedbooleanWhether there is an organization connection.
statusstringACTIVE, orEXPIRED(a token refresh failed: an organization admin must connect again).connected_bystringThe user ID of the admin who connected it.
connected_by_emailstringThat admin's email, for display.
scopestringThe OAuth scope the upstream granted.
connected_atstring<date-time>When it was connected (ISO 8601).
expires_atstring<date-time>When the current access token expires (ISO 8601); the gateway refreshes it.