Connector

A connector: one endpoint, described once (its URL, request and response, and the kind of credential it needs). Agents never call a connector directly: a tool points at it. Each change adds a new version, and a tool keeps calling the exact version it was built against.

Kind: one of several shapes, used in responses.

Shapes

The $type field says which shape it is, and comes first.

$type	Shape
"mcp"	McpConnector
"openapi"	OpenApiConnector

Example

{
  "$type": "mcp",
  "versions": [
    {}
  ],
  "name": "...",
  "namespaceId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "dateCreated": "2026-10-26T12:00:00.0000000Z",
  "dateUpdated": "2026-10-26T12:00:00.0000000Z"
}

Where it’s used

• connectors.disableVersion (POST /connectors/by-id/{id}/versions/{version}/disable)
• connectors.enableVersion (POST /connectors/by-id/{id}/versions/{version}/enable)
• connectors.getByName (GET /namespaces/{namespaceName}/connectors/by-name/{name})
• connectors.get (GET /connectors/by-id/{id})
• connectors.list (GET /connectors)
• connectors.list (GET /namespaces/{namespaceName}/connectors)