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.

Discover capabilities

Inspect controls, node types, expressions, integrations, and action schemas.

Explore Find workflow functions

Search the actions available for use in a workflow definition.

Explore Create workflows

Create organization-scoped workflow records and validate their JSON first.

Explore Publish and run

Publish immutable versions and start idempotent workflow runs.

Contract summary

Property	Value
OpenAPI	3.1.0
API version	1.0.0
Operations	36
Component schemas	59
Authentication	HTTP 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}