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/{memory_store_id}/memories
Creates a new memory entry in the specified Memory Store.
Path parameters
| Parameter | Type | Required | Description |
|---|
memory_store_id | string | Yes | Memory Store ID with the memstore_ prefix |
| Header | Required | Description |
|---|
Authorization | Yes | Bearer $QODER_PAT |
Content-Type | Yes | application/json |
Request body
| Field | Type | Required | Description |
|---|
path | string | Yes | Relative path (must not start with /) |
content | string | Yes | Memory content (text) |
Example request
curl -X POST "https://openapi.qoder.sh/api/v1/cloud/memory_stores/memstore_xxx/memories" \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"path": "notes/meeting.md",
"content": "Meeting notes content..."
}'
Example response
HTTP 201 Created
Returns the created MemoryEntry object.
{
"id": "mem_019e3bb965a671fca51bde1cf8d87de0",
"type": "memory",
"store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
"path": "notes/meeting.md",
"content": "Meeting notes content...",
"size": 11,
"content_sha256": "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c",
"version": 1,
"metadata": {},
"created_at": "2026-05-18T15:34:26.494349Z",
"updated_at": "2026-05-18T15:34:26.494349Z"
}
Response fields
| Field | Type | Description |
|---|
id | string | Unique identifier with the mem_ prefix |
type | string | Always "memory" |
store_id | string | Owning Memory Store ID |
path | string | Relative path |
content | string | Memory content |
size | int64 | Content size in bytes |
content_sha256 | string | Content SHA-256 hash |
version | int64 | Version number (starts at 1) |
metadata | object | Custom metadata |
created_at | string | Creation time (ISO 8601) |
updated_at | string | Last update time (ISO 8601) |
Errors
| HTTP | Type | Trigger |
|---|
| 400 | invalid_request_error | Invalid request parameters (e.g., path starts with /) |
| 401 | TOKEN_INVALID | Missing or invalid authentication token |
| 404 | not_found_error | Memory Store does not exist |
| 409 | conflict_error | An entry with the same path already exists in this store |
Error response examples
path starts with /:
{
"error": {
"message": "Field 'path' must be a relative path (cannot start with '/').",
"type": "invalid_request_error"
},
"type": "error"
}
{
"error": {
"message": "Version or state conflict.",
"type": "conflict_error"
},
"type": "error"
}
Notes
path must be a relative path; it cannot start with /.- A store cannot contain two entries with the same
path (returns 409).
- The initial version is 1.
- The server computes
size and content_sha256.
- Creating an entry also produces a version record with
action: "created".
See Errors for the full error envelope.
