Skip to main content
POST
Connect an agent to a knowledge base

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Body

application/json
agent_id
string<uuid>
required

An agents.id UUID.

knowledge_base_id
string<uuid>
required

Response

The connection. 200 rather than 201: the binding is a property of the agent.

agent_id
string
agent_name
string
agent_role
string
tenant_user_id
string | null
knowledge_base_id
string
knowledge_base_name
string | null

null when the connected knowledge base has since been deleted; the dangling binding is reported rather than hidden.

connected_at
string<date-time> | null