list_memories

GET

/v1/memories

const url = 'https://app.everruns.com/api/v1/memories';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.everruns.com/api/v1/memories

List workspace memories.

Parameters

Query Parameters

search

string | null

include_archived

boolean | null

Responses

200

List memories

application/json

Response wrapper for list endpoints. All list endpoints return responses wrapped in a data field.

object

data

required

Array of items returned by the list operation.

Array<object>

Response body for memory.

object

archived_at

Timestamp when this resource was archived, if any (RFC 3339).

string | null format: date-time

created_at

required

Timestamp when this resource was created (RFC 3339).

string format: date-time

deleted_at

Timestamp when this resource was soft-deleted, if any (RFC 3339).

string | null format: date-time

description

Human-readable description. Safe to render in user-facing messages.

string | null

required

Prefixed public identifier. See ID Schema.

string

is_readonly

required

Whether the memory is mounted read-only into sessions. Read-only memories accept no writes from the session sandbox.

boolean

last_sync_error

Most recent sync error message; cleared on the next successful sync.

string | null

last_synced_at

Timestamp of the most recent successful sync (RFC 3339). None if never synced.

string | null format: date-time

name

required

Human-readable name. Safe to render in user-facing messages.

string

source

required

One of:

Source-specific configuration (git remote, github repo, manual upload).

object

provider

required

string

Allowed values: manual

source_type

required

Source kind discriminator (manual, git, github). Determines which source variant is populated.

string

status

required

Current lifecycle status.

string

sync_status

required

Current sync status (idle, syncing, succeeded, failed). Only meaningful when source_type is git or github.

string

updated_at

required

Timestamp when this resource was last updated (RFC 3339).

string format: date-time

Example

{
  "data": [
    {
      "archived_at": "2026-05-26T00:00:00Z",
      "created_at": "2026-04-01T10:00:00Z",
      "deleted_at": "2026-05-26T00:00:00Z",
      "description": "Living design documents synced from GitHub",
      "id": "mem_01933b5a000070008000000000000001",
      "is_readonly": false,
      "last_sync_error": "ssh: connect to host github.com port 22: Connection timed out",
      "last_synced_at": "2026-05-25T08:00:00Z",
      "name": "design-docs",
      "source": {
        "provider": "manual"
      },
      "source_type": "github",
      "status": "active",
      "sync_status": "succeeded",
      "updated_at": "2026-05-25T08:00:00Z"
    }
  ]
}