Create a memory

POST /api/v1/cloud/memory_stores/{memory_store_id}/memories Creates a new memory entry. Returns the created memory with content included.

Path parameters

Parameter	Description
`memory_store_id`	The store ID (`memstore_...`)

Headers

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

Request body

Field	Type	Required	Description
`path`	string	Yes	Entry path, up to 1024 characters. Cannot contain `..`
`content`	string	Yes	Entry content, up to 100 KB
`metadata`	object	No	Key-value tags. Up to 16 pairs; keys 1–64 characters; values up to 512 characters

Example request

curl -X POST "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/memories" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "decisions/arch-choice.md",
    "content": "# Architecture Decision\n\nChose microservices."
  }'

Response

{
  "id": "mem_019e5cdba1b674e4a6a7d4f8c9b3e2a1",
  "type": "memory",
  "memory_store_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4",
  "path": "decisions/arch-choice.md",
  "content": "# Architecture Decision\n\nChose microservices.",
  "content_size_bytes": 46,
  "content_sha256": "a1b2c3...",
  "version": 1,
  "metadata": {},
  "created_at": "2026-05-18T08:01:00.000Z",
  "updated_at": "2026-05-18T08:01:00.000Z"
}

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	Invalid path, blank or oversized content
404	`not_found_error`	Store does not exist
409	`invalid_request_error`	Store is archived, or path already exists

List memories Retrieve a memory

​Path parameters

​Headers

​Request body

​Example request

​Response

​Errors

Path parameters

Headers

Request body

Example request

Response

Errors