Skip to main content
POST
Attach canonical knowledge to an Agent

Authorizations

Authorization
string
header
required

A Contact Button scoped bearer key. Send Authorization: Bearer <token>. Token abilities are enforced independently of workspace membership; both checks must pass. Interactive MCP clients use registered OAuth applications, Authorization Code + PKCE, audience-bound tokens, and explicit workspace grants. Personal Sanctum tokens remain supported.

Path Parameters

workspace
string<uuid>
required
agent
string<uuid>
required

Body

application/json
source_type
enum<string>
required

Attach a complete FAQ/knowledge list, one canonical article, one synced source, or the complete Articles library.

Available options:
menu,
article,
knowledge_source,
docs
source_id
string
required

Canonical public UUID, or all when source_type is docs.

Maximum string length: 80

Response

Successful data envelope.

data
any
required
meta
object
required