agents

Create Agent Binding

Bind an agent to a context (owner/admin only, purely subtractive).

post/api/v1/agents/{agent_id}/bindings

Request

  • Base URL: https://memory.kagura-ai.com (the document declares no server; this is the origin it was published from)
  • URL: https://memory.kagura-ai.com/api/v1/agents/{agent_id}/bindings
  • Auth: none declared

Path parameters

agent_idstring uuid required

Headers

authorizationstring nullable

Request body

context_idstring uuid required
can_readboolean
write_policy'deny' | 'direct'
is_defaultboolean

Bootstrap default binding (max one per agent)

allowed_memory_typesstring[] nullable

Per-memory type filter (#1299): null = all types, [] = deny-all, else the memory types this binding may read (enforce-mode only). Applies to the memory-read lanes; enumeration/aggregate surfaces still use the context-level gate until #1301

allowed_source_typesstring[] nullable

Per-memory source filter (#1299): null = all sources, [] = deny-all, else values from the memories.source_type set. Applies to the memory-read lanes; enumeration/aggregate surfaces still use the context-level gate until #1301

Response

Successful Response

idunknown required
agent_idunknown required
context_idunknown required
can_readunknown required
write_policyunknown required
is_defaultunknown required
allowed_memory_typesunknown
allowed_source_typesunknown
created_byunknown required
created_atunknown required
updated_atunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.