---
title: "Changes to Create Trace"
method: POST
path: "/tracing/traces/"
---

# Changes to Create Trace

`POST /tracing/traces/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 101 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`: 7 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`: 7 breaking, 11 info
  - for the `query` request parameter `sync`, default value was changed from `false` to `true`
  - 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 `create_trace` removed and replaced with `create_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/post.md) - [API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) - [Page](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/tracing/traces/post)