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

# memories

> Long-term memory stored per scope.

## Constructor

```typescript
memories(http: HttpClient, config: ModusConfig, scopeId: string | number): ScopeMemoriesResource
```

### Parameters

<ResponseField name={"http"} type={"HttpClient"} required />

<ResponseField name={"config"} type={"ModusConfig"} required />

<ResponseField name={"scopeId"} type={"string | number"} required />

### Returns

`ScopeMemoriesResource`

## Methods

### delete()

```typescript
delete(memoryId: string): Promise<void>
```

Delete one memory (idempotent).

#### Parameters

<ResponseField name={"memoryId"} type={"string"} required />

#### Returns

`Promise<void>`

### list()

```typescript
list(options?: { pageSize: number; pageToken: string; userId: string }): Promise<Page<object>>
```

List memories stored for this scope.

#### Parameters

<ResponseField name={"options"} type={"{ pageSize: number; pageToken: string; userId: string }"} />

#### Returns

`Promise<Page<object>>`

A page of memories.

### search()

```typescript
search(request: object): Promise<object>
```

Search this scope's memories by natural-language query.

#### Parameters

<ResponseField name={"request"} type={"object"} required>
  Query text and optional `userId` / `limit`.
</ResponseField>

#### Returns

`Promise<object>`

Matching memories and relevance scores.

### update()

```typescript
update(memoryId: string, update: object, options?: { updateMask: string }): Promise<object>
```

Update one memory. Requires manage permission on the scope.

#### Parameters

<ResponseField name={"memoryId"} type={"string"} required>
  Id from list or search.
</ResponseField>

<ResponseField name={"update"} type={"object"} required>
  Fields to change (`memory` and/or `metadata`).
</ResponseField>

<ResponseField name={"options"} type={"{ updateMask: string }"} />

#### Returns

`Promise<object>`

The updated memory.