Skip to main content
GET
List trail events

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

flow_name
string
required
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9\.\-_~]*$
trail_name
string
required
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9\.\-_~]*$
org
string
required

Query Parameters

sort
enum<string>
default:newest

Order of the events: newest or oldest first.

Available options:
oldest,
newest
anchor_id
string | null

Start the page at the event that reported the attestation, override or artifact with this ID. _links.prev reaches the events before it. Ignored with a cursor.

Maximum string length: 36
Pattern: ^[0-9a-f-]+$
after
string | null

Cursor for the next page. Use the token from a response's _links.next.

before
string | null

Cursor for the previous page. Use the token from a response's _links.prev. Cannot be combined with after.

per_page
integer
default:50

How many events to return per page (max 100).

Required range: 1 <= x <= 100

Response

Successful Response

events
(TrailStartedEventResponse · object | TrailUpdatedEventResponse · object | TrailAttestationEventResponse · object | TrailAttestationForArtifactEventResponse · object | ArtifactAttestationEventResponse · object | ArtifactReportedEventResponse · object | ArtifactDeploymentEventResponse · object | ArtifactApprovalEventResponse · object | ArtifactStartedRunningEventResponse · object | ArtifactStoppedRunningEventResponse · object | AttestationOverriddenEventResponse · object)[]
required

This page of the trail's events, in the requested order

self, plus next and prev towards the later and earlier pages of the requested order, each present only while a page exists that way.