# list_memories

Source: <https://everruns.com/docs/api/operations/list_memories/>

GET

/v1/memories

Select code samplecURL (shell:curl)

```js
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);
}
```

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

* Production APIapp.everruns.com/api/v1/memories

List workspace memories.

## Parameters

### Query Parameters

**search**

string | null

**include\_archived**

boolean | null

## Responses

### 200

List memories

Media typeapplication/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

**id**

required

Prefixed public identifier. See [ID Schema](https://everruns.com/docs/advanced/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

**owner\_agent\_id**

Owning agent when `scope = agent`.

string | null

**owner\_user\_id**

Owning user when `scope = user`.

string | null format: uuid

**scope**

required

Ownership scope (`org`, `agent`, or `user`).

string

**source**

required

One of:

* object

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

  object

  **provider**

  required

  string

  Allowed values: manual

* object

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

  object

  **branch**

  required

  string

  **repository**

  required

  string

  **root\_folder**

  string | null

  **sync\_interval\_secs**

  Automatic resync interval in seconds. Omit or set 0 for manual-only; scheduled sync accepts 300 through 604800.

  integer | null format: int32

  <= 604800

  **provider**

  required

  string

  Allowed values: github

* object

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

  object

  **branch**

  required

  string

  **root\_folder**

  string | null

  **sync\_interval\_secs**

  Automatic resync interval in seconds. Omit or set 0 for manual-only; scheduled sync accepts 300 through 604800.

  integer | null format: int32

  <= 604800

  **url**

  required

  string

  **provider**

  required

  string

  Allowed values: git

**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

```json
{
  "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",
      "owner_agent_id": "agent_01933b5a000070008000000000000001",
      "scope": "org",
      "source": {
        "provider": "manual"
      },
      "source_type": "github",
      "status": "active",
      "sync_status": "succeeded",
      "updated_at": "2026-05-25T08:00:00Z"
    }
  ]
}
```