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.

Headers

X-Naive-Project-Id
string<uuid>

Act inside this project. The header form of the /v1/projects/{project_id}/... prefix, for clients that cannot rewrite their base path. Lower precedence than the path, higher than the key's pinned project; omitted resolves to the organization's default project.

Path Parameters

user_id
string
required

Tenant user id, or default for the caller`s own.

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