Capability Sources

Prepare removing an organization connection

Changed on

Prepares removing one organization connection (connector) from OpenWork and returns a link where the person confirms it. Nothing is removed by this call: the connection, who can use it, its stored accounts and OAuth app are deleted only when the person opens the link and confirms in OpenWork. It never deletes anything in the connected service. Only when the user explicitly asks to remove a connection: first list connections with getMcpConnections and pick the one whose name matches; if several could match, ask the user which one and do not guess. Send its exact name as expectedName. A connection that plugins need is refused unless detachFromPlugins is true, which you may send only after telling the user which plugins use it and they agree. Needs the Remove any connection permission, or having added the connection. Give the person handoff.url and handoff.instructions; afterwards, list connections with getMcpConnections to confirm it is gone.

post/v1/mcp-connections/{connectionId}/removal-request

Request

  • Base URL: https://api.openworklabs.com
  • URL: https://api.openworklabs.com/v1/mcp-connections/{connectionId}/removal-request
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

connectionIdstring typeid required

Den TypeID with 'emc_' prefix and a 26-character base32 suffix.

Request body

expectedNamestring required

The connection's exact name, as getMcpConnections lists it. Nothing is prepared when it does not match.

detachFromPluginsboolean

The user agreed it may be removed from plugins that need it. Send true only after telling the user which plugins use it.

Response

The removal is ready for the person to confirm in OpenWork.

status'confirmation_required' required

Changes