---
title: "Changes to Returns SpanAnnotationSearch."
method: POST
path: "/search/span_annotation"
---

# Changes to Returns SpanAnnotationSearch.

`POST /search/span_annotation`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 97 revisions.

- **2026-10-05** `d951959b83e4`: 1 info
- **2026-09-11** `0f410bc28e15`: 1 info
- **2026-08-25** `28b2f0e8bc01`: 4 breaking, 3 warning, 11 info
- **2026-08-04** `99542cbdb5a9`: 1 breaking, 2 info
- **2026-07-21** `ebfa22e4da0a`: 2 info
- **2026-07-21** `01c6f5cdc4f3`: 2 breaking, 3 info
- **2026-07-16** `bd1187f3520e`: 2 info
- **2026-04-13** `fbbe054a012a`: 1 breaking, 1 info
- **2025-09-23** `c5b78916c4e5`: 2 breaking, 4 info
- **2025-08-22** `53e769440a25`: 4 breaking, 2 warning, 4 info

## Changes

- **2026-10-05** `d951959b83e4`: 1 info
  - api tag `mcp` removed
- **2026-09-11** `0f410bc28e15`: 1 info
  - api tag `mcp` added
- **2026-08-25** `28b2f0e8bc01`: 4 breaking, 3 warning, 11 info
  - added the new required request property `project_id`
  - removed the enum value `SP_CODE_ID` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - removed the enum value `SP_CODE_ID` of the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
  - removed the required property `data` from the response with the `200` status
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `page_size`
  - deleted the `query` request parameter `project_id`
  - added the new optional request property `group_by`
  - added the new optional request property `group_key`
  - added the new optional request property `page_number`
  - added the new optional request property `page_size`
  - added the new optional request property `search_query`
  - added `#/components/schemas/AttachedObjectTypeOperator, #/components/schemas/AttachedObjectOperator, #/components/schemas/SpanAnnotationOperator` to the `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/operator` request property `anyOf` list
  - the request property `sorts` became optional
  - the `sorts` request property default value `` was added
  - added the new `SP_CODE_ID_LIST_RECURSIVE` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - added the new `SP_CODE_ID_LIST_RECURSIVE` enum value to the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
  - added the required property `items` to the response with the `200` status
- **2026-08-04** `99542cbdb5a9`: 1 breaking, 2 info
  - removed the required property `data/items/memo` from the response with the `200` status
  - added the optional property `data/items/sdoc/memo_ids` to the response with the `200` status
  - added the required property `data/items/memo_ids` to the response with the `200` status
- **2026-07-21** `ebfa22e4da0a`: 2 info
  - added the new `SP_FOLDER_ID_LIST_RECURSIVE` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - added the new `SP_FOLDER_ID_LIST_RECURSIVE` enum value to the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
- **2026-07-21** `01c6f5cdc4f3`: 2 breaking, 3 info
  - removed the enum value `SP_TAG_ID_LIST` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - removed the enum value `SP_TAG_ID_LIST` of the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
  - added `#/components/schemas/IDListRecursiveOperator` to the `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/operator` request property `anyOf` list
  - added the new `SP_TAG_ID_LIST_RECURSIVE` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - added the new `SP_TAG_ID_LIST_RECURSIVE` enum value to the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
- **2026-07-16** `bd1187f3520e`: 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-04-13** `fbbe054a012a`: 1 breaking, 1 info
  - the response property `data/items/code/description` became optional for the status `200`
  - the `description` response's property default value `` was added for the status `200`
- **2025-09-23** `c5b78916c4e5`: 2 breaking, 4 info
  - removed the enum value `SP_SOURCE_SOURCE_DOCUMENT_FILENAME` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - removed the enum value `SP_SOURCE_SOURCE_DOCUMENT_FILENAME` of the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
  - added the new `SP_SOURCE_SOURCE_DOCUMENT_NAME` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - added the new `SP_SOURCE_SOURCE_DOCUMENT_NAME` enum value to the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
  - the response property `data/items/sdoc/name` became required for the status `200`
  - response property `data/items/sdoc/name` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2025-08-22** `53e769440a25`: 4 breaking, 2 warning, 4 info
  - removed the enum value `SP_SOURCE_SOURCE_DOCUMENT_NAME` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - removed the enum value `SP_SOURCE_SOURCE_DOCUMENT_NAME` of the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
  - the response property `data/items/sdoc/name` became optional for the status `200`
  - response property `data/items/sdoc/name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
  - added the new `SP_SOURCE_SOURCE_DOCUMENT_FILENAME` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/`
  - added the new `SP_SOURCE_SOURCE_DOCUMENT_FILENAME` enum value to the request property `sorts/items/column/anyOf[subschema #1: SpanColumns]/`
  - the response property `data/items/code/description` became required for the status `200`
  - the `description` response's property default value `` was removed for the status `200`

---

[Operation](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/docs/search/span_annotation/post.md) - [API](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api.md) - [Page](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/changes/search/span_annotation/post)