List Run Events

Returns a paginated JSON list of stored run events. Ascending order uses since_seq as an inclusive cursor. Descending order uses before_seq as an exclusive cursor and starts at the newest event when before_seq is omitted.

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

Path parameters

idstring required

Unique run identifier (ULID).

Query parameters

since_seqinteger

First event sequence number to include.

limitinteger

Maximum number of events to return.

before_seqinteger

Exclusive upper event sequence cursor for descending order. Omit on the first descending request to start from the newest event.

order'asc' | 'desc'

Event sequence order. since_seq is valid only with asc; before_seq is valid only with desc.

Response

Paginated list of run events

Example response

{
  "data": [
    {
      "seq": 42,
      "parallel_branch_id": "review_fork@3:1",
      "event": "stage.started"
    }
  ]
}

Changes

Changed in 12 of the 135 revisions of this API.6619

Jul 28, 2026148f0a9eb9122See the full diff
- ▲
  added ParallelBranchId subschema #2 to the data/items/allOf[RunEvent]/parallel_branch_id response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the data/items/allOf[RunEvent]/parallel_branch_id response's property type/format changed from string null/ to / for status 200
  response-property-type-changed
Jul 28, 20263c01c6d3d31e21See the full diff
- ▲
  the response property data/items/allOf[RunEvent]/parallel_branch_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the data/items/allOf[RunEvent]/parallel_branch_id response's property type/format changed from / to string null/ for status 200
  response-property-type-changed
- ○
  removed ParallelBranchId subschema #2 from the data/items/allOf[RunEvent]/parallel_branch_id response property oneOf list for the response status 200
  response-property-one-of-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 28, 20267fe7b67557992See the full diff
- ▲
  added ParallelBranchId subschema #2 to the data/items/allOf[RunEvent]/parallel_branch_id response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the data/items/allOf[RunEvent]/parallel_branch_id response's property type/format changed from string null/ to / for status 200
  response-property-type-changed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 24, 202600837a8a4a3f3See the full diff
- ○
  added the new optional query request parameter before_seq
  new-optional-request-parameter
- ○
  added the new optional query request parameter order
  new-optional-request-parameter
- ○
  added the non-success response with the status 400
  response-non-success-status-added
Jul 24, 20265b42519a0c3b21See the full diff
- ●
  deleted the query request parameter before_seq
  request-parameter-removed
- ●
  deleted the query request parameter order
  request-parameter-removed
- ○
  removed the non-success response with the status 400
  response-non-success-status-removed
Jul 24, 2026d3b22cbaeec03See the full diff
- ○
  added the new optional query request parameter before_seq
  new-optional-request-parameter
- ○
  added the new optional query request parameter order
  new-optional-request-parameter
- ○
  added the non-success response with the status 400
  response-non-success-status-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 24, 2026cdb4758e1ddc21See the full diff
- ●
  deleted the query request parameter before_seq
  request-parameter-removed
- ●
  deleted the query request parameter order
  request-parameter-removed
- ○
  removed the non-success response with the status 400
  response-non-success-status-removed
Jul 24, 202693e30ee398f63See the full diff
- ○
  added the new optional query request parameter before_seq
  new-optional-request-parameter
- ○
  added the new optional query request parameter order
  new-optional-request-parameter
- ○
  added the non-success response with the status 400
  response-non-success-status-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 24, 202686b40eee4d5b21See the full diff
- ●
  deleted the query request parameter before_seq
  request-parameter-removed
- ●
  deleted the query request parameter order
  request-parameter-removed
- ○
  removed the non-success response with the status 400
  response-non-success-status-removed
Jul 24, 2026b6be209772a63See the full diff
- ○
  added the new optional query request parameter before_seq
  new-optional-request-parameter
- ○
  added the new optional query request parameter order
  new-optional-request-parameter
- ○
  added the non-success response with the status 400
  response-non-success-status-added

Full history (12 revisions)