Skip to main content
GET
Get an agent-scoped 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"

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"

Response

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