Update a Memory Store

Updates a Memory Store's name, description, or metadata. This endpoint uses partial-update semantics: omitted fields remain unchanged, and null values are rejected.

Path

POST /api/v1/forward/memory_stores/{memory_store_id}

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or admin SAT>`
`Content-Type`	Yes	`application/json`

Path parameters

Parameter	Type	Required	Description
`memory_store_id`	string	Yes	Memory Store ID (`memstore_...`).

Request body

Field	Type	Required	Description
`name`	string	No	New name. When supplied, it must be non-empty and cannot contain non-printable control characters.
`description`	string	No	New description. When supplied, it cannot contain non-printable control characters.
`metadata`	object	No	New metadata. It replaces the current metadata instead of being merged. See Store metadata constraints.

The request body must contain at least one of these fields.

Example request

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Project Alpha v2 knowledge base"
  }'

Example response

HTTP 200 OK

{
  "id": "memstore_00mc7mukn7lkxr454tjd",
  "type": "memory_store",
  "name": "project-alpha-memory",
  "description": "Project Alpha v2 knowledge base",
  "status": "active",
  "entry_count": 12,
  "total_size": 4096,
  "metadata": {"created_by": "forward", "team": "backend"},
  "system_managed": false,
  "identity_id": null,
  "created_at": "2026-08-14T10:00:00Z",
  "updated_at": "2026-08-14T10:15:00Z",
  "archived_at": null,
  "binding_info": {"identity_template_count": 1}
}

Response

Returns a Memory Store object.

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	The request body is invalid: no field is supplied, `name` is empty or contains control characters, or metadata violates its constraints.
401	`authentication_error`	The authentication token is missing or invalid.
403	`permission_error`	The caller cannot access the resource.
404	`not_found_error`	The Store does not exist or is not visible across users.
409	`conflict_error`	The Store is archived and cannot be modified.
500/502/503	`api_error`	Forward or a dependent service failed.

​Path

​Headers

​Path parameters

​Request body

​Example request

​Example response

​Response

​Errors