Get one connected account
Returns one connected account. An unknown id, or one belonging to another organization, is reported as a 404.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.
1Path Parameters
Integration connection id (UUID) as returned by managedAgentsListIntegrationConnections.
Response
An organization's link to a third-party account, created by installing an integration such as the GitHub App. It holds no secret itself; grant it to an agent so sessions can mint short-lived provider credentials from it.
An organization's link to a third-party account, created by installing an integration such as the GitHub App. It holds no secret itself; grant it to an agent so sessions can mint short-lived provider credentials from it.
Identifier for this connection (UUID). Server-assigned. Cite it when granting an agent access to the integration.
RFC 3339 timestamp of when this record was created. Server-assigned.
The provider's own identifier for the link, which token minting addresses. The installation id for GitHub; the composite {api_app_id}:{team_id} for Slack; the customer service-account email for Google Cloud.
Organization that owns this record. Resolved from the API key; never accepted from the caller.
Stable slug of the third-party integration adapter this connection uses.
Lifecycle of the connection: pending was registered directly and waits for the customer to grant trust at the provider (a successful probe activates it), active can mint tokens, suspended is restorable at the provider and resolves to no credential, revoked was uninstalled and must be installed again.
RFC 3339 timestamp of the last change to this record. Server-assigned.
Name of the connected third-party account, e.g. the GitHub org or user login. Cached at install time for display, so no provider call is needed to show it.
Kind of account that was connected, as the provider reports it, e.g. Organization or User for GitHub and workspace for Slack.
User who completed the install, recorded for audit.
Native GitHub or Slack MCP tools selected for this organization. Existing connections default to every supported tool.
Operator-assigned label distinguishing multiple accounts for one built-in vendor.
What the provider granted the install, as permission name to access level (e.g. contents: write). Used to narrow a minted token without a provider round trip and to explain why a permission preset is unavailable.
Whether the install covers all of the account's resources or only chosen ones: all or selected. Informational only; the authoritative list stays at the provider.
Runtime usage counts, supplied on the connection list.