---
title: "Changes to Edit Trace"
method: PUT
path: "/tracing/traces/{trace_id}"
---

# Changes to Edit Trace

`PUT /tracing/traces/{trace_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 378 revisions.

- **2026-08-03** `fc532d6dc820` — 9 info
- **2026-05-19** `a7f9a6823230` — 2 warning
- **2026-05-14** `d7e21f629c88` — 1 warning
- **2026-05-08** `bb630edffa27` — 3 info
- **2026-05-02** `6e37373d45fe` — 2 info
- **2026-04-23** `925e8b901a26` — 3 info
- **2026-04-16** `8b06b786c977` — 1 warning
- **2026-03-07** `20311f763505` — 6 breaking, 11 info
- **2026-02-13** `72fe88316d15` — 2 info
- **2026-01-14** `53da4c9de2b7` — 1 info
- **2025-06-27** `e3e84db47198` — 1 info

## Changes

- **2026-08-03** `fc532d6dc820` — 9 info
  - added the new optional request property `spans/anyOf[subschema #1]/items/agent_id`
  - added the new optional request property `spans/anyOf[subschema #1]/items/session_id`
  - added the new optional request property `spans/anyOf[subschema #1]/items/user_id`
  - added the new optional request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #1: SpansNode]/agent_id`
  - added the new optional request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #1: SpansNode]/session_id`
  - added the new optional request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #1: SpansNode]/user_id`
  - added the new optional request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/agent_id`
  - added the new optional request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/session_id`
  - added the new optional request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/user_id`
- **2026-05-19** `a7f9a6823230` — 2 warning
  - removed the optional property `support_id` from the response with the `202` status
  - removed the optional property `support_ts` from the response with the `202` status
- **2026-05-14** `d7e21f629c88` — 1 warning
  - removed the optional property `dropped` from the response with the `202` status
- **2026-05-08** `bb630edffa27` — 3 info
  - api tag `Deprecated` added
  - api tag `Traces` removed
  - endpoint deprecated
- **2026-05-02** `6e37373d45fe` — 2 info
  - api tag `Traces` added
  - api tag `Observability` removed
- **2026-04-23** `925e8b901a26` — 3 info
  - added the optional property `dropped` to the response with the `202` status
  - added the optional property `support_id` to the response with the `202` status
  - added the optional property `support_ts` to the response with the `202` status
- **2026-04-16** `8b06b786c977` — 1 warning
  - deleted the `query` request parameter `sync`
- **2026-03-07** `20311f763505` — 6 breaking, 11 info
  - removed `#/components/schemas/OTelSpan-Input` from the `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/` request property `anyOf` list
  - removed `#/components/schemas/OTelSpan-Input` from the `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/spans/anyOf[subschema #1]/additionalProperties/` request property `anyOf` list
  - the response property `links/anyOf[subschema #1]/items/span_id` became optional for the status `202`
  - the response property `links/anyOf[subschema #1]/items/trace_id` became optional for the status `202`
  - response property `links/anyOf[subschema #1]/items/span_id` list-of-types was widened by adding types `null` to media type `application/json` of response `202`
  - response property `links/anyOf[subschema #1]/items/trace_id` list-of-types was widened by adding types `null` to media type `application/json` of response `202`
  - api operation id `edit_trace` removed and replaced with `edit_trace_tracing`
  - added `#/components/schemas/SpansNode-Input` to the `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/` request property `anyOf` list
  - added `#/components/schemas/SpansNode-Input` to the `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/spans/anyOf[subschema #1]/additionalProperties/` request property `anyOf` list
  - the request property `spans/anyOf[subschema #1]/items/links/anyOf[subschema #1]/items/span_id` became optional
  - the request property `spans/anyOf[subschema #1]/items/links/anyOf[subschema #1]/items/trace_id` became optional
  - the request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/links/anyOf[subschema #1]/items/span_id` became optional
  - the request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/links/anyOf[subschema #1]/items/trace_id` became optional
  - request property `spans/anyOf[subschema #1]/items/links/anyOf[subschema #1]/items/span_id` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `spans/anyOf[subschema #1]/items/links/anyOf[subschema #1]/items/trace_id` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/links/anyOf[subschema #1]/items/span_id` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/links/anyOf[subschema #1]/items/trace_id` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-02-13** `72fe88316d15` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-01-14** `53da4c9de2b7` — 1 info
  - endpoint added
- **2025-06-27** `e3e84db47198` — 1 info
  - api path removed with deprecation

---

[Operation](https://skmtc.dev/agenta-ai/apis/agenta-api/docs/tracing/traces/:trace_id/put.md) · [API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [Page](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/tracing/traces/:trace_id/put)