Skip to main content
POST /v1/memory_stores/{memory_store_id}/archive Archives an active Memory Store and returns the updated Memory Store object.

Path parameters

ParameterTypeRequiredDescription
memory_store_idstringYesMemory Store ID with the memstore_ prefix

Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT

Example request

curl -X POST "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_019e3bb8d50674d9b082b73709c29c87/archive" \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK
{
  "id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "type": "memory_store",
  "name": "doc-test-store",
  "description": "Test store",
  "status": "archived",
  "entry_count": 0,
  "total_size": 0,
  "metadata": {},
  "archived_at": "2026-05-18T15:34:00.007987Z",
  "created_at": "2026-05-18T15:33:49.449264Z",
  "updated_at": "2026-05-18T15:34:00.007987Z"
}

Response fields

FieldTypeDescription
idstringMemory Store ID with the memstore_ prefix
typestringAlways "memory_store"
namestringStore name
descriptionstringStore description
statusstringarchived after the operation succeeds
entry_countintegerNumber of active memory entries
total_sizeintegerTotal size in bytes of active memory entries
metadataMetadata objectCustom metadata
archived_atstringUTC archive time
created_atstringUTC creation time
updated_atstringUTC last update time

Notes

No request body is required. Once archived, a store can still be read, but entries cannot be created or updated in it.

Errors

HTTPTypeTrigger
401authentication_errorMissing or invalid authentication token
404not_found_errorMemory Store with the given ID does not exist
409conflict_errorMemory Store is already archived
See Errors for the full error envelope.

Build persistent memory

Give your agent persistent memory across sessions.