The memory store object

⚠️

Preview — this feature is being built; the design below is the spec.

The memory_store object as the API returns it. Every field below appears in every response that returns this object; fields with no value are null rather than missing.

Example

{
  "id": "mem_01JC1A3C5E7G9J1L3N5Q",
  "type": "memory_store",
  "name": "support-customers",
  "description": "What the support agents know about each customer.",
  "agent_write": "scoped",
  "max_memories_per_scope": 500,
  "default_ttl_days": 365,
  "memory_count": 18342,
  "created_at": "2026-11-02T12:00:00Z"
}

Fields

Field	Type	Description
`id`	string	Unique id of this object.
`type`	string	The object type, always `memory_store`.
`name`	string	Name shown in the Console and in reports.
`description`	string	Free-text description.
`agent_write`	string	See the endpoint pages below.
`max_memories_per_scope`	integer	See the endpoint pages below.
`default_ttl_days`	integer	See the endpoint pages below.
`memory_count`	integer	See the endpoint pages below.
`created_at`	string	When it was created, RFC 3339 UTC (some older objects use Unix seconds).

Returned by

memory_consolidation model

Was this page helpful?