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

# company

> Create, list, update, and delete companies.

Companies group your contacts under a shared organization. Link contacts and deals to companies to see the full picture of each account.

## moss company list

List companies with optional filtering and pagination.

```bash theme={null}
moss company list
moss company list --industry "SaaS" --tag enterprise
```

| 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`) |
| `--q <query>`           | No       | Full-text search query       |
| `--industry <industry>` | No       | Filter by industry           |
| `--tag <name>`          | No       | Filter by tag name           |

## moss company show

Show details for a single company.

```bash theme={null}
moss company show --id cmp_abc123
```

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

## moss company create

Create a new company.

```bash theme={null}
moss company create \
  --name "Acme Corp" \
  --domain "acme.com" \
  --industry "SaaS" \
  --size "50-200"
```

| Option                  | Required | Description                           |
| ----------------------- | -------- | ------------------------------------- |
| `--name <name>`         | Yes      | Company name                          |
| `--domain <domain>`     | No       | Company domain                        |
| `--industry <industry>` | No       | Industry                              |
| `--size <size>`         | No       | Company size                          |
| `--notes <text>`        | No       | Free-text notes                       |
| `--tags <tags>`         | No       | Comma-separated tag names             |
| `--set <key=value>`     | No       | Set a custom field value (repeatable) |

## moss company create-batch

Create multiple companies from a JSON file. Each object in the array takes the same fields as `moss company create`.

```bash theme={null}
moss company create-batch --file companies.json
```

```bash theme={null}
cat companies.json | moss company create-batch --file -
```

| Option          | Required | Description                                                                  |
| --------------- | -------- | ---------------------------------------------------------------------------- |
| `--file <path>` | Yes      | Path to JSON file containing an array of company objects, or `"-"` for stdin |

## moss company update

Update an existing company.

```bash theme={null}
moss company update --id cmp_abc123 --size "200-500"
```

| Option                  | Required | Description                           |
| ----------------------- | -------- | ------------------------------------- |
| `--id <id>`             | Yes      | Company ID                            |
| `--name <name>`         | No       | Company name                          |
| `--domain <domain>`     | No       | Company domain                        |
| `--industry <industry>` | No       | Industry                              |
| `--size <size>`         | No       | Company size                          |
| `--notes <text>`        | No       | Free-text notes                       |
| `--tags <tags>`         | No       | Comma-separated tag names             |
| `--set <key=value>`     | No       | Set a custom field value (repeatable) |

## moss company delete

Delete a company permanently.

```bash theme={null}
moss company delete --id cmp_abc123 --confirm
```

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

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