Skip to content
API referenceGet a connector's organization connection

Get a connector's organization connection

GET/v1/mcp-integrations/{slug}/org-connection

Get 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

  • slugstringrequired

    The connector's slug (mcpi-...).

Query parameters

  • organizationstringrequired

    The organization's identifier (slug).

Responses

200application/json
  • connectedboolean

    Whether there is an organization connection.

  • statusstring

    ACTIVE, or EXPIRED (a token refresh failed: an organization admin must connect again).

  • connected_bystring

    The user ID of the admin who connected it.

  • connected_by_emailstring

    That admin's email, for display.

  • scopestring

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

NVIDIA Inception Program member

VectorAxis is built by GK Labs, a member of NVIDIA Inception.