Skip to main content

Upsert Trace Tags

PUT 
/datasets/:dataset_id/versions/:version_id/trace-tags

Create or update tags on individual traces within a dataset version.

Each tag is keyed by (target_ref, key): a repeat of an existing pair updates its value rather than duplicating the row. The whole batch is validated before anything is written — if the dataset uses the agent-trace schema, every target_ref must name a trace that actually exists in this version, and a request naming even one unknown trace is rejected in full (422), so a caller never ends up with a partially-applied batch or an orphaned tag that can never be matched back to a trace at read time.

Request​

Responses​

Successful Response