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

# Memories API

Memories are facts the Equals AI analyst remembers about your workspace — context it has learned from conversations, or that you've added yourself on the [Memories page](https://go.equals.com/memories). The Memories API lets you manage them programmatically: sync context from other systems, audit what the analyst knows, or build your own tooling on top.

All endpoints live under:

```
https://go.equals.com/api/v1
```

***

## Authentication

Requests are authenticated with an API token, passed as a bearer token:

```bash theme={null}
curl https://go.equals.com/api/v1/memories \
  -H "Authorization: Bearer eq_your_token_here"
```

To create a token, go to **Settings → API tokens** in Equals and click **Create token**. The token is shown only once, at creation — store it somewhere safe. Tokens act as you, scoped to the workspace they were created in, and can be revoked from the same page at any time.

<Frame>
  <img src="https://mintcdn.com/equals/bF5KoCHJm9mq2Djn/images/Screenshot-2026-07-23-at-11.05.08-AM.png?fit=max&auto=format&n=bF5KoCHJm9mq2Djn&q=85&s=58f84dc2eecb338a837635ad763ae9e1" alt="Screenshot-2026-07-23-at-11.05.08-AM" width="854" height="270" data-path="images/Screenshot-2026-07-23-at-11.05.08-AM.png" />
</Frame>

***

## The memory object

```json theme={null}
{
  "id": "2f1b6a9c-8f4e-4c1a-9b2d-7e5f3a1c8d4b",
  "content": "Fiscal year starts in February. Q1 = Feb–Apr.",
  "created_at": "2026-07-21T18:30:00Z",
  "updated_at": "2026-07-21T18:30:00Z"
}
```

| Field        | Type   | Description                                 |
| ------------ | ------ | ------------------------------------------- |
| `id`         | string | Unique identifier for the memory            |
| `content`    | string | The memory itself, as plain text            |
| `created_at` | string | When the memory was created (ISO 8601)      |
| `updated_at` | string | When the memory was last updated (ISO 8601) |

***

## List memories

```
GET /api/v1/memories
```

Returns all memories in the workspace, newest first.

```bash theme={null}
curl https://go.equals.com/api/v1/memories \
  -H "Authorization: Bearer $EQUALS_API_TOKEN"
```

```json theme={null}
{
  "memories": [
    {
      "id": "2f1b6a9c-8f4e-4c1a-9b2d-7e5f3a1c8d4b",
      "content": "Fiscal year starts in February. Q1 = Feb–Apr.",
      "created_at": "2026-07-21T18:30:00Z",
      "updated_at": "2026-07-21T18:30:00Z"
    }
  ]
}
```

***

## Get a memory

```
GET /api/v1/memories/:id
```

```bash theme={null}
curl https://go.equals.com/api/v1/memories/2f1b6a9c-8f4e-4c1a-9b2d-7e5f3a1c8d4b \
  -H "Authorization: Bearer $EQUALS_API_TOKEN"
```

Returns the memory object.

***

## Create a memory

```
POST /api/v1/memories
```

| Parameter | Type   | Description                       |
| --------- | ------ | --------------------------------- |
| `content` | string | Required. The memory to remember. |

```bash theme={null}
curl -X POST https://go.equals.com/api/v1/memories \
  -H "Authorization: Bearer $EQUALS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "ARR excludes one-time services revenue."}'
```

Returns the created memory object with status `201`.

***

## Update a memory

```
PATCH /api/v1/memories/:id
```

| Parameter | Type   | Description                |
| --------- | ------ | -------------------------- |
| `content` | string | Required. The new content. |

```bash theme={null}
curl -X PATCH https://go.equals.com/api/v1/memories/2f1b6a9c-8f4e-4c1a-9b2d-7e5f3a1c8d4b \
  -H "Authorization: Bearer $EQUALS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "ARR excludes one-time services and setup fees."}'
```

Returns the updated memory object.

***

## Delete a memory

```
DELETE /api/v1/memories/:id
```

```bash theme={null}
curl -X DELETE https://go.equals.com/api/v1/memories/2f1b6a9c-8f4e-4c1a-9b2d-7e5f3a1c8d4b \
  -H "Authorization: Bearer $EQUALS_API_TOKEN"
```

Returns an empty response with status `204`.

***

## Errors

Errors are returned as JSON with an `error` message:

```json theme={null}
{ "error": "Unauthorized" }
```

| Status | Meaning                                                               |
| ------ | --------------------------------------------------------------------- |
| `401`  | Missing, invalid, revoked, or expired API token                       |
| `403`  | The token's user is no longer a member of the workspace               |
| `404`  | No memory with that id in the workspace                               |
| `422`  | Invalid request — for example, creating a memory with empty `content` |