Skip to main content
PATCH
Update an agent-scoped connector (partial)

Authorizations

Authorization
string
header
required

OAuth 2.0 / OIDC bearer token.

Tenant-Name
string
header
required

The tenant the request operates within.

Path Parameters

agentId
string<agent-id>
required

Agent identifier (prefixed UUIDv7). Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"

agentConnectorId
string<connector-id>
required

Agent-scoped connector identifier (prefixed UUIDv7). Connector identifier. Accepts con.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(con\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"con.0192f4c8-7baf-7083-a46f-81d2bd70cf95"

Body

application/merge-patch+json

The connector fields to change, as a JSON Merge Patch (RFC 7386).

Merge-patch of a single connector. type is immutable.

enabled
boolean

Whether the connector is active.

Example:

false

name
string

New connector name.

Example:

"policybot-v2"

url
string<uri> | null

New connector URL; null clears it.

Example:

"https://mcp.example.com/v2"

config
object | null

New connector config; null clears it.

Example:
auth
object | null

Authentication configuration for an outbound connector.

Example:

Response

The updated connector.

A connector attached to an agent, discriminated by type.

id
string<connector-id>
required
read-only

Server-generated connector identifier (prefixed UUIDv7). Stable across PATCH replacements where the underlying spec is unchanged. Used by observability/HITL to reference a connector unambiguously.

Pattern: ^(con\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"con.0192f4c8-7baf-7083-a46f-81d2bd70cf95"

type
enum<string>
required

Connector discriminator; always registry.

Available options:
registry,
mcp,
agent,
a2a,
schema
Allowed value: "registry"
name
string
required

Registry connector name.

Example:

"@dedalus/coding-expert"

enabled
boolean
default:true

Whether the connector is active for invocations. Only schema connectors return this field today; mcp, registry, agent, and a2a connectors omit it (treat as enabled).

config
object

Connector-specific configuration validated against the registry schema.