---
title: Agent Memory API for AI Agents, Now in Beta on Telnyx
canonical: https://telnyx.com/release-notes/telnyx-agent-memory-api-beta
---
# Agent Memory API for AI Agents, Now in Beta on Telnyx

[Release notes](https://telnyx.com/release-notes)

# Agent Memory API Now in Beta on Telnyx

### 1, Oct 2026

Telnyx Agent Memory (Beta) gives AI agents long-term memory through one API. Each user, caller, or agent gets a profile. Your app writes sessions and facts in, and the agent recalls the ones that matter when the next conversation starts.

### What's new

* **A profile per user, caller, or agent:** Key memory to whatever id you already use, such as a phone number or a user ID. One profile never sees another profile's memories.
* **Ingest a session:** Send a finished conversation in whatever shape your framework produces, from a voice call, a chat, or your own app, and Telnyx extracts the facts. Sending the same `session_id` again replaces that session, so a retry after a timeout is safe.
* **Remember one fact:** Store a sentence exactly as written, such as a CRM field or a preference the user set, with no extraction.
* **Recall:** Ask a question and get ranked facts back. No LLM sits in the recall path.
* **Summary card:** Read one precomputed summary of a profile at the start of a session, with no query needed.
* **See and delete what is stored:** List a profile's memories and sources, read a source as it was sent, forget one source, or forget a whole profile.

### Why it matters

* An agent without memory asks the same questions in every conversation. Agent Memory keeps what a customer told you on the phone available when they message you weeks later, on any channel.
* Building memory yourself means an extraction job, a store, and a delete path that reaches derived facts. Agent Memory is one API on `api.telnyx.com`, called with the same API key as the rest of your Telnyx account, so there is no separate vendor to integrate.
* Every memory traces back to the source it came from, so you can show a user what the agent knows and remove it.
* During Beta, writes are asynchronous: a write returns `202` with an operation to poll, and a memory is recallable once that operation completes, usually within seconds. One namespace, `default`, is available today.

### Example use cases

* A booking agent that recalls a customer's seat and meal preferences from a phone call when the same customer messages in chat weeks later.
* A voice agent that greets a repeat caller with what it learned on the last call instead of starting from zero.
* A sales assistant that follows a prospect across calls and chats without re-asking the same qualifying questions.
* A personal assistant that keeps preferences current as they change.

### Getting started

1. Use your existing Telnyx API key. There is nothing to provision: the `default` namespace and each profile are created on first use.
2. Write a fact to a profile:

curl -X POST "https://api.telnyx.com/v2/ai/memory/namespaces/default/profiles/user_4417/remember" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Prefers an aisle seat and a vegetarian meal"}'

1. Poll the returned `operation_id` at `/namespaces/default/operations/{operation_id}` until its status is `completed`.
2. Recall what the agent needs:

curl -X POST "https://api.telnyx.com/v2/ai/memory/namespaces/default/profiles/user_4417/recall" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What seat and meal should I book?", "top_k": 3}'

1. When a user asks to be forgotten, delete the profile with `DELETE /namespaces/default/profiles/{id}`, or delete a single source to remove just the memories it produced.

**Learn more** in the [Agent Memory docs](https://developers.telnyx.com/docs/agent-memory), including [writing memories](https://developers.telnyx.com/docs/agent-memory/writing), [recalling memories](https://developers.telnyx.com/docs/agent-memory/recall), and [deleting memories](https://developers.telnyx.com/docs/agent-memory/deleting).

[Start building](https://telnyx.com/sign-up)

### Ask AI

* [![GPT](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/chatgpt_icon-ea55e09d.jpeg?width=92&format=webp)](https://chat.openai.com/?q=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.)
* [![Claude](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/claude_icon-c7c8eef3.webp?width=92&format=webp)](https://claude.ai/new?q=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.)
* [![Perplexity](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/perplexity_icon-cd5b74f1.webp?width=92&format=webp)](https://www.perplexity.ai/search?q=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.)
* [![Gemini](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/gemini_icon-4ff1cbf4.webp?width=92&format=webp)](https://www.google.com/search?udm=50&aep=11&q=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.)
* [![Grok](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/grok_icon-e588e5bd.webp?width=92&format=webp)](https://x.com/i/grok?text=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.)