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

# commitment

> Track promises made to contacts — create, update, complete, and delete commitments.

Commitments track promises you've made to contacts — deliverables, timelines, or action items. Keep them visible so nothing falls through the cracks.

## moss commitment list

List commitments with optional filtering.

```bash theme={null}
moss commitment list
moss commitment list --contact-id cnt_abc123 --status open --overdue
```

| 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                                      |
| `--status <status>` | No       | Filter by status (`open`, `completed`, `cancelled`) |
| `--overdue`         | No       | Show only overdue commitments                       |

## moss commitment show

Show details for a single commitment.

```bash theme={null}
moss commitment show --id cmt_abc123
```

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

## moss commitment create

Create a new commitment.

```bash theme={null}
moss commitment create \
  --contact-id cnt_abc123 \
  --description "Deliver SSO implementation timeline" \
  --due-date 2026-02-15
```

| Option                 | Required | Description                   |
| ---------------------- | -------- | ----------------------------- |
| `--contact-id <id>`    | Yes      | Contact ID                    |
| `--description <text>` | Yes      | Description of the commitment |
| `--deal-id <id>`       | No       | Associated deal ID            |
| `--due-date <date>`    | No       | Due date (`YYYY-MM-DD`)       |

## moss commitment update

Update an existing commitment.

```bash theme={null}
moss commitment update --id cmt_abc123 --due-date 2026-02-28
moss commitment update --id cmt_abc123 --status cancelled
```

| Option                 | Required | Description                               |
| ---------------------- | -------- | ----------------------------------------- |
| `--id <id>`            | Yes      | Commitment ID                             |
| `--description <text>` | No       | Description                               |
| `--due-date <date>`    | No       | Due date (`YYYY-MM-DD`)                   |
| `--status <status>`    | No       | Status (`open`, `completed`, `cancelled`) |

## moss commitment complete

Mark a commitment as completed.

```bash theme={null}
moss commitment complete --id cmt_abc123
```

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

## moss commitment delete

Delete a commitment.

```bash theme={null}
moss commitment delete --id cmt_abc123 --confirm
```

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