Get a workflow — Era documentation

GEThttps://app.getera.io/api/v1/workflows/{id}

API key

Use it to find out which inputs a workflow expects before running it. The inputs list is the fields defined in the workflow's start block; send values under those names in the Run a workflow body.

Authentication

An API key in the x-api-key header. The workflow must be in a workspace the key's owner can reach.

Path parameter

Name	Type	Required	Description
`id`	string	Yes	The workflow's id.

Example

curl https://app.getera.io/api/v1/workflows/wf_demo123 \
  -H "x-api-key: ERA_API_KEY"

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",
    "variables": {},
    "inputs": [
      { "name": "customerName", "type": "string" },
      { "name": "amount", "type": "number" }
    ],
    "createdAt": "2026-09-20T10:00:00.000Z",
    "updatedAt": "2026-10-01T08:00:00.000Z"
  },
  "limits": { "workflowExecutionRateLimit": { "sync": {}, "async": {} }, "usage": {} }
}

For the full shape of limits, see List workflows.

Errors

Status	When
`401`	Missing or invalid key.
`404`	No such workflow, or not in a workspace you can reach: `{"error": "Workflow not found"}`.
`429`	Rate limit.
`500`	Server error.