Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

POST /v1/memory_stores Creates a new Memory Store.

Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT
Content-TypeYesapplication/json

Request body

FieldTypeRequiredDescription
namestringYesMemory store name (duplicates allowed)
descriptionstringNoMemory store description

Example request

curl -X POST "https://openapi.qoder.sh/api/v1/cloud/memory_stores" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-store",
    "description": "Project notes store"
  }'

Example response

HTTP 201 Created Returns the created MemoryStore object.
{
  "id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "type": "memory_store",
  "name": "my-store",
  "description": "Project notes store",
  "status": "active",
  "entry_count": 0,
  "total_size": 0,
  "metadata": {},
  "created_at": "2026-05-18T15:33:49.449264Z",
  "updated_at": "2026-05-18T15:33:49.449264Z"
}

Response fields

FieldTypeDescription
idstringUnique identifier with the memstore_ prefix
typestringAlways "memory_store"
namestringMemory store name
descriptionstringMemory store description
statusstringStatus: "active", "archived", or "deleted"
entry_countint64Number of memory entries
total_sizeint64Total storage size in bytes
metadataobjectCustom metadata
created_atstringCreation time (ISO 8601)
updated_atstringLast update time (ISO 8601)

Errors

HTTPTypeTrigger
401TOKEN_INVALIDMissing or invalid authentication token

Notes

  • Duplicate store names are allowed and do not conflict.
  • A new store starts in "active" status.
  • entry_count and total_size start at 0.
See Errors for the full error envelope.