---
title: "Changes to Ingest a batch of traces"
method: POST
path: "/ingest"
---

# Changes to Ingest a batch of traces

`POST /ingest`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 4 revisions.

- **2026-06-21** `04549fe6ab0a` — 1 info
- **2026-06-13** `da37470dccd5` — 2 breaking, 2 warning, 14 info
- **2026-05-31** `509775c21a87` — 1 info

## Changes

- **2026-06-21** `04549fe6ab0a` — 1 info
  - added the new optional request property `traces/items/customer`
- **2026-06-13** `da37470dccd5` — 2 breaking, 2 warning, 14 info
  - added 'propertyNames' constraint to the request property `traces/items/metadata`
  - added 'propertyNames' constraint to the request property `traces/items/spans/items/metadata`
  - the `traces/items/metadata/additionalProperties/` request property's maxLength was set to `1024`
  - the `traces/items/spans/items/metadata/additionalProperties/` request property's maxLength was set to `1024`
  - added the new optional request property `traces/items/spans/items/chunkOffsets`
  - added the new optional request property `traces/items/spans/items/chunkTokens`
  - added the new optional request property `traces/items/spans/items/modelCallMs`
  - added the new optional request property `traces/items/spans/items/rateLimit`
  - added the new optional request property `traces/items/spans/items/reasoningChunkTokens`
  - added the new optional request property `traces/items/spans/items/reasoningDurationMs`
  - added the new optional request property `traces/items/spans/items/reasoningOffsets`
  - added the new optional request property `traces/items/spans/items/safetyMetadata`
  - added the new optional request property `traces/items/spans/items/sources`
  - added the new optional request property `traces/items/spans/items/systemFingerprint`
  - added the new optional request property `traces/items/spans/items/toolCatalog`
  - the `traces/items/spans/items/ttftMs` request property type/format was generalized from `integer`/`` to `number`/``
  - added the non-success response with the status `413`
  - added the non-success response with the status `503`
- **2026-05-31** `509775c21a87` — 1 info
  - added the new optional request property `traces/items/traceName`

---

[Operation](https://skmtc.dev/foglamp-labs/apis/foglamp-ingest-api/docs/ingest/post.md) · [API](https://skmtc.dev/foglamp-labs/apis/foglamp-ingest-api.md) · [Page](https://skmtc.dev/foglamp-labs/apis/foglamp-ingest-api/changes/ingest/post)