Workflows
Automated multi-step clinical pipelines. Workflows chain agents, FHIR reads/writes, and integrations.
The Workflow Object
| Field | Type | Description |
|---|---|---|
| id | string | Unique workflow ID (e.g. wf_prior_auth_v2) |
| name | string | Human-readable name of the workflow |
| status | string | One of: active | draft | paused | archived |
| trigger | string | How the workflow is initiated: manual | event | schedule | webhook |
| nodeCount | integer | Number of nodes (steps) in the workflow graph |
| lastRunAtnullable | datetime | ISO 8601 UTC timestamp of the most recent execution |
| avgDurationMs | integer | Average execution duration in milliseconds |
| successRate | number | Percentage of runs that completed successfully (0–1) |
Endpoints
Returns all workflows defined in a project.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| projectIde.g. proj_rpm_001 | query | string | required | Project ID |
| statuse.g. active | query | string | optional | Filter by status |
Request
curl "https://api.healthcloud.ai/v1/workflows?projectId=proj_rpm_001" \ -H "Authorization: Bearer hc_test_sk_demo_live_xxxxxx"
Response
Response200
{ "data": [ { "id": "wf_prior_auth_v2", "name": "Prior Authorization", "status": "active", "nodeCount": 8, "lastRunAt": "2026-03-17T14:32:00Z", "avgDurationMs": 4200 } ] }