Events
Platform events emitted by deployments, workflows, and integrations. Used for audit trails and webhook triggers.
The Event Object
| Field | Type | Description |
|---|---|---|
| id | string | Unique event ID with prefix evt_ (e.g. evt_wf_001) |
| type | string | Dot-namespaced event type (e.g. workflow.completed, agent.run.failed) |
| projectId | string | ID of the project that emitted this event |
| source | string | Component that emitted the event: workflow | agent | integration | deployment | system |
| payload | object | Event-specific payload containing relevant resource IDs and state changes |
| severity | string | One of: info | warning | error | critical |
| createdAt | datetime | ISO 8601 UTC timestamp when the event was emitted |
Endpoints
Returns the platform event log, newest first.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| projectIde.g. proj_rpm_001 | query | string | required | Project ID |
| typee.g. workflow.completed | query | string | optional | Event type filter |
| sincee.g. 2026-03-17T00:00:00Z | query | string | optional | ISO 8601 timestamp |
Request
curl "https://api.healthcloud.ai/v1/events?projectId=proj_rpm_001&type=workflow.completed" \ -H "Authorization: Bearer hc_test_sk_demo_live_xxxxxx"
Response
Response200
{ "data": [ { "id": "evt_wf_001", "type": "workflow.completed", "projectId": "proj_rpm_001", "payload": { "workflowId": "wf_prior_auth_v2", "status": "approved" }, "createdAt": "2026-03-18T11:55:00Z" } ], "meta": { "total": 4821 } }