Create a Prefect Cloud flow run from a deployment via REST API

domain: docs.prefect.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Generate a Prefect Cloud API key from your Prefect Cloud account settings.
  2. Identify your account ID, workspace ID, and the deployment ID you want to trigger.
  3. POST to https://api.prefect.cloud/api/accounts/YOUR_ACCOUNT_ID/workspaces/YOUR_WORKSPACE_ID/deployments/YOUR_DEPLOYMENT_ID/create_flow_run with Authorization: Bearer YOUR_API_KEY and Content-Type application/json.
  4. Optionally include a JSON body with parameters, state, or tags to customize the run.
  5. Capture the id field from the response — this is the flow run ID.
  6. Poll GET /flow_runs/YOUR_FLOW_RUN_ID on the same base URL to monitor state transitions until the run reaches a terminal state.

Known gotchas

Related routes

Create a Prefect 3 work pool and deploy a flow for infrastructure-agnostic remote execution
docs.prefect.io · 5 steps · unrated
Deploy an application to Coolify via its REST API
coolify.io · 5 steps · unrated
Trigger Airflow DAG run via stable REST API
airflow.apache.org · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans