TAtavus
Memory Stores

Create Memory Store

Changed on

Creates a persistent memory store for one PAL and participant. This is useful when you need to add pinned memories before the participant's first conversation. Otherwise, passing one tag in participant_tags to Create Conversation creates the store automatically.

Only one active store may exist for a given pal_id and participant_tag.

post/v2/memory-stores

Request

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

Request body

pal_idstring required

PAL that will use this memory store.

participant_tagstring required

Stable identifier for the participant in your application.

pinned_memoriesstring[]

Optional static facts to seed into the store. Up to 30 facts, each with up to 500 characters.

Example request

{
  "pal_id": "p123456789ab",
  "participant_tag": "user_12345",
  "pinned_memories": [
    "Prefers concise answers",
    "Uses the Pro plan"
  ]
}

Response

Memory store created

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