> AI agents: this is one page from Mammoth Analytics documentation. The index of all pages as Markdown is https://docs.mammoth.io/llms.txt. Append `.md` to any docs URL, or send `Accept: text/markdown`, to get Markdown.

# mammoth workspace

> All 33 mammoth workspace commands, each with its blast radius, confirmation policy and backing Python SDK method.

> GENERATED from `mammoth schema list` and `mammoth capability list` (mammoth-cli 2.2.96, released 2026-10-22)—do not edit; run `npm run docs:capabilities`.

33 commands, grouped by blast radius.

"Off a terminal" is what a command's confirmation policy requires when nothing can answer a prompt, as in an agent or CI run: `--yes`, plus `--confirm` with the exact target for `confirm_target` commands. `TARGET` stands for the id or name the command acts on; the CLI's `confirmation_required` error names it.

The SDK symbol and API operation come from `mammoth capability list`. A command that list does not map to one shows — in both columns; `mammoth schema get <command.id>` describes any command in full.

## Destructive

| Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation |
|---|---|---|---|---|---|---|---|---|
| `mammoth workspace invite delete` | `workspace` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | — | — |
| `mammoth workspace invite revoke` | `workspace` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | — | — |
| `mammoth workspace user remove` | `workspace` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.user_remove` | `DELETE /workspaces/{workspace_id}/users/{user_id}` (RemoveUser) |
| `mammoth workspace user remove-batch` | `workspace` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.user_remove_batch` | `DELETE /workspaces/{workspace_id}/users` (RemoveUserFromWorkspace) |

## High impact

| Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation |
|---|---|---|---|---|---|---|---|---|
| `mammoth workspace delete` | `workspace` | High impact | `confirm_target` | `--yes --confirm TARGET` | `not_async` | `none` | `mammoth.api.workspace.WorkspaceAPI.delete` | `DELETE /workspaces/{workspace_id}` (DeleteUserWorkspace) |
| `mammoth workspace export-hosts set` | `workspace` | High impact | `yes_always` | `--yes` | `not_async` | `none` | `mammoth.api.exports.ExportsAPI.set_export_hosts` | `PUT /workspaces/{workspace_id}/export-hosts` (Update) |
| `mammoth workspace invite update-role` | `workspace` | High impact | `yes_always` | `--yes` | `not_async` | `none` | — | — |
| `mammoth workspace oauth-client create` | `workspace` | High impact | `yes_always` | `--yes` | `not_async` | `none` | `mammoth.api.oauth_clients.OAuthClientsAPI.create` | `POST /workspaces/{workspace_id}/oauth-clients` (CreateOauthClient) |
| `mammoth workspace oauth-client delete` | `workspace` | High impact | `confirm_target` | `--yes --confirm TARGET` | `not_async` | `none` | `mammoth.api.oauth_clients.OAuthClientsAPI.delete` | `DELETE /workspaces/{workspace_id}/oauth-clients/{oauth_client_id}` (DeleteOauthClient) |
| `mammoth workspace oauth-client revoke-grant` | `workspace` | High impact | `confirm_target` | `--yes --confirm TARGET` | `not_async` | `none` | `mammoth.api.oauth_clients.OAuthClientsAPI.revoke_grant` | `DELETE /workspaces/{workspace_id}/oauth-clients/{oauth_client_id}/grant` (RevokeOauthGrant) |
| `mammoth workspace reactivate` | `workspace` | High impact | `confirm_target` | `--yes --confirm TARGET` | `not_async` | `none` | `mammoth.api.workspace.WorkspaceAPI.reactivate` | `POST /workspaces/{workspace_id}/reactivate` (ReactivateWorkspace) |
| `mammoth workspace update` | `workspace` | High impact | `confirm_target` | `--yes --confirm TARGET` | `not_async` | `none` | `mammoth.api.workspace.WorkspaceAPI.update` | `PATCH /workspaces/{workspace_id}` (UpdateWorkspace) |
| `mammoth workspace user update` | `workspace` | High impact | `confirm_target` | `--yes --confirm TARGET` | `not_async` | `none` | `mammoth.api.workspace.WorkspaceAPI.update_user` | `PATCH /workspaces/{workspace_id}/users/{user_id}` (UpdateUserInWorkspace) |
| `mammoth workspace user update-batch` | `workspace` | High impact | `confirm_target` | `--yes --confirm TARGET` | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.user_update_batch` | `PATCH /workspaces/{workspace_id}/users` (UpdateUserToWorkspace) |

## Benign mutation

| Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation |
|---|---|---|---|---|---|---|---|---|
| `mammoth workspace accept-invite` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.accept_invite` | `POST /accept-invite` (AcceptInvite) |
| `mammoth workspace check-expression` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.check_expression` | `POST /workspaces/{workspace_id}/ai/check-expression` (GenerateCheckExpression) |
| `mammoth workspace create` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.create` | `POST /workspaces` (CreateWorkspace) |
| `mammoth workspace invite resend` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | — | — |
| `mammoth workspace llm-task` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.llm_task` | `POST /workspaces/{workspace_id}/llm` (RunLlmTask) |
| `mammoth workspace segment update` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.segment_update` | `PATCH /workspaces/{workspace_id}/split-segments` (UpdateSegments) |
| `mammoth workspace user add` | `workspace` | Benign mutation | `yes_always` | `--yes` | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.user_add` | `POST /workspaces/{workspace_id}/users` (AddUserInWorkspace) |

## Read

| Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation |
|---|---|---|---|---|---|---|---|---|
| `mammoth workspace app-usage` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.app_usage` | `GET /workspaces/{workspace_id}/app-usage` (GetAppUsage) |
| `mammoth workspace current` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.workspace.WorkspaceAPI.current` | `GET /workspaces/current` (GetCurrentWorkspace) |
| `mammoth workspace export-hosts get` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.exports.ExportsAPI.export_hosts` | `GET /workspaces/{workspace_id}/export-hosts` (Read) |
| `mammoth workspace get` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.workspace.WorkspaceAPI.get` | `GET /workspaces/{workspace_id}` (GetWorkspace) |
| `mammoth workspace home` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.home_summary` | `GET /workspaces/{workspace_id}/home` (GetHomeSummary) |
| `mammoth workspace invite list` | `workspace` | Read | `none` | — | `not_async` | `none` | — | — |
| `mammoth workspace list` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.workspace.WorkspaceAPI.list` | `GET /workspaces` (GetWorkspaces) |
| `mammoth workspace oauth-client list` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.oauth_clients.OAuthClientsAPI.list` | `GET /workspaces/{workspace_id}/oauth-clients` (ListOauthClients) |
| `mammoth workspace segment list` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.workspaces.WorkspacesAPI.segment_list` | `GET /workspaces/{workspace_id}/split-segments` (GetSegments) |
| `mammoth workspace storage-breakdown` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.workspaces.WorkspacesAPI.storage_breakdown` | `GET /workspaces/{workspace_id}/storage-breakdown` (GetStorageBreakdown) |
| `mammoth workspace user get` | `workspace` | Read | `none` | — | `not_async` | `none` | — | — |
| `mammoth workspace user list` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.workspace.WorkspaceAPI.list_users` | `GET /workspaces/{workspace_id}/users` (GetUsersInWorkspace) |

---
Source: https://docs.mammoth.io/build/cli/workspace.md · Updated: 2026-10-22