Read Events

Queries for Events matching the given filter criteria in the given Account. Returns the first page of results, and the URL to request the next page (if there are more results).

Headers

x-prefect-api-version

string

Body

application/json

filter

object | null

Additional optional filter criteria to narrow down the set of Events

Show child attributes

filter.occurred

object

Filter criteria for when the events occurred

Show child attributes

filter.occurred.since

string

Only include events after this time (inclusive)

filter.occurred.until

string

Only include events prior to this time (inclusive)

filter.event

object | null

Filter criteria for the event name

Show child attributes

filter.event.prefix

string[] | null

Only include events matching one of these prefixes

filter.event.exclude_prefix

string[] | null

Exclude events matching one of these prefixes

filter.event.name

string[] | null

Only include events matching one of these names exactly

filter.event.exclude_name

string[] | null

Exclude events matching one of these names exactly

filter.any_resource

object | null

Filter criteria for any resource involved in the event

Show child attributes

filter.any_resource.id

string[] | null

Only include events for resources with these IDs

filter.any_resource.id_prefix

string[] | null

Only include events for resources with IDs starting with these prefixes

filter.any_resource.labels

object | null

Only include events for related resources with these labels

Show child attributes

filter.any_resource.labels.{key}

filter.resource

object | null

Filter criteria for the resource of the event

Show child attributes

filter.resource.id

string[] | null

Only include events for resources with these IDs

filter.resource.id_prefix

string[] | null

Only include events for resources with IDs starting with these prefixes.

filter.resource.labels

object | null

Only include events for resources with these labels

Show child attributes

filter.resource.labels.{key}

filter.resource.distinct

boolean

default:

false

Only include events for distinct resources

filter.related

object | null

Filter criteria for the related resources of the event

Show child attributes

filter.related.id

string[] | null

Only include events for related resources with these IDs

filter.related.role

string[] | null

Only include events for related resources in these roles

filter.related.resources_in_roles

array | null

Only include events with specific related resources in specific roles

filter.related.labels

object | null

Only include events for related resources with these labels

Show child attributes

filter.related.labels.{key}

filter.id

object

Filter criteria for the events' ID

Show child attributes

filter.id.id

string[] | null

Only include events with one of these IDs

filter.order

enum<string>

The order to return filtered events

Available options:

ASC,

DESC

limit

integer

default:

50

The number of events to return with each page

Required range: 0 < x < 50

Response

200

application/json

Successful Response

A single page of events returned from the API, with an optional link to the next page of results

events

object[]

required

The Events matching the query

Show child attributes

events.occurred

string

required

When the event happened from the sender's perspective

events.event

string

required

The name of the event that happened

events.resource

object

required

The primary Resource this event concerns

Show child attributes

events.resource.{key}

string

events.id

string

required

The client-provided identifier of this event

events.related

object[]

A list of additional Resources involved in this event

Show child attributes

events.related.{key}

string

events.payload

object

An open-ended set of data describing what happened

events.follows

string | null

The ID of an event that is known to have occurred prior to this one. If set, this may be used to establish a more precise ordering of causally-related events when they occur close enough together in time that the system may receive them out-of-order.

events.received

string

When the event was received by Prefect Cloud

total

integer

required

The total number of matching Events

next_page

string | null

required

The URL for the next page of results, if there are more

Minimum length: 1