---
title: "Changes to Search across video files and segments to find relevant content"
method: POST
path: "/search"
---

# Changes to Search across video files and segments to find relevant content

`POST /search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 70 revisions.

- **2026-10-30** `23d3f240819f`: 3 info
- **2026-08-22** `d2a5205fc779`: 1 breaking, 1 warning, 2 info
- **2026-07-22** `c02e52ec2e28`: 1 warning, 2 info
- **2026-03-11** `1d5d6115c0d0`: 4 info
- **2026-03-03** `fbee7be59d72`: 1 info
- **2025-12-18** `4a6898f33a3d`: 2 breaking, 6 warning, 8 info
- **2025-12-12** `89641a9d6eb2`: 2 info
- **2025-11-18** `6fa44d2c8b70`: 2 info
- **2025-11-13** `db4e8391c34e`: 1 breaking, 1 warning, 5 info
- **2025-11-07** `3ab05be3c99d`: 2 breaking, 1 warning, 6 info

## Changes

- **2026-10-30** `23d3f240819f`: 3 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `500` status
- **2026-08-22** `d2a5205fc779`: 1 breaking, 1 warning, 2 info
  - added `#/components/schemas/MomentSearchResult` to the `results/items/` response property `oneOf` list for the response status `200`
  - added the new `moment` enum value to the `scope` response property for the response status `200`
  - added the new optional request property `criterion_name`
  - added the new `moment` enum value to the request property `scope`
- **2026-07-22** `c02e52ec2e28`: 1 warning, 2 info
  - added the new `doc_lexical` enum value to the `search_modalities/items/` response property for the response status `200`
  - added the new optional request property `filter/source_metadata`
  - added the new `doc_lexical` enum value to the request property `search_modalities/items/`
- **2026-03-11** `1d5d6115c0d0`: 4 info
  - the `limit` request property default value `10` was removed
  - the `scope` request property default value `file` was removed
  - the `scope` request property default value `file` was removed
  - the `sort_by` request property default value `score` was removed
- **2026-03-03** `fbee7be59d72`: 1 info
  - added the new optional request property `filter/video_info/items/allOf[subschema #2]/scope`
- **2025-12-18** `4a6898f33a3d`: 2 breaking, 6 warning, 8 info
  - added `#/components/schemas/SearchFilterCriteria, subschema #2` to the `filter/metadata/items/` request property `allOf` list
  - the `filter/metadata/items/` request property type changed from `object` to no type
  - removed the request property `filter/metadata/items/operator`
  - removed the request property `filter/metadata/items/path`
  - removed the request property `filter/metadata/items/valueText`
  - removed the request property `filter/metadata/items/valueTextArray`
  - added the new `tag_lexical` enum value to the `search_modalities/items/` response property for the response status `200`
  - added the new `tag_semantic` enum value to the `search_modalities/items/` response property for the response status `200`
  - added the new optional request property `label_filters`
  - added the new `tag_lexical` enum value to the request property `search_modalities/items/`
  - added the new `tag_semantic` enum value to the request property `search_modalities/items/`
  - added the optional property `results/items/oneOf[#/components/schemas/FileSearchResult]/tag` to the response with the `200` status
  - added the optional property `results/items/oneOf[#/components/schemas/SegmentGroupResult]/matched_items/items/metadata` to the response with the `200` status
  - added the optional property `results/items/oneOf[#/components/schemas/SegmentGroupResult]/matched_items/items/tag` to the response with the `200` status
  - added the optional property `results/items/oneOf[#/components/schemas/SegmentSearchResult]/metadata` to the response with the `200` status
  - added the optional property `results/items/oneOf[#/components/schemas/SegmentSearchResult]/tag` to the response with the `200` status
- **2025-12-12** `89641a9d6eb2`: 2 info
  - added the optional property `results/items/oneOf[#/components/schemas/SegmentGroupResult]/matched_items/items/keyframes` to the response with the `200` status
  - added the optional property `results/items/oneOf[#/components/schemas/SegmentSearchResult]/keyframes` to the response with the `200` status
- **2025-11-18** `6fa44d2c8b70`: 2 info
  - added the new optional request property `search_modalities`
  - added the optional property `search_modalities` to the response with the `200` status
- **2025-11-13** `db4e8391c34e`: 1 breaking, 1 warning, 5 info
  - added `#/components/schemas/SegmentGroupResult, #/components/schemas/FaceGroupResult` to the `results/items/` response property `oneOf` list for the response status `200`
  - removed the optional property `search_target` from the response with the `200` status
  - added the new optional request property `group_by_key`
  - added the new optional request property `sort_by`
  - added the new optional request property `threshold`
  - added the optional property `group_by_key` to the response with the `200` status
  - added the optional property `group_count` to the response with the `200` status
- **2025-11-07** `3ab05be3c99d`: 2 breaking, 1 warning, 6 info
  - the response property `query` became optional for the status `200`
  - added `#/components/schemas/FaceSearchResult` to the `results/items/` response property `oneOf` list for the response status `200`
  - added the new `face` enum value to the `scope` response property for the response status `200`
  - added the new optional request property `source_image`
  - the request property `collections` became optional
  - the request property `query` became optional
  - the request property `scope` became optional
  - added the new `face` enum value to the request property `scope`
  - added the optional property `search_target` to the response with the `200` status

---

[Operation](https://skmtc.dev/cloudglue/apis/cloudglue-api/docs/search/post.md) - [API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [Page](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/search/post)
