---
title: "Changes to Returns BBox Annotations."
method: POST
path: "/search/bbox_annotation"
---

# Changes to Returns BBox Annotations.

`POST /search/bbox_annotation`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 73 revisions.

- **2026-08-20** `28b2f0e8bc01` — 4 breaking, 3 warning, 13 info
- **2026-08-04** `7d9df729f4fc` — 1 breaking, 2 info
- **2026-08-03** `fab14ec2229b` — 1 breaking, 1 warning, 1 info
- **2026-08-03** `99542cbdb5a9` — 1 breaking, 2 info
- **2026-07-21** `ebfa22e4da0a` — 2 info
- **2026-07-20** `01c6f5cdc4f3` — 2 breaking, 3 info
- **2026-07-15** `bd1187f3520e` — 5 breaking, 2 info
- **2026-07-15** `1af5a8046f20` — 2 breaking, 7 info
- **2026-04-13** `fbbe054a012a` — 1 breaking, 1 info
- **2025-09-18** `c5b78916c4e5` — 2 breaking, 4 info
- **2025-08-22** `53e769440a25` — 4 breaking, 2 warning, 4 info

## Changes

- **2026-08-20** `28b2f0e8bc01` — 4 breaking, 3 warning, 13 info
  - added the new required request property `project_id`
  - removed the enum value `BB_CODE_ID` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - removed the enum value `BB_CODE_ID` of the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - 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[BBoxColumns]]/operator` request property `anyOf` list
  - the request property `sorts` became optional
  - the `sorts` request property default value `` was added
  - added the new `BB_CODE_ID_LIST_RECURSIVE` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_CODE_ID_LIST_RECURSIVE` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_USER_ID` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_USER_ID` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - added the required property `items` to the response with the `200` status
- **2026-08-04** `7d9df729f4fc` — 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-08-03** `fab14ec2229b` — 1 breaking, 1 warning, 1 info
  - removed the required property `data/items/memo_ids` from the response with the `200` status
  - removed the optional property `data/items/sdoc/memo_ids` from the response with the `200` status
  - added the required property `data/items/memo` to the response with the `200` status
- **2026-08-03** `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 `BB_FOLDER_ID_LIST_RECURSIVE` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_FOLDER_ID_LIST_RECURSIVE` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
- **2026-07-20** `01c6f5cdc4f3` — 2 breaking, 3 info
  - removed the enum value `BB_TAG_ID_LIST` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - removed the enum value `BB_TAG_ID_LIST` of the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - added `#/components/schemas/IDListRecursiveOperator` to the `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/operator` request property `anyOf` list
  - added the new `BB_TAG_ID_LIST_RECURSIVE` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_TAG_ID_LIST_RECURSIVE` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
- **2026-07-15** `bd1187f3520e` — 5 breaking, 2 info
  - removed `#/components/schemas/IDListRecursiveOperator` from the `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/operator` request property `anyOf` list
  - removed the enum value `BB_FOLDER_ID_LIST_RECURSIVE` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - removed the enum value `BB_FOLDER_ID_LIST_RECURSIVE` of the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - removed the enum value `BB_TAG_ID_LIST_RECURSIVE` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - removed the enum value `BB_TAG_ID_LIST_RECURSIVE` of the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_TAG_ID_LIST` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_TAG_ID_LIST` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
- **2026-07-15** `1af5a8046f20` — 2 breaking, 7 info
  - removed the enum value `BB_TAG_ID_LIST` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - removed the enum value `BB_TAG_ID_LIST` of the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - added `#/components/schemas/IDListRecursiveOperator` to the `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/operator` request property `anyOf` list
  - added the new `BB_FOLDER_ID_LIST_RECURSIVE` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_FOLDER_ID_LIST_RECURSIVE` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_TAG_ID_LIST_RECURSIVE` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_TAG_ID_LIST_RECURSIVE` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - 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-18** `c5b78916c4e5` — 2 breaking, 4 info
  - removed the enum value `BB_SOURCE_SOURCE_DOCUMENT_FILENAME` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - removed the enum value `BB_SOURCE_SOURCE_DOCUMENT_FILENAME` of the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_SOURCE_SOURCE_DOCUMENT_NAME` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_SOURCE_SOURCE_DOCUMENT_NAME` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - 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 `BB_SOURCE_SOURCE_DOCUMENT_NAME` of the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - removed the enum value `BB_SOURCE_SOURCE_DOCUMENT_NAME` of the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - 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 `BB_SOURCE_SOURCE_DOCUMENT_FILENAME` enum value to the request property `filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/`
  - added the new `BB_SOURCE_SOURCE_DOCUMENT_FILENAME` enum value to the request property `sorts/items/column/anyOf[subschema #1: BBoxColumns]/`
  - 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/bbox_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/bbox_annotation/post)