Connectors

Check Connector Usage

Reports whether a catalog entry is already in use in your organization.

An entry is considered "in use" when at least one MCP server in your organization was created from it:

Built-in connectors are matched by their connector_id.
Registry MCPs are matched by comparing the registry entry's remote endpoint against the URL each installed MCP server points at.

When the id exists in both catalogs (or you don't know which it is), omit source and both strategies run. The response includes the matching MCP servers so you can see exactly where the entry is configured.

get/api/connectors/{connector_id}/usage

Request

Base URL: https://app.withwillow.ai
URL: https://app.withwillow.ai/api/connectors/{connector_id}/usage
Auth: HTTP bearer

Path parameters

connector_idstring required

The catalog entry id (for example slack), as returned by List Connectors.

Query parameters

source'connector' | 'registry'

Restrict matching to a built-in connector or a registry entry. When omitted, both are checked.

Response

Connector usage retrieved successfully

Example response

{
  "data": {
    "connector_id": "slack",
    "source": "connector",
    "in_use": true,
    "count": 2,
    "mcp_servers": [
      {
        "id": "6f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
        "slug": "slack",
        "name": "Slack",
        "status": "active"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.