# XTrace Memory

> Hosted memory for AI agents. Send conversation turns, get back searchable facts.

## Docs

- [Delete memory](https://docs.mem.xtrace.ai/api-reference/memories/delete-memory.md): Delete a memory.
- [Get memory](https://docs.mem.xtrace.ai/api-reference/memories/get-memory.md): Get one memory by id. Works for facts, artifacts, episodes. Always returns the full representation — artifacts include ``details.full_content``.
- [Get revision chain](https://docs.mem.xtrace.ai/api-reference/memories/get-revision-chain.md): Return the revision chain for a memory.
- [Ingest memories](https://docs.mem.xtrace.ai/api-reference/memories/ingest-memories.md): Async ingest. Returns ``202 + job_id`` by default; the extraction runs in the background and the caller polls ``GET /v1/memories/jobs/{job_id}``.
- [List filterable fields](https://docs.mem.xtrace.ai/api-reference/memories/list-filterable-fields.md): List the filter axes available for search and list calls.
- [List memories](https://docs.mem.xtrace.ai/api-reference/memories/list-memories.md): List memories with flat-equality filters and cursor pagination.
- [Poll ingest job](https://docs.mem.xtrace.ai/api-reference/memories/poll-ingest-job.md): Return the current state of an ingest job.
- [Search memories](https://docs.mem.xtrace.ai/api-reference/memories/search-memories.md): Vector + filter search over the memory pool.
- [Update memory](https://docs.mem.xtrace.ai/api-reference/memories/update-memory.md): Update text and/or metadata.
- [Get usage](https://docs.mem.xtrace.ai/api-reference/usage/get-usage.md): Aggregate the org's MONTHLY UsageMetrics rows for the current calendar month, plus DAILY rows if requested, plus an inline Qdrant storage snapshot.
- [Authentication](https://docs.mem.xtrace.ai/guides/authentication.md): How API keys and org headers work — and how to wire them into the SDK.
- [Ingesting memories](https://docs.mem.xtrace.ai/guides/ingesting-memories.md): Send conversation turns, get back extracted facts. Async by default, with a sync escape hatch.
- [Quickstart](https://docs.mem.xtrace.ai/guides/quickstart.md): Install the SDK, ingest a conversation turn, and search it back — in under five minutes.
- [Searching memories](https://docs.mem.xtrace.ai/guides/searching-memories.md): Vector + filter search over the memories you've ingested.
- [TypeScript SDK](https://docs.mem.xtrace.ai/guides/typescript-sdk.md): Reference for the @xtraceai/memory package — every class, method, type, and error.
- [Introduction](https://docs.mem.xtrace.ai/introduction.md): Hosted memory for AI agents. Send conversation turns, get back searchable facts.

## OpenAPI Specs

- [openapi.public](https://api.staging.xtrace.ai/openapi.public.json)
- [openapi](https://docs.mem.xtrace.ai/api-reference/openapi.json)