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

> Suggested questions (client.suggestions).

### SuggestionsResource

```python
class SuggestionsResource(http: HttpClient, config: ModusConfig)
```

Bases: `object`

List suggested questions and record suggestion events.

#### list()

```python
list(*, page_size: int = 5, page_token: str | None = None, scope_id: int | None = None, scope_ids: Sequence[int] | None = None) → Page[SuggestionQuestionDto]
```

List approved suggested questions for the caller organization.

* Parameters:

  * **page\_size** – Maximum number of suggestions to return.

  * **page\_token** – Cursor from a previous page, if any.

  * **scope\_id** – Optional single scope id filter.

  * **scope\_ids** – Optional multi-scope id filter (comma-joined on the wire).

#### record\_event()

```python
record_event(suggestion_id: str, *, event_type: SuggestionEventType | str, source: SuggestionEventSource | str | None = None, skill_id: int | None = None, thread_id: str | None = None, metadata: Mapping[str, Any] | None = None) → None
```

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

### AsyncSuggestionsResource

```python
class AsyncSuggestionsResource(http: AsyncHttpClient, config: ModusConfig)
```

Bases: `object`

Async suggested-question APIs.

#### list()

```python
async list(*, page_size: int = 5, page_token: str | None = None, scope_id: int | None = None, scope_ids: Sequence[int] | None = None) → AsyncPage[SuggestionQuestionDto]
```

List approved suggested questions for the caller organization.

* Parameters:

  * **page\_size** – Maximum number of suggestions to return.

  * **page\_token** – Cursor from a previous page, if any.

  * **scope\_id** – Optional single scope id filter.

  * **scope\_ids** – Optional multi-scope id filter (comma-joined on the wire).

#### record\_event()

```python
async record_event(suggestion_id: str, *, event_type: SuggestionEventType | str, source: SuggestionEventSource | str | None = None, skill_id: int | None = None, thread_id: str | None = None, metadata: Mapping[str, Any] | None = None) → None
```

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