TAtavus
Memory Stores

Get Memory Store

Changed on

Returns the pinned and learned memory for one store.

get/v2/memory-stores/{memory_store_id}

Request

  • Base URL
    https://tavusapi.com
  • URL
    https://tavusapi.com/v2/memory-stores/{memory_store_id}
  • Auth
    API key in header x-api-key

Response

Memory store returned

memory_store_idstring required

Unique identifier for the memory store.

pal_idstring required

PAL this store belongs to.

participant_tagstring required

Developer-provided participant identifier.

created_atstring required

When the store was created.

updated_atstring required

When the store was last updated.

Example response

{
  "memory_store_id": "m123456789abc",
  "pal_id": "p123456789ab",
  "participant_tag": "user_12345",
  "pinned_memories": [
    {
      "memory_id": "pm123456789abc",
      "memory": "Prefers concise answers",
      "created_at": "2026-08-24 12:00:00",
      "updated_at": "2026-08-24 12:00:00"
    }
  ],
  "learned": {
    "profile": {
      "preferences": {
        "communication_style": "concise"
      }
    },
    "timeline": {
      "recent_conversations": [
        {
          "timestamp": "2026-08-24T19:00:00Z",
          "summary": "Discussed onboarding progress and next steps."
        }
      ]
    }
  },
  "created_at": "2026-08-24 12:00:00",
  "updated_at": "2026-08-24 12:00:00"
}

Changes