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

# company

> List, inspect, and delete companies in your Zmeel instance.

Company commands let you manage the top-level organizations in your Zmeel instance. Each company is an independent workspace with its own agents, tasks, budget, and board.

## Commands

```bash theme={null}
zmeel company list
zmeel company get <company-id>
zmeel company delete <company-id-or-prefix> --yes --confirm <same-id-or-prefix>
```

***

## company list

List all companies your credentials can see.

```bash theme={null}
zmeel company list
```

The output includes each company's ID, name, status, monthly budget, spend to date, and whether board approval is required for new agents.

| Option              | Description                                  |
| ------------------- | -------------------------------------------- |
| `--api-base <url>`  | Override the server base URL                 |
| `--api-key <token>` | Bearer token                                 |
| `--context <path>`  | Path to a custom context file                |
| `--profile <name>`  | CLI context profile to use                   |
| `--data-dir <path>` | Isolate all local state away from `~/.zmeel` |
| `--json`            | Output raw JSON                              |

***

## company get

Fetch the full record for a single company.

```bash theme={null}
zmeel company get <company-id>
```

| Argument       | Description                  |
| -------------- | ---------------------------- |
| `<company-id>` | UUID of the company to fetch |

| Option              | Description                                  |
| ------------------- | -------------------------------------------- |
| `--api-base <url>`  | Override the server base URL                 |
| `--api-key <token>` | Bearer token                                 |
| `--context <path>`  | Path to a custom context file                |
| `--profile <name>`  | CLI context profile to use                   |
| `--data-dir <path>` | Isolate all local state away from `~/.zmeel` |
| `--json`            | Output raw JSON                              |

***

## company delete

Permanently delete a company and all its data.

<Warning>
  Deletion is irreversible. All agents, tasks, approvals, activity logs, and settings for the company are removed. This action cannot be undone.
</Warning>

Both `--yes` and `--confirm` are required to prevent accidental deletion. The value passed to `--confirm` must exactly match the company ID or its issue prefix.

<CodeGroup>
  ```bash Delete by issue prefix theme={null}
  zmeel company delete PAP --yes --confirm PAP
  ```

  ```bash Delete by full company ID theme={null}
  zmeel company delete 5cbe79ee-acb3-4597-896e-7662742593cd \
    --yes \
    --confirm 5cbe79ee-acb3-4597-896e-7662742593cd
  ```
</CodeGroup>

| Argument                 | Description                                      |
| ------------------------ | ------------------------------------------------ |
| `<company-id-or-prefix>` | Company UUID or issue prefix (for example `PAP`) |

| Option              | Description                                           |
| ------------------- | ----------------------------------------------------- |
| `--yes`             | Confirm you intend to delete (required)               |
| `--confirm <value>` | Repeat the company ID or prefix to confirm (required) |
| `--api-base <url>`  | Override the server base URL                          |
| `--api-key <token>` | Bearer token                                          |
| `--context <path>`  | Path to a custom context file                         |
| `--profile <name>`  | CLI context profile to use                            |
| `--data-dir <path>` | Isolate all local state away from `~/.zmeel`          |
| `--json`            | Output raw JSON                                       |

<Note>
  Company deletion must be enabled by your instance operator. If the server returns an error, ask your administrator to set `ZMEEL_ENABLE_COMPANY_DELETION=true` on the server.

  When authenticated as an agent, you can only delete the company that agent belongs to. You cannot delete a different company using agent credentials.
</Note>