---
title: "Get Component Usage Flows"
method: GET
path: "/api/v1/catalog-policy/usage/flows"
tags: ["Catalog Policy"]
---

# Get Component Usage Flows

`GET /api/v1/catalog-policy/usage/flows`

Return the flows that would be affected by blocking one component key.

A flow matches when the queried key and any of the flow's stored keys
resolve to a shared canonical identity — the same matching rule flow
writes and runs enforce. Flows are sorted by name, then id, and truncated
to ``limit``; ``total`` always reports the full match count. Results may
lag flow writes by up to ``USAGE_SCAN_CACHE_TTL_SECONDS``.

## Query parameters

- `component` string, required — Component key to look up; aliases resolve like catalog enforcement.
- `limit` integer

## Response `200`

Successful Response

- CatalogPolicyUsageFlowsRead — Flows affected by blocking one component key.
  - `component` string, required
  - `flows` CatalogPolicyUsageFlowRef[], required
    - `id` string, uuid, required
    - `name` string, required
  - `total` integer, required — Total number of matching flows, before the limit is applied.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-01** `088c1fc24528` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v1/catalog-policy/usage/flows/get.md)

---

[API](https://skmtc.dev/langflow-ai/apis/langflow.md) · [All operations](https://skmtc.dev/langflow-ai/apis/langflow/llms.txt) · [OpenAPI document](https://skmtc.dev/langflow-ai/apis/langflow/revisions/088c1fc24528?raw)