> 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 connector

> All 40 mammoth connector 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`.

40 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 connector connection delete` | `workspace` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.delete_connection` | `DELETE /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}` (DeleteConnection) |
| `mammoth connector draft discard` | `workspace` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.discard` | `DELETE /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}` (DiscardConnectorDraft) |
| `mammoth connector ds-config delete` | `workspace` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.delete_ds_config` | `DELETE /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}/ds_configs/{ds_config_key}` (DeleteDsConfig) |
| `mammoth connector ds-config delete-all` | `workspace` | Destructive | `prompt_or_yes` | `--yes` | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.ds_config_delete_all` | `DELETE /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}/ds_configs` (DeleteDsConfigs) |

## External effect

| Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation |
|---|---|---|---|---|---|---|---|---|
| `mammoth connector connection create` | `workspace` | External effect | `yes_always` | `--yes` | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.create_connection` | `POST /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections` (SaveConnection) |
| `mammoth connector connection update` | `workspace` | External effect | `yes_always` | `--yes` | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.update_connection` | `PATCH /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}` (UpdateConnection) |
| `mammoth connector ds-config create` | `workspace` | External effect | `yes_always` | `--yes` | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.create_ds_config` | `POST /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}/ds_configs` (ValidateAndGetDsConfig) |
| `mammoth connector ds-config update` | `workspace` | External effect | `yes_always` | `--yes` | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.update_ds_config` | `PATCH /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}/ds_configs/{ds_config_key}` (UpdateDsConfigs) |

## Benign mutation

| Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation |
|---|---|---|---|---|---|---|---|---|
| `mammoth connector ai chat` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_ai.ConnectorAIAPI.chat` | `POST /workspaces/{workspace_id}/projects/{project_id}/ai/connector-chat` (Chat) |
| `mammoth connector ai submit-column-selection` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_ai.ConnectorAIAPI.submit_column_selection` | `POST /workspaces/{workspace_id}/projects/{project_id}/ai/connector-chat/column-selection` (SubmitColumnSelection) |
| `mammoth connector ai submit-credentials` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_ai.ConnectorAIAPI.submit_credentials` | `POST /workspaces/{workspace_id}/projects/{project_id}/ai/connector-chat/credentials` (SubmitCredentials) |
| `mammoth connector connection test` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.test_connection` | `PATCH /workspaces/{workspace_id}/projects/{project_id}/connections/{connection_key}/test` (TestConnection) |
| `mammoth connector draft create` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.create` | `POST /workspaces/{workspace_id}/projects/{project_id}/connector-drafts` (CreateConnectorDraft) |
| `mammoth connector draft fill` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.fill` | `POST /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/fill` (FillConnectorDraftGap) |
| `mammoth connector draft open` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.open` | `POST /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/open` (OpenConnectorDraftEntry) |
| `mammoth connector draft read-tables` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.read_tables` | `POST /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/read-tables` (ReadConnectorDraftTables) |
| `mammoth connector draft sample` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.sample` | `POST /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/sample` (ShapeConnectorDraftFromSample) |
| `mammoth connector draft save` | `workspace` | Benign mutation | `none` | — | `always_wait` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.save` | `POST /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/save` (StartConnectorDraftSave) |
| `mammoth connector draft source preview` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.preview_source` | `POST /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/sources/{source_id}/preview` (PreviewConnectorDraftSource) |
| `mammoth connector draft update` | `workspace` | Benign mutation | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.update` | `PATCH /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}` (PatchConnectorDraft) |

## Read

| Command | Scope | Blast radius | Confirmation | Off a terminal | Wait | Pagination | SDK symbol | API operation |
|---|---|---|---|---|---|---|---|---|
| `mammoth connector active` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.connectors.ConnectorsAPI.active_connectors` | `GET /workspaces/{workspace_id}/active_connectors` (GetActiveConnectors) |
| `mammoth connector ai history` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connector_ai.ConnectorAIAPI.history` | `GET /workspaces/{workspace_id}/projects/{project_id}/ai/connector-chat/history` (GetChatHistory) |
| `mammoth connector ai session list` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.connector_ai.ConnectorAIAPI.session_list` | `GET /workspaces/{workspace_id}/projects/{project_id}/ai/connector-chat/sessions` (ListSessions) |
| `mammoth connector ai session messages` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connector_ai.ConnectorAIAPI.session_messages` | `GET /workspaces/{workspace_id}/projects/{project_id}/ai/connector-chat/sessions/{session_id}/messages` (GetSessionMessages) |
| `mammoth connector connection get` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.get_connection` | `GET /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}` (GetConnection) |
| `mammoth connector connection list` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.connectors.ConnectorsAPI.list_connections` | `GET /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections` (ListConnections) |
| `mammoth connector connection list-all` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.connectors.ConnectorsAPI.list_all_connections` | `GET /workspaces/{workspace_id}/projects/{project_id}/connections` (ListAllConnections) |
| `mammoth connector connection query` | `workspace` | Read | `none` | — | `not_async` | `single_page` | — | — |
| `mammoth connector draft browse` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.browse` | `GET /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/browse` (BrowseConnectorDraftFolderConnectorDrafts) |
| `mammoth connector draft get` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.get` | `GET /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}` (GetConnectorDraft) |
| `mammoth connector draft known-sources` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.known_sources` | `GET /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/known-sources` (ListConnectorKnownSources) |
| `mammoth connector draft list` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.list` | `GET /workspaces/{workspace_id}/projects/{project_id}/connector-drafts` (ListConnectorDrafts) |
| `mammoth connector draft source join-candidates` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.join_candidates` | `GET /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/sources/{source_id}/join-candidates` (ListConnectorDraftJoinCandidates) |
| `mammoth connector draft source list` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connector_drafts.ConnectorDraftsAPI.sources` | `GET /workspaces/{workspace_id}/projects/{project_id}/connector-drafts/{draft_id}/sources` (ListConnectorDraftSources) |
| `mammoth connector ds-config get` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.get_ds_config` | `GET /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}/ds_configs/{ds_config_key}` (GetDsConfig) |
| `mammoth connector ds-config list` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.connectors.ConnectorsAPI.list_ds_configs` | `GET /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}/ds_configs` (ListDsConfigs) |
| `mammoth connector get` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.connectors.ConnectorsAPI.get` | `GET /workspaces/{workspace_id}/connectors/{connector_key}` (GetConnector) |
| `mammoth connector list` | `workspace` | Read | `none` | — | `not_async` | `single_page` | `mammoth.api.connectors.ConnectorsAPI.list` | `GET /workspaces/{workspace_id}/connectors` (ListWorkspaceConnectors) |
| `mammoth connector query generate` | `workspace` | Read | `none` | — | `always_wait` | `none` | `mammoth.api.ai.AIAPI.query_gen` | `POST /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}/chat` (GetQuerySuggestion) |
| `mammoth connector query status` | `workspace` | Read | `none` | — | `not_async` | `none` | `mammoth.api.ai.AIAPI.status` | `GET /workspaces/{workspace_id}/projects/{project_id}/connectors/{connector_key}/connections/{connection_key}/chat` (GetChatStatus) |

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