Skip to main content
GET
List workflows

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app whose workflows you want to work with.

Query Parameters

include_archived
boolean
default:false

Include archived workflows in the results.

limit
integer
default:30

Most workflows to return.

Required range: 1 <= x <= 200
offset
integer
default:0

How many workflows to skip, for paging.

Required range: x >= 0
file_keys
string[] | null

Look workflows up by their file name instead of paging. Repeat the parameter for several. At most 50, each at most 256 characters and free of path separators.

Response

The app's workflows.

id
string
required

ID of the workflow.

Example:

"68b1c0d4e7b91d003c45a1f2"

app_id
string
required

ID of the app the workflow belongs to.

Example:

"6820f3a4e7b91d003c45a1f2"

name
string
required

Name of the workflow.

Example:

"Email me new signups"

status
string
required

Whether the workflow runs: active, inactive, or archived. See Workflow status for what each means and how it changes.

Example:

"active"

social_post
WorkflowSocialPost · object | null

Current post content for a social publishing workflow, or null when no linked post is available.

file_key
string | null

Name of the workflow's file in the app's code.

Example:

"email-me-new-signups"

description
string | null

What the workflow is for.

Example:

"Sends an email whenever a User record is created."

status_reason
string | null

Why Base44 changed the workflow's status on its own, as one of consecutive_failures, end_condition_reached, migration_activation_failed, or workflows_not_available. This is null when you changed the status yourself. See Workflow status for what each code means.

Example:

"consecutive_failures"

trigger
Trigger · object

What starts the workflow. The trigger sits under config, keyed by trigger_type.

Example:
total_runs
integer
default:0

Runs the workflow has started, ever.

Example:

48

consecutive_failures
integer
default:0

Runs that have failed in a row.

Example:

0

last_run_at
string<date-time> | null

When the workflow last started running, as an ISO 8601 UTC timestamp. This is null before its first run.

Example:

"2026-08-25T09:12:44Z"

last_run_status
string | null

How the workflow's most recent run ended: success, failed, or cancelled. This is null before the first run. See Workflow status for how this compares to a run's own status.

Example:

"success"

created_date
string<date-time> | null

When the workflow was created, as an ISO 8601 UTC timestamp.

Example:

"2026-07-02T11:04:00Z"