--- title: "Changes to Create a new segmentation for a file" method: POST path: "/files/{file_id}/segmentations" --- # Changes to Create a new segmentation for a file `POST /files/{file_id}/segmentations` > Every recorded change to this operation, newest first. ## Timeline Changed in 10 of 70 revisions. - **2026-10-30** `23d3f240819f`: 3 info - **2026-06-12** `f90a8032c6ae`: 1 breaking, 1 info - **2026-04-27** `43191ed5a246`: 1 warning, 1 info - **2026-03-11** `1d5d6115c0d0`: 10 info - **2026-03-09** `3700d31a3ff8`: 2 breaking, 8 info - **2026-01-30** `2e7f65543b55`: 1 warning, 5 info - **2025-12-12** `89641a9d6eb2`: 2 info - **2025-11-18** `6d14e93b80fd`: 2 info - **2025-11-13** `bad5473b6b88`: 1 warning, 3 info - **2025-10-17** `1c3cae3a41bc`: 7 breaking, 7 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-06-12** `f90a8032c6ae`: 1 breaking, 1 info - the `segmentation_config/shot_detector_config/min_seconds` response property's min was decreased from `1.00` to `0.60` for the response status `200` - the `allOf[#/components/schemas/SegmentationConfig]/shot_detector_config/min_seconds` request property's min was decreased from `1.00` to `0.60` - **2026-04-27** `43191ed5a246`: 1 warning, 1 info - added the new `transcript` enum value to the `segmentation_config/narrative_config/strategy` response property for the response status `200` - added the new `transcript` enum value to the request property `allOf[#/components/schemas/SegmentationConfig]/narrative_config/strategy` - **2026-03-11** `1d5d6115c0d0`: 10 info - the `fill_gaps` request property default value `true` was removed - the `max_seconds` request property default value `300` was removed - the `max_width` request property default value `280` was removed - the `min_seconds` request property default value `1` was removed - the `strategy` request property default value `balanced` was removed - the `fill_gaps` response's property default value `true` was removed for the status `200` - the `max_seconds` response's property default value `300` was removed for the status `200` - the `max_width` response's property default value `280` was removed for the status `200` - the `min_seconds` response's property default value `1` was removed for the status `200` - the `strategy` response's property default value `balanced` was removed for the status `200` - **2026-03-09** `3700d31a3ff8`: 2 breaking, 8 info - the `segmentation_config/shot_detector_config/max_seconds` response property's max was increased from `120.00` to `600.00` for the response status `200` - the `segmentation_config/shot_detector_config/min_seconds` response property's max was increased from `120.00` to `600.00` for the response status `200` - added the new optional request property `allOf[#/components/schemas/SegmentationConfig]/shot_detector_config/fill_gaps` - the `max_seconds` request property default value `300` was added - the `min_seconds` request property default value `1` was added - the `allOf[#/components/schemas/SegmentationConfig]/shot_detector_config/max_seconds` request property's max was increased from `120.00` to `600.00` - the `allOf[#/components/schemas/SegmentationConfig]/shot_detector_config/min_seconds` request property's max was increased from `120.00` to `600.00` - added the optional property `segmentation_config/shot_detector_config/fill_gaps` to the response with the `200` status - the `max_seconds` response's property default value `300` was added for the status `200` - the `min_seconds` response's property default value `1` was added for the status `200` - **2026-01-30** `2e7f65543b55`: 1 warning, 5 info - added the new `narrative` enum value to the `segmentation_config/strategy` response property for the response status `200` - added the new optional request property `allOf[#/components/schemas/SegmentationConfig]/narrative_config` - added the new `narrative` enum value to the request property `allOf[#/components/schemas/SegmentationConfig]/strategy` - added the optional property `data/chapters` to the response with the `200` status - added the optional property `segmentation_config/narrative_config` to the response with the `200` status - added the optional property `total_chapters` to the response with the `200` status - **2025-12-12** `89641a9d6eb2`: 2 info - added the new optional request property `allOf[#/components/schemas/SegmentationConfig]/keyframe_config` - added the optional property `segmentation_config/keyframe_config` to the response with the `200` status - **2025-11-18** `6d14e93b80fd`: 2 info - added the optional property `data/shots` to the response with the `200` status - added the optional property `total_shots` to the response with the `200` status - **2025-11-13** `bad5473b6b88`: 1 warning, 3 info - added the new `manual` enum value to the `segmentation_config/strategy` response property for the response status `200` - added the new optional request property `allOf[#/components/schemas/SegmentationConfig]/manual_config` - added the new `manual` enum value to the request property `allOf[#/components/schemas/SegmentationConfig]/strategy` - added the optional property `segmentation_config/manual_config` to the response with the `200` status - **2025-10-17** `1c3cae3a41bc`: 7 breaking, 7 info - the `segmentation_config/shot_detector_config/max_seconds` response property's max was increased from `60.00` to `120.00` for the response status `200` - the `segmentation_config/shot_detector_config/min_seconds` response property's max was increased from `60.00` to `120.00` for the response status `200` - the `segmentation_config/uniform_config/hop_seconds` response property's max was increased from `60.00` to `120.00` for the response status `200` - the `segmentation_config/uniform_config/window_seconds` response property's max was increased from `60.00` to `120.00` for the response status `200` - the `segmentation_config/shot_detector_config/max_seconds` response property's min was decreased from `2.00` to `1.00` for the response status `200` - the `segmentation_config/shot_detector_config/min_seconds` response property's min was decreased from `2.00` to `1.00` for the response status `200` - the `segmentation_config/uniform_config/window_seconds` response property's min was decreased from `2.00` to `1.00` for the response status `200` - the `allOf[#/components/schemas/SegmentationConfig]/shot_detector_config/max_seconds` request property's max was increased from `60.00` to `120.00` - the `allOf[#/components/schemas/SegmentationConfig]/shot_detector_config/min_seconds` request property's max was increased from `60.00` to `120.00` - the `allOf[#/components/schemas/SegmentationConfig]/uniform_config/hop_seconds` request property's max was increased from `60.00` to `120.00` - the `allOf[#/components/schemas/SegmentationConfig]/uniform_config/window_seconds` request property's max was increased from `60.00` to `120.00` - the `allOf[#/components/schemas/SegmentationConfig]/shot_detector_config/max_seconds` request property's min was decreased from `2.00` to `1.00` - the `allOf[#/components/schemas/SegmentationConfig]/shot_detector_config/min_seconds` request property's min was decreased from `2.00` to `1.00` - the `allOf[#/components/schemas/SegmentationConfig]/uniform_config/window_seconds` request property's min was decreased from `2.00` to `1.00` --- [Operation](https://skmtc.dev/cloudglue/apis/cloudglue-api/docs/files/:file_id/segmentations/post.md) - [API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [Page](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/files/:file_id/segmentations/post)