workflows-list

Zapier Workflows List

Use the public SDK CLI experimental command surface. Do not use zapier-sdk-code-substrate.

Compatibility Gate

Before using this skill, run the workflows-doctor bundle compatibility check. If workflows-doctor is not installed or cannot be loaded, run workflows-install or install workflows-doctor from zapier/agent-skills before continuing. If workflows-doctor reports SDK/skill drift, follow its refresh instructions, stop this skill invocation, reload the agent workspace if needed, and ask the user to rerun the original request.

Check Prerequisites

zapier-sdk --version
zapier-sdk get-profile --json
zapier-sdk --experimental --help

If auth fails, ask the user to run zapier-sdk login in an interactive terminal and retry.

List Workflows

zapier-sdk --experimental list-workflows --json

Parse the JSON output and format what the user asked for. Common useful fields may include id, name, enabled, is_private, created_by_user_id, created_at, updated_at, description, current_version, and trigger-related metadata if present.

For each workflow with an id, include the Zapier editor link:

https://zapier.com/durables-editor/<workflow-id>

Treat trigger_url as sensitive because it contains a secret token. Do not print trigger_url unless the user explicitly asks for it.

Ownership Scoping

list-workflows may return every workflow the authenticated user can see, including team workflows. If the user asks for "my workflows," first show the likely matches and explain any uncertainty rather than silently filtering by the wrong ID.

Known quirk: zapier-sdk get-profile may return a UUID that does not match list-workflows[].created_by_user_id, which may be a separate numeric user ID. If you cannot confidently map those IDs, say so and present the unfiltered list with enough context for the user to choose.

Last Run Time

If the user asks for recent activity, fetch runs for each relevant workflow:

zapier-sdk --experimental list-workflow-runs <workflow-id> --json

Use the most recent run. Be mindful of API volume for large accounts.