Skip to main content
POST
Attach a connector

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"

Body

application/json

The connector to attach to the agent.

Same envelope as Connector but without the server-generated id.

type
any
required

Connector discriminator; always registry.

name
string
required

Registry connector name.

Example:

"@dedalus/coding-expert"

enabled
boolean
default:true

Whether the connector is active for invocations.

config
object

Connector-specific configuration validated against the registry schema. Not yet persisted — the server currently drops config for registry connectors on create.

Response

The attached 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.