Get a memory
⚠️
Preview — this feature is being built; the design below is the spec.
GET https://app.syntic.ai/v1/memory_stores/{store_id}/memories/{memory_id}Return one memory with where it came from. source.kind is api for memories you wrote, session for ones an agent saved with its memory tool, and consolidation for ones rewritten by a consolidation job.
For how this fits into a full workflow, see Memory stores.
Headers
| Header | Required | Value |
|---|---|---|
Authorization | Yes | Bearer <key>: a private inference key (sk_live_...). See Authentication. |
syntic-beta | Yes, while in preview | agents-2026-11-01. Without it the call fails with 400 beta_required. See Versioning. |
Path parameters
| Parameter | Type | Description |
|---|---|---|
store_id | string | The memory store id, starting with mem_. |
memory_id | string | The memory id, starting with mmr_. |
Response
200 OK, Content-Type: application/json
{
"id": "mmr_01JC8D1F3H5K7M9P1R3T",
"store_id": "mem_01JC1A3C5E7G9J1L3N5Q",
"scope": "customer:4821",
"content": "Account manager is Priya; escalate billing issues to her.",
"tags": [
"contact"
],
"source": {
"kind": "session",
"session_id": "sesn_01JC7M2K4P6R8T0V2X4Z"
},
"created_at": "2026-11-05T10:00:15Z",
"updated_at": "2026-11-05T10:00:15Z",
"expires_at": "2027-11-05T10:00:15Z",
"revision": 1
}| Field | Type | Description |
|---|---|---|
source | object | kind plus the session or job id that wrote it. |
revision | integer | Goes up by one on every update; send it as if_revision on update to avoid overwriting a newer change. |
Examples
curl -sS "https://app.syntic.ai/v1/memory_stores/mem_01JC1A3C5E7G9J1L3N5Q/memories/mmr_01JC8D1F3H5K7M9P1R3T" \
-H "Authorization: Bearer $SYNTIC_API_KEY" \
-H "syntic-beta: agents-2026-11-01"Errors
Errors use the error envelope and carry a request_id. Codes specific to this operation:
| Status | type | code | When |
|---|---|---|---|
| 400 | invalid_request_error | beta_required | The syntic-beta header is missing. |
| 404 | not_found_error | memory_not_found | No memory with this id in the store. |
| 401 | authentication_error | invalid_api_key | The key is missing, unknown, revoked or expired. |
| 429 | rate_limit_error | rate_limited | Too many requests; wait for Retry-After. See Rate-limit headers. |
Was this page helpful?