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

HeaderRequiredValue
AuthorizationYesBearer <key>: a private inference key (sk_live_...). See Authentication.
syntic-betaYes, while in previewagents-2026-11-01. Without it the call fails with 400 beta_required. See Versioning.

Path parameters

ParameterTypeDescription
store_idstringThe memory store id, starting with mem_.
memory_idstringThe 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
}
FieldTypeDescription
sourceobjectkind plus the session or job id that wrote it.
revisionintegerGoes 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:

StatustypecodeWhen
400invalid_request_errorbeta_requiredThe syntic-beta header is missing.
404not_found_errormemory_not_foundNo memory with this id in the store.
401authentication_errorinvalid_api_keyThe key is missing, unknown, revoked or expired.
429rate_limit_errorrate_limitedToo many requests; wait for Retry-After. See Rate-limit headers.
Was this page helpful?