Sources

A source is what a profile stored and extracts memories from: one ingested session, or one remembered fact. ingest and remember return its source_id in their 202, so you have it before extraction finishes. Re-ingesting a session keeps its source id and replaces what it held.

List a profile’s sources

Every source a profile stored, most recently written first, without content:

curl "https://api.telnyx.com/v2/ai/memory/namespaces/default/profiles/caller:+13128675309/sources" \
  -H "Authorization: Bearer $TELNYX_API_KEY"

{
  "data": [
    { "id": "b1e6c0a2-…", "session_id": "conv_8901", "memory_count": 3, "created_at": "2026-08-26T21:14:11Z", "updated_at": "2026-08-26T21:14:11Z" },
    { "id": "9af23d17-…", "session_id": null, "memory_count": 1, "created_at": "2026-08-25T09:02:44Z", "updated_at": "2026-08-25T09:02:44Z" }
  ],
  "meta": { "page_number": 1, "page_size": 20, "total_pages": 1, "total_results": 2 }
}

session_id is null for a remembered fact — the only place the two kinds differ. Paged like every listing: page[number] / page[size], with meta.total_pages / meta.total_results.

Find one session’s source

Add ?session_id= to look up the source a session was stored as, without paging or re-deriving its id:

curl "https://api.telnyx.com/v2/ai/memory/namespaces/default/profiles/caller:+13128675309/sources?session_id=conv_8901" \
  -H "Authorization: Bearer $TELNYX_API_KEY"

It returns zero or one source. An unknown session, another profile’s session, or one whose ingest is still queued is an empty page (total_results: 0) — a listing, not a 404. A session_id over 128 characters is a 422.

Read one source

One source with its content, returned in the shape it was sent — a JSON body as JSON, a string as a string:

curl "https://api.telnyx.com/v2/ai/memory/namespaces/default/profiles/caller:+13128675309/sources/$SOURCE_ID" \
  -H "Authorization: Bearer $TELNYX_API_KEY"

{
  "data": {
    "id": "b1e6c0a2-…",
    "session_id": "conv_8901",
    "memory_count": 3,
    "created_at": "2026-08-26T21:14:11Z",
    "updated_at": "2026-08-26T21:14:11Z",
    "content": {
      "messages": [{ "role": "user", "content": "invoices go to 220 W Chicago Ave now" }]
    }
  }
}

Trace a memory to its source

Read one memory by id to see where it came from — exactly one field is set:

curl "https://api.telnyx.com/v2/ai/memory/namespaces/default/profiles/caller:+13128675309/memories/mem_01H…" \
  -H "Authorization: Bearer $TELNYX_API_KEY"

A fact names the source it was extracted from in source_id — read it with GET …/sources/{source_id}.
A derived memory names the memories it was built from in derived_from — read each one to follow it back. Every read is a single call, however many memories are cited.

{
  "data": {
    "id": "mem_01H…",
    "text": "Invoices go to 220 W Chicago Ave.",
    "recorded_at": "2026-08-26T21:14:11Z",
    "source_id": "b1e6c0a2-…",
    "derived_from": null
  }
}

Forget one source

Forget a single source and the memories derived from it, leaving the rest of the profile intact. This is also how you forget one session — delete the session’s source, either with the source_id from the ingest 202 or the one from ?session_id= above:

curl -X DELETE "https://api.telnyx.com/v2/ai/memory/namespaces/default/profiles/caller:+13128675309/sources/$SOURCE_ID" \
  -H "Authorization: Bearer $TELNYX_API_KEY"

A source that is not there answers 404 — an unknown id, another profile’s source, or one already forgotten. Retrying is safe: on a 502 or 504, repeat it and read a 404 as done.

A source id is an opaque UUID. Another profile’s source or memory answers 404 — the same as one that does not exist — and an id that is not a UUID is a 422.

Writing memories — how sources get in
Recalling memories — reading a profile’s memories
Forgetting — forgetting a whole profile

Agent Memory

Features

API Reference

For AI Agents

List a profile’s sources

Find one session’s source

Read one source

Trace a memory to its source

Forget one source

​List a profile’s sources

​Find one session’s source

​Read one source

​Trace a memory to its source

​Forget one source

​Related

List a profile’s sources

Find one session’s source

Read one source

Trace a memory to its source

Forget one source

Related