Manage connectors

Learn how to list, attach, update, and remove connectors using the connector sub-resource endpoints.

This guide shows you how to manage connectors attached to an agent using the connector sub-resource endpoints. You will learn about the full connector CRUD lifecycle and JSON Merge Patch semantics.

Prerequisites

• An existing agent (see Create an agent)
• Understanding of connectors and the five connector types

Two ways to manage connectors

You can manage connectors in two ways:

1. Via the agent’s connectors array: When you PATCH an agent, the connectors array is replaced wholesale. This is good for bulk changes.
2. Via the connector sub-resource: Attach, update, remove, or list individual connectors without rewriting the full agent. This is good for incremental changes.

This guide focuses on the sub-resource approach.

List connectors

# Replace these with your values
AGENT_ID="<your-agent-id>"
ENVIRONMENT="<eu-or-us>"
TENANT="<your-tenant-name>"
TOKEN="<your-access-token>"

curl "https://api.${ENVIRONMENT}.corti.app/v2/agentic/agents/${AGENT_ID}/connectors" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}"

The response is a JSON object with a connectors array, each discriminated by type:

{
  "connectors": [
    {"type": "registry", "id": "con.0192f4c8-...", "name": "coding-expert"},
    {"type": "mcp", "id": "con.0192f4c8-...", "name": "policybot", "url": "https://mcp.example.com"}
  ]
}

Attach a connector

curl -X POST "https://api.${ENVIRONMENT}.corti.app/v2/agentic/agents/${AGENT_ID}/connectors" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "registry",
    "name": "coding-expert",
    "config": {"codingSystem": "icd-10"}
  }'

Each connector type has different required fields. See Connectors for the full schema of each type.

Attach an MCP connector

curl -X POST "https://api.${ENVIRONMENT}.corti.app/v2/agentic/agents/${AGENT_ID}/connectors" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "mcp",
    "name": "policybot",
    "url": "https://mcp.example.com",
    "auth": {"type": "bearer"}
  }'

Attach a schema connector

curl -X POST "https://api.${ENVIRONMENT}.corti.app/v2/agentic/agents/${AGENT_ID}/connectors" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schema",
    "name": "submit_code",
    "description": "Submit the final ICD-10 code.",
    "transition": "complete",
    "schema": {
      "type": "object",
      "properties": {"code": {"type": "string"}},
      "required": ["code"]
    }
  }'

Get a connector

CONNECTOR_ID="<your-connector-id>"

curl "https://api.${ENVIRONMENT}.corti.app/v2/agentic/agents/${AGENT_ID}/connectors/${CONNECTOR_ID}" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}"

Update a connector

The connector PATCH endpoint is in private preview and returns HTTP 501. To change a connector, remove it and attach a new one.

Use JSON Merge Patch to update a connector. The type field is immutable:

curl -X PATCH "https://api.${ENVIRONMENT}.corti.app/v2/agentic/agents/${AGENT_ID}/connectors/${CONNECTOR_ID}" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{
    "enabled": false,
    "name": "policybot-v2",
    "url": "https://mcp.example.com/v2"
  }'

Field	Patch behavior
enabled	Omit to keep; set to toggle
name	Omit to keep; null has no effect (name is required)
url	Omit to keep; null clears it
config	Omit to keep; null clears it
auth	Omit to keep; null clears it

Remove a connector

curl -X DELETE "https://api.${ENVIRONMENT}.corti.app/v2/agentic/agents/${AGENT_ID}/connectors/${CONNECTOR_ID}" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}"

Next steps

• Read about connector auth for outbound connectors
• Browse registry connectors for pre-built options
• Learn about the connectors concept for the full type reference