API ReferenceMCP

Delete an MCP server instance and associated connected accounts

Markdown
DELETE
/api/v3/mcp/servers/{serverId}/instances/{instanceId}

Removes a user instance from the MCP server and deletes all connected accounts for that user that are associated with the auth configurations of this specific MCP server. Connected accounts for other auth configurations are not affected.

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Path Parameters

serverId*string

The ID of the MCP server

instanceId*string

The instance ID (user ID) to delete

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://backend.composio.dev/api/v3/mcp/servers/550e8400-e29b-41d4-a716-446655440000/instances/user_123456"
{
  "message": "string",
  "deleted_connected_accounts": 0
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}