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

# mammoth browse

> All 9 mammoth browse commands with examples, arguments and confirmation flags: Browse projects and workspace resources.

> Generated from mammoth-cli 2.4.2, released 2026-11-02: `mammoth schema list`, `mammoth capability list` and the CLI's own `--help`. Do not edit by hand; run `npm run docs:capabilities`.

Browse projects and workspace resources. 9 commands.

Every command also takes the [global flags](https://mammoth.io/docs/build/cli/global-flags/) (`--output`, `--yes`, `--confirm`, `--dry-run`, `--input`, `--profile`, ...), which are not repeated below. `--input` takes a JSON or YAML document of the input fields; `mammoth schema get COMMAND_ID` prints a command's full input schema.

**Confirmation.** Commands marked `--yes --confirm TARGET` or `--yes` always need those flags, even at a terminal: they never prompt. Commands marked "`--yes` or prompt" ask at an interactive terminal (table output, no `--no-input`) and otherwise need `--yes`. `--dry-run` skips confirmation and sends nothing.

## Summary

| Command | What it does | Effect | Confirmation |
|---|---|---|---|
| [`browse ancestors`](#mammoth-browse-ancestors) | Get the folder path (root first) down to a folder of the active project. | Read | — |
| [`browse folder`](#mammoth-browse-folder) | Browse resources inside one folder of the active project. | Read | — |
| [`browse project`](#mammoth-browse-project) | Browse the contents of the active project (datasets, folders). | Read | — |
| [`browse resource`](#mammoth-browse-resource) | Get one resource of the active project: type, then id, as positionals. | Read | — |
| [`browse resources`](#mammoth-browse-resources) | Browse workspace resources in bulk. | Read | — |
| [`browse root`](#mammoth-browse-root) | Browse resources across all workspaces the caller has access to. | Read | — |
| [`browse search`](#mammoth-browse-search) | Search resources across every project of the workspace (resources v2). | Read | — |
| [`browse workspace`](#mammoth-browse-workspace) | Browse all resources in the active workspace (projects, datasets, folders). | Read | — |
| [`browse resources bulk`](#mammoth-browse-resources-bulk) | Get many resources of the active project by type and id in one go (resources v2). | Read | — |

## browse commands

### mammoth browse ancestors

Get the folder path (root first) down to a folder of the active project.

```bash
mammoth browse ancestors 123
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `RESOURCE_ID` | positional | yes | — | `int` | The folder's id, as folder list and browse return it. |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** The folder path (breadcrumb) of a FOLDER of the active project: the chain from the project root down to the folder itself, root first (resources v2). Pass the folder's resource_id from browse resources, not its object id. Any other id answers 404; 0 means the project root and returns an empty path. For a dataset or view, take its parent_resource_id first.
- **Id:** `browse.ancestors` · **Result:** `BrowseAncestorsResult` · **Backed by:** SDK `mammoth.api.browse.BrowseAPI.resource_ancestors`, API `GET /workspaces/{workspace_id}/projects/{project_id}/resources/ancestors` (GetResourceAncestors)

### mammoth browse folder

Browse resources inside one folder of the active project.

```bash
mammoth browse folder 123
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `FOLDER_ID` | positional | yes | — | `int` | ID of the folder. |
| `level` | `--input` field | no | `2` | `int` |  |
| `fields` | `--input` field | no | `__min` | `str` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none · **Pages:** `single_page`
- **Preconditions:** Validate level and add continuation only if proven.
- **Id:** `browse.folder` · **Result:** `BrowseFolderResult` · **Backed by:** SDK `mammoth.api.browse.BrowseAPI.folder_resources`, API `GET /workspaces/{workspace_id}/projects/{project_id}/folders/{folder_id}/browse` (BrowseFolderFolders)

### mammoth browse project

Browse the contents of the active project (datasets, folders).

```bash
mammoth browse project
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `fields` | `--input` field | no | — | `str` |  |
| `name` | `--input` field | no | — | `str` |  |
| `browse_type` | `--input` field | no | — | `str` |  |
| `sort` | `--input` field | no | — | `str` |  |
| `offset` | `--input` field | no | — | `int` |  |
| `limit` | `--input` field | no | — | `int` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none · **Pages:** `offset`
- **Preconditions:** Some servers answer this with HTTP 500; that is a server error, not server_unavailable.
- **Id:** `browse.project` · **Result:** `BrowseProjectResult` · **Backed by:** SDK `mammoth.api.projects.ProjectsAPI.browse`, API `GET /workspaces/{workspace_id}/projects/{project_id}/browse` (BrowseProjectProjects)

### mammoth browse resource

Get one resource of the active project: type, then id, as positionals.

```bash
mammoth browse resource dataset 123
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `RESOURCE_TYPE` | positional | yes | — | `str` | Resource type, for example dataset or dataview. |
| `OBJECT_ID` | positional | yes | — | `int` | ID of the resource within its type. |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** One resource of the project with its full properties (resources v2); name the type, then the id.
- **Id:** `browse.resource` · **Result:** `BrowseResourceResult` · **Backed by:** SDK `mammoth.api.browse.BrowseAPI.resource_get`, API `GET /workspaces/{workspace_id}/projects/{project_id}/resources/{resource_type}/{object_id}` (GetResource)

### mammoth browse resources

Browse workspace resources in bulk.

```bash
mammoth browse resources
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `parent_type` | `--input` field | no | — | `str` |  |
| `parent_id` | `--input` field | no | — | `int` |  |
| `resource_type` | `--input` field | no | — | `str` |  |
| `search` | `--input` field | no | — | `str` |  |
| `cursor` | `--input` field | no | — | `str` |  |
| `limit` | `--input` field | no | — | `int` |  |
| `sort` | `--input` field | no | — | `str` |  |
| `fields` | `--input` field | no | — | `str` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none · **Pages:** `cursor`
- **Preconditions:** One project's resources a cursor page at a time (resources v2): pass next_cursor back as cursor while has_more is true. Optional parent_type and parent_id list inside a folder; resource_type, search, sort and fields narrow the page.
- **Id:** `browse.resources` · **Result:** `BrowseResourcesResult` · **Backed by:** SDK `mammoth.api.browse.BrowseAPI.resources_list`, API `GET /workspaces/{workspace_id}/projects/{project_id}/resources` (ListResources)

### mammoth browse root

Browse resources across all workspaces the caller has access to.

```bash
mammoth browse root
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `fields` | `--input` field | no | — | `str` |  |
| `name` | `--input` field | no | — | `str` |  |
| `browse_type` | `--input` field | no | — | `str` |  |
| `created_at` | `--input` field | no | — | `str` |  |
| `updated_at` | `--input` field | no | — | `str` |  |
| `sort` | `--input` field | no | — | `str` |  |
| `offset` | `--input` field | no | — | `int` |  |
| `limit` | `--input` field | no | — | `int` |  |
| `ids` | `--input` field | no | — | `str` |  |
| `include_hidden` | `--input` field | no | — | `bool` |  |
| `level` | `--input` field | no | — | `int` |  |
| `permissions` | `--input` field | no | — | `str` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Id:** `browse.root` · **Result:** `BrowseRootResult` · **Backed by:** SDK `mammoth.api.browse.BrowseAPI.root`, API `GET /browse` (BrowseResources)

### mammoth browse search

Search resources across every project of the workspace (resources v2).

```bash
mammoth browse search
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `search` | `--input` field | no | — | `str` |  |
| `resource_type` | `--input` field | no | — | `str` |  |
| `cursor` | `--input` field | no | — | `str` |  |
| `limit` | `--input` field | no | — | `int` |  |
| `sort` | `--input` field | no | — | `str` |  |
| `fields` | `--input` field | no | — | `str` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none · **Pages:** `cursor`
- **Preconditions:** Searches resources across every project you can open in the workspace (resources v2), a cursor page at a time: pass next_cursor back as cursor while has_more is true. search matches names; resource_type (comma-separated), sort and fields narrow the page. Needs no active project. Each dataset hit carries dataset_id (its object_id) and each view hit view_id: pass those, never the tree id.
- **Id:** `browse.search` · **Result:** `BrowseSearchResult` · **Backed by:** SDK `mammoth.api.browse.BrowseAPI.resources_search`, API `GET /workspaces/{workspace_id}/resources` (SearchResources)

### mammoth browse workspace

Browse all resources in the active workspace (projects, datasets, folders).

```bash
mammoth browse workspace
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `level` | `--input` field | no | `2` | `int` |  |
| `fields` | `--input` field | no | `__min` | `str` |  |
| `limit` | `--input` field | no | `100` | `int` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none · **Pages:** `single_page`
- **Preconditions:** Validate level against the OpenAPI enum and report truncation.
- **Id:** `browse.workspace` · **Result:** `BrowseWorkspaceResult` · **Backed by:** SDK `mammoth.api.browse.BrowseAPI.workspace_resources`, API `GET /workspaces/{workspace_id}/browse` (BrowseWorkspaceWorkspaces)

## browse resources

### mammoth browse resources bulk

Get many resources of the active project by type and id in one go (resources v2).

```bash
mammoth browse resources bulk --input '{"items": [["dataview", 42]]}'
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `items` | `--input` field | yes | — | `list[tuple[str, int]]` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none
- **Preconditions:** Gets many resources of the active project by type and id in one request (resources v2; 100 pairs per request, more are chunked). Pass items in --input as \[type, id\] pairs, for example \[\["dataview", 42\]\]. A pair that does not exist in the project, or that you cannot read, is left out of the answer.
- **Id:** `browse.resources.bulk` · **Result:** `BrowseResourcesBulkResult` · **Backed by:** SDK `mammoth.api.browse.BrowseAPI.resources_bulk`, API `POST /workspaces/{workspace_id}/projects/{project_id}/resources/bulk` (BulkGetResources)

---
Source: https://mammoth.io/docs/build/cli/browse.md · Updated: 2026-11-02
