Associate a knowledge base with an agent
Associates an existing workspace document with an agent, triggering
indexing into the agent’s knowledge base in the background. Poll GET
/api/v1/agents//documents until the new document’s status
is ready (or error). Associating a document already associated with
this agent is a no-op (already_associated), not an error or a
duplicate. Rejected with a 402 if it would exceed the tenant’s
cumulative knowledge-base size limit for its plan tier.
Authorizations
A long-lived, privileged API key (ek_... prefix), minted once from the dashboard. Intended for trusted server-side use only; never expose it in client-side code. Send as Authorization: Bearer ek_.... Required by every Calls, Batches, Agents, Tools, MCP Servers, Documents, and Realtime route.