--- title: "Changes to Create a new media description job" method: POST path: "/describe" --- # Changes to Create a new media description job `POST /describe` > Every recorded change to this operation, newest first. ## Timeline Changed in 15 of 70 revisions. - **2026-10-30** `23d3f240819f`: 5 info - **2026-08-31** `85130a1f5247`: 2 info - **2026-07-22** `c02e52ec2e28`: 2 info - **2026-06-22** `dc094f0637ef`: 2 info - **2026-06-12** `f90a8032c6ae`: 1 info - **2026-04-27** `43191ed5a246`: 1 info - **2026-03-16** `9dc639e1d66c`: 2 info - **2026-03-11** `1d5d6115c0d0`: 17 info - **2026-03-09** `3700d31a3ff8`: 7 info - **2026-01-30** `2e7f65543b55`: 3 info - **2025-12-12** `89641a9d6eb2`: 1 info - **2025-11-13** `bad5473b6b88`: 2 info - **2025-11-03** `86dd61a3e0f3`: 1 breaking, 7 warning, 3 info - **2025-10-23** `711ac767a126`: 1 info - **2025-10-17** `1c3cae3a41bc`: 7 info ## Changes - **2026-10-30** `23d3f240819f`: 5 info - added the non-success response with the status `403` - removed the non-success response with the status `429` - 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 `509` status - **2026-08-31** `85130a1f5247`: 2 info - added the new optional request property `allOf[subschema #1]/prompt` - added the optional property `describe_config/prompt` to the response with the `200` status - **2026-07-22** `c02e52ec2e28`: 2 info - added the new optional request property `allOf[subschema #1]/include_metadata` - added the optional property `file` to the response with the `200` status - **2026-06-22** `dc094f0637ef`: 2 info - added the new optional request property `allOf[subschema #1]/participants` - added the optional property `describe_config/participants` to the response with the `200` status - **2026-06-12** `f90a8032c6ae`: 1 info - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/shot_detector_config/min_seconds` request property's min was decreased from `1.00` to `0.60` - **2026-04-27** `43191ed5a246`: 1 info - added the new `transcript` enum value to the request property `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/narrative_config/strategy` - **2026-03-16** `9dc639e1d66c`: 2 info - added the new optional request property `allOf[subschema #1]/use_in_default_index` - added the optional property `use_in_default_index` to the response with the `200` status - **2026-03-11** `1d5d6115c0d0`: 17 info - added the new optional request property `allOf[subschema #1]/include_chapters` - added the new optional request property `allOf[subschema #1]/include_shots` - the `enable_audio_description` request property default value `false` was removed - the `enable_scene_text` request property default value `true` was removed - the `enable_speech` request property default value `true` was removed - the `enable_summary` request property default value `true` was removed - the `enable_visual_scene_description` request property default value `true` was removed - 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 - added the optional property `chapters` to the response with the `200` status - added the optional property `data/allOf[#/components/schemas/DescribeOutput]/speech/items/words` to the response with the `200` status - added the optional property `shots` to the response with the `200` status - added the optional property `total_chapters` to the response with the `200` status - added the optional property `total_shots` to the response with the `200` status - **2026-03-09** `3700d31a3ff8`: 7 info - added the new optional request property `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/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/FileSegmentationConfig]/segmentation_config/shot_detector_config/max_seconds` request property's max was increased from `120.00` to `600.00` - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/shot_detector_config/min_seconds` request property's max was increased from `120.00` to `600.00` - added the optional property `data/allOf[subschema #1]/segment_summary/items/thumbnail_url` to the response with the `200` status - added the optional property `thumbnail_url` to the response with the `200` status - **2026-01-30** `2e7f65543b55`: 3 info - added the new optional request property `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/narrative_config` - added the new `narrative` enum value to the request property `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/strategy` - added the optional property `segmentation_id` to the response with the `200` status - **2025-12-12** `89641a9d6eb2`: 1 info - added the new optional request property `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/keyframe_config` - **2025-11-13** `bad5473b6b88`: 2 info - added the new optional request property `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/manual_config` - added the new `manual` enum value to the request property `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/strategy` - **2025-11-03** `86dd61a3e0f3`: 1 breaking, 7 warning, 3 info - the `data` response's property type changed from `object` to no type for status `200` - removed the optional property `data/content` from the response with the `200` status - removed the optional property `data/scene_text` from the response with the `200` status - removed the optional property `data/segment_summary` from the response with the `200` status - removed the optional property `data/speech` from the response with the `200` status - removed the optional property `data/summary` from the response with the `200` status - removed the optional property `data/title` from the response with the `200` status - removed the optional property `data/visual_scene_description` from the response with the `200` status - added the new optional request property `allOf[subschema #1]/enable_audio_description` - added the optional property `describe_config/enable_audio_description` to the response with the `200` status - added `#/components/schemas/DescribeOutput, subschema #1` to the `data` response property `allOf` list for the response status `200` - **2025-10-23** `711ac767a126`: 1 info - added the optional property `duration_seconds` to the response with the `200` status - **2025-10-17** `1c3cae3a41bc`: 7 info - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/shot_detector_config/max_seconds` request property's max was increased from `60.00` to `120.00` - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/shot_detector_config/min_seconds` request property's max was increased from `60.00` to `120.00` - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/uniform_config/hop_seconds` request property's max was increased from `60.00` to `120.00` - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/uniform_config/window_seconds` request property's max was increased from `60.00` to `120.00` - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/shot_detector_config/max_seconds` request property's min was decreased from `2.00` to `1.00` - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/shot_detector_config/min_seconds` request property's min was decreased from `2.00` to `1.00` - the `allOf[#/components/schemas/FileSegmentationConfig]/segmentation_config/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/describe/post.md) - [API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [Page](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/describe/post)