Sign in
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
}

Changes

Changed in 4 of the 135 revisions of this API.74

  • 148f0a9eb91221See the full diff
    • ▲

      the request property parallel_branch_id became not nullable

      request-property-became-not-nullable

    • ▲

      the parallel_branch_id request property type/format changed from string null/ to /

      request-property-type-changed

    • ○

      added ParallelBranchId subschema #2 to the parallel_branch_id request property oneOf list

      request-property-one-of-added

  • 3c01c6d3d31e21See the full diff
    • ▲

      removed ParallelBranchId subschema #2 from the parallel_branch_id request property oneOf list

      request-property-one-of-removed

    • ▲

      the parallel_branch_id request property type/format changed from / to string null/

      request-property-type-changed

    • ○

      the request property parallel_branch_id became nullable

      request-property-became-nullable

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 7fe7b675579921See the full diff
    • ▲

      the request property parallel_branch_id became not nullable

      request-property-became-not-nullable

    • ▲

      the parallel_branch_id request property type/format changed from string null/ to /

      request-property-type-changed

    • ○

      added ParallelBranchId subschema #2 to the parallel_branch_id request property oneOf list

      request-property-one-of-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • de85d055604011See the full diff
    • ▲

      removed PrincipalAnonymous from the actor/oneOf[Principal]/ request property oneOf list

      request-property-one-of-removed

    • ○

      removed anonymous discriminator mapping keys from the actor/oneOf[Principal]/ request property

      request-property-discriminator-mapping-deleted

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog