v9

latestOpenAPI 3.1.02026-08-08435208464.3 KB
mcp-integrations

Disconnect Integration

Disconnect ONE MCP connection and remove its stored credentials.

Deliberately does not check is_provider_enabled_for_org/the org's rollout flag: revoking an existing grant must never be trapped behind a flag that got turned off or removed after connecting -- so the ungated provider lookup is used purely to read the ownership axis.

Authorization:

  • org-shared provider: org admin, as before. target_user_id is meaningless there and is rejected rather than silently ignored.
  • user-scoped provider: a member disconnects their own connection with no admin gate; disconnecting ANOTHER member's connection (offboarding) is an explicit admin action that must name target_user_id.
post/api/mcp-integrations/{provider_key}/disconnect

Path parameters

provider_keystring required

Query parameters

target_user_idstring nullable

Response

Successful Response

successboolean required
messagestring required