> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tensorpro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Base URL, authentication, conventions and limits for the EDN Memory API.

The **EDN Memory API** is a REST API that gives your AI app persistent memory.
Your app saves conversation turns to EDN, then asks EDN for the relevant memory
before each model call, as a SIP.

New to EDN? The [Quickstart](https://docs.tensorpro.ai/quickstart.md) takes you from an API key to your
first SIP in a few minutes.

## Base URL and authentication

All endpoints sit under one base URL, and every request sends your API key as
a bearer token:

```bash theme={"theme":"github-light"}
curl https://api.tensorpro.ai/api/v1/memory/records \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Setting | Value |
| - | - |
| **Base URL** | `https://api.tensorpro.ai/api/v1` (private beta) |
| **Auth header** | `Authorization: Bearer YOUR_API_KEY` |
| **API keys** | Create them in the [Console](https://docs.tensorpro.ai/console/api-keys.md). See [Authentication](https://docs.tensorpro.ai/authentication.md) |
| **No key needed** | [Health check](https://docs.tensorpro.ai/api-reference/health-check.md) only |

## Endpoints

> [card] [Save memory](https://docs.tensorpro.ai/api-reference/ingest-round.md)
>
> Save conversation turns and selected assistant outputs as memory.

> [card] [Manage memory](https://docs.tensorpro.ai/api-reference/list-memory-records.md)
>
> List, read, edit and delete memories, and see their history.

> [card] [Retrieve](https://docs.tensorpro.ai/api-reference/build-sip.md)
>
> Build a SIP for your model, or search memory.

> [card] [Documents](https://docs.tensorpro.ai/api-reference/ingest-document.md)
>
> Upload documents for EDN to answer from.

> [card] [Projects](https://docs.tensorpro.ai/api-reference/list-projects.md)
>
> Group documents and memory into separate project scopes.

> [card] [Sessions](https://docs.tensorpro.ai/api-reference/list-sessions.md)
>
> Manage conversations and store their transcripts.

## Conventions

* **Format:** request and response bodies are JSON. Document upload is the
  exception: it sends the file as a form upload (`multipart/form-data`).
* **IDs:** EDN generates the IDs of memories, projects and project documents.
* **Session IDs:** you choose `session_id` yourself.
  * Reuse it for every request in the same conversation. EDN creates the
    session the first time you use a new ID.
  * It must be 1 to 128 characters long.
  * It can contain letters, digits and these symbols: period (`.`), underscore
    (`_`), colon (`:`) and hyphen (`-`).
* **Timestamps:** ISO 8601 strings in UTC, such as
  `2026-11-10T04:43:25+00:00`.
* **Empty values:** optional response fields may be `null` when no value is
  available.

## Pagination

List endpoints use `limit` and `offset`. If you request a `limit` above the
endpoint's maximum, EDN returns the maximum allowed number of results.

| Endpoint | Default `limit` | Maximum |
| - | -: | -: |
| [List memories](https://docs.tensorpro.ai/api-reference/list-memory-records.md) | 50 | 200 |
| [List sessions](https://docs.tensorpro.ai/api-reference/list-sessions.md) | 50 | 200 |
| [List session messages](https://docs.tensorpro.ai/api-reference/list-session-messages.md) | 50 | 200 |
| [Search memories](https://docs.tensorpro.ai/api-reference/search.md) | 10 | 50 |

Listing projects and project documents returns every item.

## Errors and rate limits

| Topic | What to know |
| - | - |
| **Errors** | Every error returns `{"detail": "...", "code": "..."}`. Each endpoint page lists the errors it can return. See [Error handling](https://docs.tensorpro.ai/reference/errors.md) |
| **Usage limits** | During the beta, each account has a per-minute request limit and a daily limit on saving memory and on building SIPs. Limits may change as the beta develops |
| **Over a limit** | EDN returns `429` with a `Retry-After` header telling the client how many seconds to wait |

## Versioning

The API version is part of the path: `/api/v1`. The API is currently in
private beta, and breaking changes are announced to beta testers before they
ship.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.