Skip to documentation
Workflow developer API

GenHealth Workflow Developer API

Create, version, audit, publish, run, and maintain UMPA workflows directly against the core ETL API. The capability and action-discovery operations are optimized for AI agents.

View as Markdown

Build workflow automations

Discover supported integrations and actions, validate canonical workflow JSON, manage drafts and immutable versions, inspect graphs, publish viable workflows, and operate organization-scoped workflow runs.

Workflow runs, integrations, and events

These terms describe what starts a workflow, how it works with other systems, and how its step attempts are modeled.

Workflow run
One run begins each time a workflow is triggered—by a person, schedule, API request, file upload, or webhook—and ends when it completes, fails, or is canceled. Branches, waits, loops, and step retries remain part of that run; a child workflow starts a separate run.
Integration
An integration connects a workflow to another system or exposes a GenHealth capability. It provides actions—tools such as finding a record, extracting data, or sending an update—that can be used as workflow steps. Some integrations require a configured connection or credentials.Browse available integrations and actions
Modeled internal event
A planning unit for work performed inside a run. In the historical benchmark, each event represents one successful or failed attempt to execute a workflow step, after replay duplicates are removed. Loops and retries can add events; an event does not map one-to-one to a visible block, tool call, or external request.

Contract summary

PropertyValue
OpenAPI3.1.0
API version1.0.0
Operations36
Component schemas59
AuthenticationHTTP bearer token with operation-specific workflow scopes

Organization isolation

Workflow definitions, versions, graphs, webhook endpoints, and runs are resolved within the organization carried by the authenticated credential. An identifier from another organization does not grant access.

Operations

Workflow Developer API

GETGet Workflow Capabilities/developer/v1/capabilitiesGETSearch Workflow Actions/developer/v1/actionsGETList Workflow Integrations/developer/v1/integrationsGETList Workflow Integration Connections/developer/v1/integration-connectionsGETGet Workflow Action/developer/v1/actions/{handler}GETList Workflow Action Field Options/developer/v1/actions/{handler}/fields/{field}/optionsGETList Developer Workflows/developer/v1/workflowsPOSTCreate Developer Workflow/developer/v1/workflowsPOSTValidate Workflow Definition/developer/v1/workflows/validatePOSTImport Developer Workflow/developer/v1/workflows/importGETGet Developer Workflow/developer/v1/workflows/{definition_id}PATCHUpdate Developer Workflow/developer/v1/workflows/{definition_id}DELETEDelete Developer Workflow/developer/v1/workflows/{definition_id}GETExport Developer Workflow/developer/v1/workflows/{definition_id}/exportPOSTReplace Developer Workflow Draft From Json/developer/v1/workflows/{definition_id}/draft/from-jsonPOSTCreate Developer Workflow Draft/developer/v1/workflows/{definition_id}/draftDELETEDiscard Developer Workflow Draft/developer/v1/workflows/{definition_id}/draftPOSTPublish Developer Workflow/developer/v1/workflows/{definition_id}/publishGETList Developer Workflow Versions/developer/v1/workflows/{definition_id}/versionsGETGet Developer Workflow Version/developer/v1/workflows/{definition_id}/versions/{version_id}POSTRevert Developer Workflow Version/developer/v1/workflows/{definition_id}/versions/{version_id}/revertPOSTRun Developer Workflow/developer/v1/workflows/{definition_id}/runsGETList Workflow Runs Safe/developer/v1/workflows/{definition_id}/runsGETGet Developer Workflow Webhook Endpoint/developer/v1/workflows/{definition_id}/webhook-endpointPOSTCancel Developer Workflow Run/developer/v1/runs/{run_id}/cancelGETGet Workflow Outline/developer/v1/workflows/{definition_id}/outlineGETGet Workflow Graph/developer/v1/workflows/{definition_id}/graphPUTReplace Workflow Graph/developer/v1/workflows/{definition_id}/graphGETGet Workflow Node Context/developer/v1/workflows/{definition_id}/nodes/{node_id}/contextGETGet Workflow Node Details/developer/v1/workflows/{definition_id}/nodes/{node_id}PATCHUpdate Workflow Node/developer/v1/workflows/{definition_id}/nodes/{node_id}DELETEDelete Workflow Node/developer/v1/workflows/{definition_id}/nodes/{node_id}POSTAudit Workflow/developer/v1/workflows/{definition_id}/auditPOSTInsert Workflow Node After/developer/v1/workflows/{definition_id}/nodes/afterPOSTInsert Workflow Node Before/developer/v1/workflows/{definition_id}/nodes/beforeGETRead Workflow Run Node Shape/developer/v1/workflows/{definition_id}/runs/{run_id}/nodes/{node_id}