Create a memory store

POST /api/v1/cloud/memory_stores Creates a Memory Store and returns a Memory Store object.

Headers

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

Request body

Field	Type	Required	Description
`name`	string	Yes	Human-readable name, 1–255 characters, no control characters
`description`	string	No	Free-text description, up to 1024 characters. Included in the agent's system prompt when the store is attached
`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.cn/api/v1/cloud/memory_stores" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "project-alpha-memory",
    "description": "Agent knowledge base for project Alpha",
    "metadata": {"team": "backend"}
  }'

Example response

{
  "id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4",
  "created_at": "2026-05-18T08:00:00.000Z",
  "name": "project-alpha-memory",
  "type": "memory_store",
  "updated_at": "2026-05-18T08:00:00.000Z",
  "archived_at": null,
  "description": "Agent knowledge base for project Alpha",
  "metadata": {"team": "backend"},
  "status": "active",
  "entry_count": 0,
  "total_size": 0
}

Error codes

HTTP	type	Trigger
400	`invalid_request_error`	`name` is missing or invalid, or `metadata` is invalid
401	`authentication_error`	Missing or invalid authentication token

For the complete error envelope, see Errors.

​Headers

​Request body

​Example request

​Example response

​Error codes

Headers

Request body

Example request

Example response

Error codes