search-consumption-cli

Search the Microsoft Fabric catalog across workspaces using the Catalog Search API.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/paulasilvatech/Fabric-Agentic-SDLC --skill search-consumption-cli-paulasilvatech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: search-consumption-cli
Source: https://github.com/paulasilvatech/Fabric-Agentic-SDLC/tree/main/.github/skills/search-consumption-cli
Command: npx skills add https://github.com/paulasilvatech/Fabric-Agentic-SDLC --skill search-consumption-cli-paulasilvatech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding a Microsoft Fabric item when you don't know which workspace contains it normally requires listing every workspace and filtering items one by one. This Skill performs a single cross-workspace catalog search to locate items by name, description, or workspace name and returns the item and workspace IDs needed for downstream API calls. ## Core Features & Use Cases - Cross-Workspace Item Search: Find items by display name, description, or workspace name using the Fabric Catalog Search API with optional type filters. - Tenant-Wide Type Inventory: List all items of a specific type (e.g., all Lakehouses or Semantic Models) across the tenant using an empty search string with a type filter. - ID Resolution for Downstream Calls: Extract item IDs and workspace IDs from search results to feed into workload-specific consumption skills like sqldw-cli, spark-cli, or eventhouse-cli. - Use Case: A user knows a report is named "Monthly Sales Revenue" but not its workspace. The Skill searches the catalog, disambiguates multiple matches, and returns the report ID and workspace ID for further queries. ## Quick Start Ask the assistant to find a Fabric item by name, for example: "Search the Fabric catalog for a lakehouse named SalesLakehouse and tell me which workspace it is in."

Frequently Asked Questions about search-consumption-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a Microsoft Fabric item when I don't know its workspace?▼

Use the Fabric Catalog Search API with a POST to /v1/catalog/search containing the item name in the search text. The response returns each match's id, type, displayName, and hierarchy.workspace with the workspace id and displayName.

How to list all items of a type across a Fabric tenant?▼

Send an empty search string with a type filter such as "Type eq 'Lakehouse'" and a pageSize up to 1000. If the response includes a continuationToken, pass it in the next request until it returns null.

Can the Fabric Catalog Search API find workspaces by name?▼

No, the Catalog Search API returns items, not workspaces. To find a workspace by name, use GET /v1/workspaces and filter the results instead.

Does Fabric catalog search support Dataflow Gen1 or Gen2 items?▼

No, Dataflow Gen1 and Dataflow Gen2 items are not returned by the Catalog Search API. Use GET /v1/workspaces/{id}/items to enumerate those items within a known workspace.

Why does my Fabric catalog search return an InvalidFilter error?▼

The filter syntax only supports eq, ne, or, and parentheses. Do not mix eq with and, ne with or, or combine eq and ne in the same filter, and keep type values under 500.

Why is a newly created Fabric item not appearing in catalog search results?▼

The catalog index has a variable propagation delay and is not near-real-time, usually taking minutes. Verify the item exists via GET /v1/workspaces/{id}/items while waiting for indexing.