agents

Update Agent

Partially update an agent, including status / enforcement transitions.

patch/api/v1/agents/{agent_id}

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}
  • Auth: none declared

Path parameters

agent_idstring uuid required

Headers

authorizationstring nullable

Request body

namestring nullable
descriptionstring nullable
frameworkstring nullable
environmentstring nullable
versionstring nullable
status'active' | 'suspended' | 'retired' nullable

Lifecycle kill switch (fail-closed for bound keys, P0-2)

enforcement_mode'shadow' | 'enforce' nullable

Binding enforcement ramp; enforce→shadow is audited as widening

Response

Successful Response

idunknown required
workspace_idunknown required
nameunknown required
descriptionunknown
owner_user_idunknown required
frameworkunknown
environmentunknown
versionunknown
statusunknown required
enforcement_modeunknown required
last_seen_atunknown
created_atunknown required
updated_atunknown required

Changes

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