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

# interaction

> Log and view interactions — calls, emails, meetings, and notes.

Interactions are your record of every touchpoint with a contact — calls, emails, meetings, and notes. Log them as they happen to keep your team in sync.

## moss interaction list

List interactions with optional filtering.

```bash theme={null}
moss interaction list
moss interaction list --contact-id cnt_abc123 --type call
```

| Option              | Required | Description                                         |
| ------------------- | -------- | --------------------------------------------------- |
| `--page <n>`        | No       | Page number                                         |
| `--per-page <n>`    | No       | Items per page                                      |
| `--sort <field>`    | No       | Sort field                                          |
| `--order <dir>`     | No       | Sort order (`asc` or `desc`)                        |
| `--contact-id <id>` | No       | Filter by contact                                   |
| `--deal-id <id>`    | No       | Filter by deal                                      |
| `--type <type>`     | No       | Filter by type (`call`, `email`, `meeting`, `note`) |
| `--q <query>`       | No       | Search query                                        |

## moss interaction show

Show details for a single interaction.

```bash theme={null}
moss interaction show --id int_abc123
```

| Option      | Required | Description    |
| ----------- | -------- | -------------- |
| `--id <id>` | Yes      | Interaction ID |

## moss interaction log

Log a new interaction.

```bash theme={null}
moss interaction log \
  --contact-id cnt_abc123 \
  --type meeting \
  --notes "Discussed Q2 roadmap and pricing" \
  --occurred-at "2026-02-08T14:00:00Z"
```

| Option                     | Required | Description                                      |
| -------------------------- | -------- | ------------------------------------------------ |
| `--contact-id <id>`        | Yes      | Contact ID                                       |
| `--type <type>`            | Yes      | Type: `call`, `email`, `meeting`, or `note`      |
| `--deal-id <id>`           | No       | Associated deal ID                               |
| `--notes <text>`           | No       | Interaction notes / content                      |
| `--occurred-at <datetime>` | No       | When it occurred (ISO datetime, defaults to now) |

## moss interaction update

Update an existing interaction's notes or timestamp.

```bash theme={null}
moss interaction update --id int_abc123 --notes "Updated: discussed Q2 roadmap, agreed on pricing"
```

| Option                     | Required | Description                      |
| -------------------------- | -------- | -------------------------------- |
| `--id <id>`                | Yes      | Interaction ID                   |
| `--notes <text>`           | No       | Updated notes                    |
| `--occurred-at <datetime>` | No       | Updated timestamp (ISO datetime) |

## moss interaction delete

Delete an interaction.

```bash theme={null}
moss interaction delete --id int_abc123 --confirm
```

| Option      | Required | Description                                            |
| ----------- | -------- | ------------------------------------------------------ |
| `--id <id>` | Yes      | Interaction ID                                         |
| `--confirm` | Yes      | Confirm deletion (required for destructive operations) |

<Warning>
  This permanently deletes the interaction. This cannot be undone.
</Warning>