List workflows — Era documentation

GEThttps://app.getera.io/api/v1/workflows

API key

Returns the workspace's workflows in their order. The response also has a limits field with your usage and rate limits.

Authentication

An API key in the x-api-key header. The key's owner must have access to the workspace. See Authentication.

Query parameters

Name	Type	Required	Description
`workspaceId`	string	Yes	The workspace's id. It is in the workflow editor's address: `/workspace/<workspaceId>/workflows/...`.
`folderId`	string	No	Only workflows in this folder.
`deployedOnly`	boolean	No	When `true`, only deployed workflows. Default `false`.
`limit`	number	No	1–100, default 50.
`cursor`	string	No	The `nextCursor` from the previous response.

Example

curl -G https://app.getera.io/api/v1/workflows \
  -H "x-api-key: ERA_API_KEY" \
  --data-urlencode "workspaceId=WORKSPACE_ID" \
  --data-urlencode "deployedOnly=true"

Response

{
  "data": [
    {
      "id": "wf_demo123",
      "name": "Prepare a quote",
      "description": "Drafts a quote for a new lead.",
      "color": "#3972F6",
      "folderId": null,
      "workspaceId": "WORKSPACE_ID",
      "isDeployed": true,
      "deployedAt": "2026-10-01T08:00:00.000Z",
      "runCount": 42,
      "lastRunAt": "2026-10-14T09:30:00.000Z",
      "createdAt": "2026-09-20T10:00:00.000Z",
      "updatedAt": "2026-10-01T08:00:00.000Z"
    }
  ],
  "nextCursor": "eyJzb3J0T3JkZXIiOjEsLi4ufQ==",
  "limits": {
    "workflowExecutionRateLimit": {
      "sync": { "requestsPerMinute": 60, "maxBurst": 120, "remaining": 59, "resetAt": "2026-10-14T09:31:00.000Z" },
      "async": { "requestsPerMinute": 200, "maxBurst": 400, "remaining": 200, "resetAt": "2026-10-14T09:31:00.000Z" }
    },
    "usage": { "currentPeriodCost": 3.2, "limit": 20, "plan": "free", "isExceeded": false }
  }
}

The numbers in limits are examples; yours follow your subscription. With no next page, nextCursor is left out.

Errors

Status	When
`400`	Invalid parameters: `{"error": "Invalid parameters", "details": [...]}`.
`401`	Missing or invalid key.
`403`	No access to the workspace: `{"error": "Access denied"}`.
`429`	Rate limit.
`500`	Server error.