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

# modus suggestions record-event

> Record a Home suggestion interaction event (shown, clicked, dismissed, submitted).

Record a Home suggestion interaction event (shown, clicked, dismissed, submitted).

## Usage

```bash theme={null}
modus suggestions record-event [flags]
```

## Arguments

| Name |          | Description    |
| ---- | -------- | -------------- |
| `id` | required | Suggestion id. |

## Flags

| Flag           | Type   | Description                                  |
| -------------- | ------ | -------------------------------------------- |
| `--event-type` | string | Interaction type.                            |
| `--source`     | string | Product surface that emitted the event.      |
| `--scope-id`   | string | Selected Home scope id, when known.          |
| `--thread-id`  | string | Conversation thread id, when tied to a chat. |

Global: `--pretty` — human-readable table output instead of compact JSON.

## Examples

```bash theme={null}
modus suggestions record-event sugg_abc --event-type clicked --source home
```

See [CLI quickstart](/guides/cli) for install and auth.