Artifact and asset events - Prefect

Artifact events track artifact creation and updates. Asset events track data lineage through upstream references and downstream materializations.

Artifact events

Emitted when a new artifact is created.

Label	Description
`prefect.resource.id`	`prefect.artifact.{uuid}`
`prefect.resource.name`	Artifact key (when set)

This event has no related resources.

Field	Type	Description
`key`	string or null	Artifact key
`type`	string or null	Artifact type (for example, `markdown`, `table`, `progress`, `image`)
`description`	string or null	Artifact description

Emitted when an existing artifact is updated.

Label	Description
`prefect.resource.id`	`prefect.artifact.{uuid}`

This event has no related resources.

The payload contains the fields that were updated, serialized from the update model. Common fields include data, description, and type.

For more on assets and data lineage, see Assets.

Emitted for each upstream asset referenced during a task execution. One event is emitted per upstream asset.

Label	Description
`prefect.resource.id`	Asset key (the unique identifier for the asset, for example `s3://bucket/path`)
`prefect.resource.name`	Asset name (when set via asset properties)
`prefect.asset.description`	Asset description (when set)
`prefect.asset.url`	Asset URL (when set)
`prefect.asset.owners`	JSON-encoded list of asset owners (when set)

This event has no related resources.

This event has no payload.

Emitted when a downstream asset is successfully materialized (the task that produces it completes).

Resource ID pattern	Role	When present
Asset key	`asset`	One entry per upstream asset (both direct and inherited)
Materialized-by identifier	`asset-materialized-by`	When a `materialized_by` identifier was specified

User-provided materialization metadata, if any was supplied via the asset's materialization_metadata parameter. This is an open-ended dictionary.

Emitted when a downstream asset fails to materialize (the task that produces it fails). Same structure as prefect.asset.materialization.succeeded.