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 · complete manifest

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

{
  "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

{
  "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"
}