contexts

Update Context

Update a context's display_name, description and settings.

Permission (Issue #165 Phase 3):

  • summary/usage_guide/is_private/is_public/resource_id/is_locked/sleep_mode: Requires OWNER access (owner-only fields — see owner_only_fields list)
  • display_name/description: Requires EDITOR access

Args: context_id: Context UUID request: Update request user: Authenticated user service: Context service db: Database session

Returns: Updated context data

Raises: 403: If insufficient permissions 404: If context not found

put/api/v1/contexts/{context_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/contexts/{context_id}
  • Auth: none declared

Path parameters

context_idstring uuid required

Headers

authorizationstring nullable

Request body

display_namestring nullable

Updated display name

descriptionstring nullable

Updated context description

summarystring nullable

Updated context summary

usage_guidestring nullable

Updated usage guidelines

is_privateboolean nullable

Privacy flag (Migration 034: Shared → Private removes non-owner members)

is_publicboolean nullable

Public flag (Issue #238: Public REST API access)

resource_idstring nullable

Resource ID for contexts (lowercase alphanumeric, underscore, and hyphen)

is_lockedboolean nullable

When true, prevents this context from being deleted until unlocked.

sleep_mode'full' | 'edges_only' | 'skip' nullable

Sleep maintenance mode: full=all phases, edges_only=edge discovery+reindex, skip=none

Response

Successful Response

idunknown required
nameunknown required
display_nameunknown
descriptionunknown
summaryunknown
usage_guideunknown
is_defaultunknown required
is_privateunknown
is_publicunknown
resource_idunknown
writes_pausedunknown
is_lockedunknown
sleep_modeunknown
created_byunknown
created_by_nameunknown
created_atunknown required
updated_atunknown
use_rerankunknown
reranker_providerunknown
embedding_modelunknown
embedding_dimensionsunknown
member_countunknown
memory_countunknown
last_activity_atunknown

Changes

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