Skip to main content
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)
descriptionstringYesMemory store description. Cannot be an empty string; omitting this field returns 400 Field 'description' is required.

​
Example request

curl -X POST "https://api.qoder.com/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.