Run logs — Era documentation

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

API key

Lists when your workflows ran, what triggered them, how long they took and what they cost. Useful for feeding your own monitoring or reporting tool.

Authentication

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

Query parameters

Name	Type	Required	Description
`workspaceId`	string	Yes	The workspace's id.
`workflowIds`	string	No	Comma-separated workflow ids.
`folderIds`	string	No	Comma-separated folder ids.
`triggers`	string	No	Comma-separated triggers: `manual`, `api`, `schedule`, `chat`, `webhook`, `mcp`, `a2a`.
`level`	string	No	`info` or `error`.
`startDate`, `endDate`	date	No	ISO 8601 range.
`executionId`	string	No	One run.
`minDurationMs`, `maxDurationMs`	number	No	Duration range (milliseconds).
`minCost`, `maxCost`	number	No	Cost range.
`model`	string	No	By the AI model used.
`details`	string	No	`basic` (default) or `full`. `full` adds a workflow summary and the cost breakdown.
`includeFinalOutput`	boolean	No	With `details=full`, adds the final output.
`includeTraceSpans`	boolean	No	With `details=full`, adds step-by-step traces.
`limit`	number	No	Default 100.
`cursor`	string	No	The `nextCursor` from the previous response.
`order`	string	No	`desc` (default, newest first) or `asc`.

Example

curl -G https://app.getera.io/api/v1/logs \
  -H "x-api-key: ERA_API_KEY" \
  --data-urlencode "workspaceId=WORKSPACE_ID" \
  --data-urlencode "level=error" \
  --data-urlencode "limit=20"

Response

{
  "data": [
    {
      "id": "log_91ab",
      "workflowId": "wf_demo123",
      "executionId": "5d7e2a10-0000-4000-8000-000000000020",
      "deploymentVersionId": "dep_3",
      "level": "error",
      "trigger": "api",
      "startedAt": "2026-10-14T09:30:00.000Z",
      "endedAt": "2026-10-14T09:30:02.140Z",
      "totalDurationMs": 2140,
      "cost": { "total": 0.0042 },
      "files": null
    }
  ],
  "nextCursor": "eyJzdGFydGVkQXQiOiIuLi4ifQ==",
  "limits": { "workflowExecutionRateLimit": { "sync": {}, "async": {} }, "usage": {} }
}

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.

For one log in detail, see Log detail.