mammoth browse
Generated from mammoth-cli 2.4.2, released 2026-11-02:
mammoth schema list,mammoth capability listand the CLI's own--help. Do not edit by hand; runnpm run docs:capabilities.
Browse projects and workspace resources. 9 commands.
Every command also takes the 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 | Get the folder path (root first) down to a folder of the active project. | Read | — |
browse folder | Browse resources inside one folder of the active project. | Read | — |
browse project | Browse the contents of the active project (datasets, folders). | Read | — |
browse resource | Get one resource of the active project: type, then id, as positionals. | Read | — |
browse resources | Browse workspace resources in bulk. | Read | — |
browse root | Browse resources across all workspaces the caller has access to. | Read | — |
browse search | Search resources across every project of the workspace (resources v2). | Read | — |
browse workspace | Browse all resources in the active workspace (projects, datasets, folders). | Read | — |
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.
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: SDKmammoth.api.browse.BrowseAPI.resource_ancestors, APIGET /workspaces/{workspace_id}/projects/{project_id}/resources/ancestors(GetResourceAncestors)
mammoth browse folder
Browse resources inside one folder of the active project.
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: SDKmammoth.api.browse.BrowseAPI.folder_resources, APIGET /workspaces/{workspace_id}/projects/{project_id}/folders/{folder_id}/browse(BrowseFolderFolders)
mammoth browse project
Browse the contents of the active project (datasets, folders).
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: SDKmammoth.api.projects.ProjectsAPI.browse, APIGET /workspaces/{workspace_id}/projects/{project_id}/browse(BrowseProjectProjects)
mammoth browse resource
Get one resource of the active project: type, then id, as positionals.
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: SDKmammoth.api.browse.BrowseAPI.resource_get, APIGET /workspaces/{workspace_id}/projects/{project_id}/resources/{resource_type}/{object_id}(GetResource)
mammoth browse resources
Browse workspace resources in bulk.
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: SDKmammoth.api.browse.BrowseAPI.resources_list, APIGET /workspaces/{workspace_id}/projects/{project_id}/resources(ListResources)
mammoth browse root
Browse resources across all workspaces the caller has access to.
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: SDKmammoth.api.browse.BrowseAPI.root, APIGET /browse(BrowseResources)
mammoth browse search
Search resources across every project of the workspace (resources v2).
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: SDKmammoth.api.browse.BrowseAPI.resources_search, APIGET /workspaces/{workspace_id}/resources(SearchResources)
mammoth browse workspace
Browse all resources in the active workspace (projects, datasets, folders).
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: SDKmammoth.api.browse.BrowseAPI.workspace_resources, APIGET /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).
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: SDKmammoth.api.browse.BrowseAPI.resources_bulk, APIPOST /workspaces/{workspace_id}/projects/{project_id}/resources/bulk(BulkGetResources)