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. 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:

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.

The memory object

{
  "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.

curl https://go.equals.com/api/v1/memories \
  -H "Authorization: Bearer $EQUALS_API_TOKEN"

{
  "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

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.

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.

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

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:

{ "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`

Getting Started

Connect and transform data

Explore data

Analyze data

Report on data

Authentication

The memory object

List memories

Get a memory

Create a memory

Update a memory

Delete a memory

Errors

​Authentication

​The memory object

​List memories

​Get a memory

​Create a memory

​Update a memory

​Delete a memory

​Errors

Authentication

The memory object

List memories

Get a memory

Create a memory

Update a memory

Delete a memory

Errors