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

# suggestions

> List suggested questions and record suggestion events.

## Methods

### list()

```typescript
list(options?: { pageSize: number; pageToken: string; scopeId: number; scopeIds: readonly number[] }): Promise<Page<object>>
```

List approved suggested questions.

#### Parameters

<ResponseField name={"options"} type={"{ pageSize: number; pageToken: string; scopeId: number; scopeIds: readonly numb…"} />

#### Returns

`Promise<Page<object>>`

A page of suggested questions.

### recordEvent()

```typescript
recordEvent(id: string, event: object): Promise<void>
```

Record that a suggested question was shown, clicked, dismissed, or submitted.

#### Parameters

<ResponseField name={"id"} type={"string"} required>
  Suggestion id.
</ResponseField>

<ResponseField name={"event"} type={"object"} required>
  Event details, including `eventType` (`shown`, `clicked`, `dismissed`, or `submitted`).
</ResponseField>

#### Returns

`Promise<void>`