Workflow Developer API

List Developer Workflow Versions

List immutable published versions and draft metadata for one workflow.

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

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

page

integerquery

Default: 1

limit

integerquery

Default: 20

Responses

200Successful Response

WorkflowVersionListResponse

versionsarray<WorkflowVersionSummaryResponse>

paginationobject<string, any>

422Validation Error

HTTPValidationError

detailarray<ValidationError>

Request example

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

Response example

{
  "versions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "version_number": 1,
      "status": "open",
      "description": "string",
      "published_by": "string",
      "published_at": "2026-08-05T14:30:00Z",
      "created_by": "string"
    }
  ],
  "pagination": {
    "example_key": "string"
  }
}

View OpenAPI document