List Workflow Runs

List recent runs of a workflow with their results

Enterprise Only

The Workflows API is available only to first party clients like the Orshot MCP server and workspaces on the Enterprise plan. Checkout the Enterprise Pricing to get access.

Overview#

Returns a workflow's recent runs, newest first, with row counts and credits used per run.

https://api.orshot.com/v1/workflows/:id/runs

Path Parameters#

Parameter	Type	Required	Description
`id`	Integer	Yes	The unique ID of the workflow

Query Parameters#

Parameter	Type	Required	Description
`limit`	Integer	No	Results to return, 1 to 100. Defaults to 20

Request#

await fetch("https://api.orshot.com/v1/workflows/44/runs?limit=10", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Run Statuses#

Status	Meaning
`queued`	Waiting to be picked up
`running`	Currently executing
`success`	Every row succeeded
`partial`	Some rows succeeded, some failed
`failed`	The run produced nothing
`skipped`	Nothing to do (for example, an empty poll)
`cancelled`	The run was cancelled before finishing

Error Responses#

Workflow Not Found (404)#

{
  "error": "Not found"
}

Rate Limits#

60 requests per minute per workspace

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key

Image, PDF and video generation via API
Visual editor with AI and smart layouts
Zapier, Make, MCP and 50+ integrations
White-label embed for your own app
30 free credits — no credit card required