Sign in

v106

OpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB
Run Internals

Append Run Event

Appends a validated event to the run event log. Intended for trusted internal callers.

post/api/v1/runs/{id}/events

Path parameters

idstring required

Unique run identifier (ULID).

Request body

idstring required
tsstring date-time required
run_idstring required
node_idstring nullable
node_labelstring nullable
stage_idstring nullable

Stage execution identity, formatted as "{node_id}@{visit}".

parallel_group_idstring nullable

Durable identity of one execution of a parallel node, formatted as "{node_id}@{visit}".

parallel_branch_idstring

Durable identity of one branch within a parallel execution, in {parallel_group_id}:{index} form.

session_idstring nullable
parent_session_idstring nullable
tool_call_idstring nullable

Stable identifier for a tool call, present on agent.tool.* events and other durable events that directly describe the same tool call.

eventstring required

Event type discriminator.

propertiesobject

Example request

{
  "parallel_branch_id": "review_fork@3:1",
  "event": "stage.started"
}

Response

Event appended

seqinteger required

Assigned event sequence number.

Example response

{
  "seq": 42
}