latestOpenAPI 3.1.02026-08-197104501.1 MB

8fbaab4fc7c5

workflow management

Append Workflow Event

Append an event to the run's event log. Also updates run.status if event_type maps to a status.

Sequence numbers use optimistic concurrency: on a unique-constraint collision (concurrent append), retries up to _MAX_SEQUENCE_RETRIES times with a fresh MAX+1. The event+status update is atomic in a single DB transaction.

post/v1/workflows/runs/{run_id}/events

Path parameters

run_idstring required

Request body

event_typestring required
step_namestring required
dataobject nullable

Response

Successful Response

{"stackTrail":"paths:/v1/workflows/runs/{run_id}/events:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}