List Workflows

List all workflows in your workspace

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 your workspace's workflows, newest first. Steps are omitted from list responses to keep them light; fetch a single workflow to get its full steps.

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

Query Parameters#

Parameter	Type	Required	Description
`status`	String	No	Filter by status: `draft`, `active`, `paused` or `archived`
`limit`	Integer	No	Results per page, 1 to 200. Defaults to 50
`offset`	Integer	No	Number of results to skip. Defaults to 0

Request#

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

Error Responses#

Enterprise Access Required (403)#

{
  "error": "Access Forbidden: Enterprise API feature 'workflows' is not enabled for your plan. Contact hi@orshot.com for Enterprise access",
  "code": "enterprise_required"
}

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