Workflow Developer API

List Workflow Runs Safe

Return run navigation metadata without trigger or node-result values.

GET/developer/v1/workflows/{definition_id}/runs

Authorizations

Authorization

stringheaderrequired

Send your GenHealth credential as Bearer <YOUR_API_KEY>. This endpoint requires workflow:read for the authenticated organization.

Headers

Accept

stringheader

Response media type. Use application/json for the current API.

Parameters

definition_idrequired

stringpath

status

string | nullquery

limit

integerquery

Default: 10

since

string | nullquery

until

string | nullquery

Responses

200Successful Response

WorkflowRunsIndexResponse

definition_idstring | null

errorstring | null

error_categorystring | null

retryableboolean | null

returnedinteger | null

runsarray<object<string, any>>

successboolean

totalinteger | null

422Validation Error

HTTPValidationError

detailarray<ValidationError>

Request example

curl --request GET \
  --url 'https://api.umpa.genhealth.ai/developer/v1/workflows/{definition_id}/runs?limit=10' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Accept: application/json'

Response example

{
  "definition_id": "string",
  "error": "string",
  "error_category": "string",
  "retryable": true,
  "returned": 1,
  "runs": [
    {
      "example_key": "string"
    }
  ],
  "success": true,
  "total": 1
}

View OpenAPI document