# catalog_list Browse one deterministic level of the authorized LeapView catalog hierarchy. Omit parent to list workspaces, then pass returned refs to continue browsing. Machine-readable: [focused JSON](/docs/agent-tools/tools/catalog_list.json) · [complete manifest](/docs/agent-tools/manifest.json) ## Contract | Property | Value | | --- | --- | | Required privilege | `VIEW_ITEM` | | Effect | `read` | | Operation | `manual` | | Tags | `catalog`, `browse` | | Defaults | `{"limit":25}` | | MCP annotations | read-only, idempotent, non-destructive, closed-world | ## Input schema ```json { "additionalProperties": false, "properties": { "childTypes": { "items": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "type": "array" }, "cursor": { "type": "string" }, "limit": { "maximum": 50, "minimum": 1, "type": "integer" }, "parent": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "type": "object" } ``` ## Output schema ```json { "additionalProperties": false, "properties": { "count": { "minimum": 0, "type": "integer" }, "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": false, "properties": { "capabilities": { "items": { "enum": [ "catalog_get", "catalog_list", "query_semantic_model", "query_dashboard_visual", "query_visual" ], "type": "string" }, "type": "array" }, "description": { "type": "string" }, "hierarchy": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "name", "ref" ], "type": "object" }, "type": "array" }, "href": { "type": "string" }, "locations": { "items": { "additionalProperties": false, "properties": { "dashboardId": { "minLength": 1, "type": "string" }, "dashboardName": { "type": "string" }, "href": { "type": "string" }, "pageId": { "minLength": 1, "type": "string" }, "pageName": { "type": "string" } }, "required": [ "dashboardId", "pageId" ], "type": "object" }, "type": "array" }, "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" }, "workspace": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "ref": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "type": { "enum": [ "workspace", "dashboard", "page", "visual", "filter", "semantic_model", "semantic_table", "field", "measure" ], "type": "string" }, "workspaceId": { "minLength": 1, "type": "string" } }, "required": [ "id", "type", "workspaceId" ], "type": "object" } }, "required": [ "name", "ref" ], "type": "object" } }, "required": [ "capabilities", "hierarchy", "name", "ref", "workspace" ], "type": "object" }, "type": "array" }, "nextCursor": { "type": "string" } }, "required": [ "count", "hasMore", "items" ], "type": "object" } ```