> For the complete documentation index, see [llms.txt](https://docs.pletor.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pletor.ai/documentation/api-reference/flows.md). # Flows Flows represent specific AI-powered capabilities — on-brand photo generation, UGC video generation, static ads generation, and more. Use these endpoints to discover available flows and inspect their required inputs and expected outputs. Flows are always described at their last saved version; Studio autosave drafts are never exposed here. Discover flows and inspect their input requirements and output types. ## List Flows > List available flows with filtering options.\ > \ > This endpoint returns a paginated list of flows that can generate various types of\ > content including images, videos, text, and other creative assets.\ > \ > Each flow is described at its last saved version. A flow that has never been\ > saved in Studio — autosave keeps it as a private draft — is still listed, but\ > with an empty \`inputs\` array and an \`estimated\_cost\` of \`0\`; it cannot be\ > fetched or run until someone saves it. Treat an empty \`inputs\` as "not saved\ > yet", not as "takes no input".\ > \ > \*\*Filtering Options:\*\*\ > \- \`tags\`: Only flows carrying every given tag slug, case-insensitive (can be\ > provided multiple times; all must match)\ > \- \`visibility\`: Only flows with one of these visibilities (can be provided\ > multiple times). Values are lowercase:\ > \- \`private\`: your organization's flows, visible only inside it\ > \- \`shared\`: your organization's flows shared by link\ > \- \`public\`: flows published to everyone, from any organization,\ > including Pletor's catalog\ > By default, only \`private\` and \`shared\` flows are returned.\ > \- \`search\`: Case- and accent-insensitive substring match on the flow name\ > \ > \*\*Pagination Parameters:\*\*\ > \- \`limit\`: Maximum number of items to return (default: 20, min: 1, max: 100)\ > \- \`cursor\`: \`next\_cursor\` from the previous page (optional)\ > \ > \*\*Response:\*\*\ > \- \`data\`: List of flow summaries with basic information including expected inputs\ > \- \`has\_more\`: Indicates if there are more results available\ > \- \`next\_cursor\`: Cursor for the next page of results; \`null\` on the last page\ > \ > \*\*Error Codes:\*\*\ > \- \`422\`: A parameter is out of range or not a valid value (e.g. an unknown\ > \`visibility\`)\ > \ > \*\*Use Case:\*\* This is typically the first endpoint called to discover available flows\ > before getting detailed information or executing them. ```json {"openapi":"3.1.0","info":{"title":"Pletor - Public API","version":"2.0.0"},"tags":[{"name":"flows","description":"Discover flows and inspect their input requirements and output types."}],"servers":[{"url":"/api/public"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"API key for authentication"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Cognito JWT Bearer token"}},"schemas":{"FlowVisibility":{"type":"string","enum":["public","private"],"title":"FlowVisibility","description":"Visibility levels for workflows."},"CursorPaginatedResponse_FlowSummary_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/FlowSummary"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data","has_more"],"title":"CursorPaginatedResponse[FlowSummary]"},"FlowSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique flow identifier"},"name":{"type":"string","title":"Name","description":"Flow display name"},"description":{"type":"string","title":"Description","description":"Flow description and purpose; empty when none is set"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"Tag slugs; filter on them with `tags` on `GET /flows/`"},"estimated_cost":{"type":"integer","title":"Estimated Cost","description":"Estimated credit cost per execution; `0` when not estimated or never saved"},"visibility":{"$ref":"#/components/schemas/FlowVisibility","description":"Visibility level: `private`, `shared`, or `public`"},"inputs":{"items":{"$ref":"#/components/schemas/FlowInput"},"type":"array","title":"Inputs","description":"All inputs for this flow; check the `required` flag on each to determine which are mandatory. Empty for a flow that was never saved"},"has_human_review":{"type":"boolean","title":"Has Human Review","description":"True when this flow includes a human review step that will pause execution until resolved via POST /runs/{run_id}/reviews/{review_id}. Poll GET /runs/{run_id} for `awaiting_human_review` while the run is in progress.","default":false}},"type":"object","required":["id","name","description","estimated_cost","visibility"],"title":"FlowSummary","description":"Lightweight flow summary for list views."},"FlowInput":{"properties":{"id":{"type":"string","title":"Id","description":"Node ID to use as `id` when providing this input"},"type":{"$ref":"#/components/schemas/NodeType","description":"Input type: `text_input` (text), or `image_input`, `video_input`, `audio_input` or `file_input` (uploaded asset IDs)"},"description":{"type":"string","title":"Description","description":"Generated from the input's label in Studio, as `Input for