Skip to main content
GET
/
workflows
List user workflows
curl --request GET \
  --url https://api.fal.ai/v1/workflows \
  --header 'Authorization: <api-key>'
{
  "workflows": [
    {
      "name": "my-image-workflow",
      "title": "My Image Generation Workflow",
      "user_nickname": "johndoe",
      "created_at": "2025-01-15T12:00:00Z",
      "thumbnail_url": "https://fal.media/files/example.jpg",
      "description": "A workflow for generating images",
      "tags": [
        "image",
        "generation"
      ],
      "endpoint_ids": [
        "fal-ai/flux/dev"
      ]
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "total": 1
}

Authorizations

​
Authorization
string
header
required

API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_API_KEY

Query Parameters

​
limit
integer

Maximum number of items to return. Actual maximum depends on query type and expansion parameters.

Required range: x >= 1
Example:

50

​
cursor
string

Pagination cursor from previous response. Encodes the page number.

Example:

"Mg=="

​
search
string

Search by workflow name or title

Example:

"image generation"

​
used_endpoint_ids

Filter by model endpoint IDs used in the workflow. Can be a single value or comma-separated values.

Example:
["fal-ai/flux/dev"]

Response

Successfully retrieved workflows

Response containing workflow data with pagination support

​
workflows
object[]
required

Array of workflow items

Example:
[
  {
    "name": "my-image-workflow",
    "title": "My Image Generation Workflow",
    "user_nickname": "johndoe",
    "created_at": "2024-01-15T10:30:00Z",
    "thumbnail_url": "https://fal.ai/workflows/thumb_abc123.png",
    "description": "Generate high-quality images using FLUX model",
    "tags": ["image-generation", "ai", "flux"],
    "endpoint_ids": ["fal-ai/flux/dev", "fal-ai/face-swap"]
  }
]
​
next_cursor
string | null
required

Cursor for the next page of results, null if no more pages

Example:

"eyJvZmZzZXQiOjEwfQ=="

​
has_more
boolean
required

Whether more results are available

Example:

true

​
total
integer

Total number of workflows matching the query

Example:

42