Documentation

Build an agentthat remembers,in ten minutes

Guides, API reference and runnable recipes. Every example on this site works if you paste it into a terminal with an API key.

Get an API keyGet an API key Open the API referenceOpen the API reference

Hold to write

wrote “Prefers aisle seats” · mem_8f2k · 41 ms

Documentation

Find it in two keystrokes

Every endpoint has a runnable example, every guide ends with a working agent. Press ⌘K and try “decay”.

⌘K

Quickstart in 5 minutesdocs / get-started / quickstart-in-5-minutes→Install the Python SDKdocs / get-started / install-the-python-sdk→Install the TypeScript SDKdocs / get-started / install-the-typescript-sdk→Authentication and keysdocs / get-started / authentication-and-keys→

■ Quickstart

From zero to recall in three steps

Python shown. The TypeScript and HTTP versions are one tab away in the full guide.

Install and authenticate

pip install plivel

export PLIVEL_KEY=sk_live_…

Write what the user said

mem.write(user=”dana_k”,

text=”I always take the aisle”)

Recall before you answer

ctx = mem.recall(user=”dana_k”,

q=”book my usual seat”)

■ API reference

Six endpoints do almost everything

Full reference →

POST

/v1/write

Store what a user said. Deduped and merged automatically.

12 ms p50

POST

/v1/recall

Return the most relevant memories and a ready-made context string.

38 ms p50

GET

/v1/memories/:id

Read one memory with its relevance history and links.

6 ms p50

PATCH

/v1/memories/:id

Pin, unpin, re-tag or correct a memory.

9 ms p50

DELETE

/v1/users/:id

Erase a user everywhere and get a signed receipt.

< 60 s

GET

/v1/traces/:id

Fetch the span-level trace for any recall.

8 ms p50

Recipes

Start from a working agent that already remembers

Receptionist that knows the regularsGreets returning callers by name and skips the questions it already has answers to.Open recipe →

Sub-second context for LiveKitRecall runs while the caller is still speaking, so the first reply is already personal.Open recipe →

Outbound follow-upsCalls back with the notes from last time, not a blank script.Open recipe →

Language it heard last timePicks up in Portuguese if that is how the caller ended the previous call.Open recipe →

■ Help

Stuck? Real engineers answer

COMMUNITY

Community Discord

4,800 builders and the Plivel team. Median first reply: 14 minutes.

LIVE

Office hours

Every Tuesday, 16:00 UTC. Bring your trace, leave with a fix.

STATUS

Status and incidents

Live uptime per region and a full incident history.