--- title: "Changes to Get a directive" method: GET path: "/robots/v0/directives/{DIRECTIVE_ID}" --- # Changes to Get a directive `GET /robots/v0/directives/{DIRECTIVE_ID}` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 54 revisions. - **2026-10-26** `151835caff06`: 1 info - **2026-10-23** `ed6cb570d60c`: 1 breaking, 2 info - **2026-10-19** `7e2e5079412d`: 2 breaking, 19 info - **2026-10-08** `296f0b01bb84`: 19 info - **2026-10-02** `90f16ccd8b65`: 4 breaking, 3 warning, 9 info - **2026-09-28** `b57bb059a052`: 7 info - **2026-09-17** `68a2dd0743bf`: 2 info - **2026-08-19** `a1c396b68b19`: 1 info - **2026-08-12** `5b4b3133f27d`: 1 info ## Changes - **2026-10-26** `151835caff06`: 1 info - endpoint deprecated - **2026-10-23** `ed6cb570d60c`: 1 breaking, 2 info - added `#/components/schemas/AnalyzeStructureBindingV0, #/components/schemas/GenerateContextualTextBindingV0` to the `data/workflows/items/` response property `oneOf` list for the response status `200` - the `language_code` response's property default value `en` was removed for the status `200` - added `analyze-structure, generate-contextual-text` discriminator mapping keys to the `data/workflows/items/` response property for the response status `200` - **2026-10-19** `7e2e5079412d`: 2 breaking, 19 info - added `#/components/schemas/SummarizeBindingV0, #/components/schemas/ModerateBindingV0, #/components/schemas/GenerateChaptersBindingV0, #/components/schemas/FindScenesBindingV0, #/components/schemas/EditCaptionsBindingV0, #/components/schemas/TranslateCaptionsBindingV0, #/components/schemas/TranslateAudioBindingV0, #/components/schemas/AskQuestionsBindingV0, #/components/schemas/FindKeyMomentsBindingV0, #/components/schemas/GenerateEngagementInsightsBindingV0, #/components/schemas/GeneratePremiumCaptionsBindingV0, #/components/schemas/FindBestThumbnailsBindingV0` to the `data/workflows/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/TrackResourceDeclarationV0, #/components/schemas/ShotsResourceDeclarationV0` to the `data/resources/items/` response property `oneOf` list for the response status `200` - api operation id `get-directive` removed and replaced with `get-directive-v0` - api tag `Directives (v0)` added - api tag `Directives` removed - mapped value for discriminator key `ask-questions` changed from `#/components/schemas/AskQuestionsBinding` to `#/components/schemas/AskQuestionsBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `edit-captions` changed from `#/components/schemas/EditCaptionsBinding` to `#/components/schemas/EditCaptionsBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `find-best-thumbnails` changed from `#/components/schemas/FindBestThumbnailsBinding` to `#/components/schemas/FindBestThumbnailsBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `find-key-moments` changed from `#/components/schemas/FindKeyMomentsBinding` to `#/components/schemas/FindKeyMomentsBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `find-scenes` changed from `#/components/schemas/FindScenesBinding` to `#/components/schemas/FindScenesBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `generate-chapters` changed from `#/components/schemas/GenerateChaptersBinding` to `#/components/schemas/GenerateChaptersBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `generate-engagement-insights` changed from `#/components/schemas/GenerateEngagementInsightsBinding` to `#/components/schemas/GenerateEngagementInsightsBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `generate-premium-captions` changed from `#/components/schemas/GeneratePremiumCaptionsBinding` to `#/components/schemas/GeneratePremiumCaptionsBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `moderate` changed from `#/components/schemas/ModerateBinding` to `#/components/schemas/ModerateBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `summarize` changed from `#/components/schemas/SummarizeBinding` to `#/components/schemas/SummarizeBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `translate-audio` changed from `#/components/schemas/TranslateAudioBinding` to `#/components/schemas/TranslateAudioBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `translate-captions` changed from `#/components/schemas/TranslateCaptionsBinding` to `#/components/schemas/TranslateCaptionsBindingV0` for `data/workflows/items/` response property for the response status `200` - mapped value for discriminator key `video.asset.shots` changed from `#/components/schemas/ShotsResourceDeclaration` to `#/components/schemas/ShotsResourceDeclarationV0` for `data/resources/items/` response property for the response status `200` - mapped value for discriminator key `video.asset.track` changed from `#/components/schemas/TrackResourceDeclaration` to `#/components/schemas/TrackResourceDeclarationV0` for `data/resources/items/` response property for the response status `200` - removed `#/components/schemas/SummarizeBinding, #/components/schemas/ModerateBinding, #/components/schemas/GenerateChaptersBinding, #/components/schemas/FindScenesBinding, #/components/schemas/EditCaptionsBinding, #/components/schemas/TranslateCaptionsBinding, #/components/schemas/TranslateAudioBinding, #/components/schemas/AskQuestionsBinding, #/components/schemas/FindKeyMomentsBinding, #/components/schemas/GenerateEngagementInsightsBinding, #/components/schemas/GeneratePremiumCaptionsBinding, #/components/schemas/FindBestThumbnailsBinding` from the `data/workflows/items/` response property `oneOf` list for the response status `200` - removed `#/components/schemas/TrackResourceDeclaration, #/components/schemas/ShotsResourceDeclaration` from the `data/resources/items/` response property `oneOf` list for the response status `200` - **2026-10-08** `296f0b01bb84`: 19 info - added the non-success response with the status `422` - added the optional property `error/messages` to the response with the `401` status - added the optional property `error/messages` to the response with the `403` status - added the optional property `error/messages` to the response with the `404` status - added the optional property `error/messages` to the response with the `500` status - the `image_source` response's property default value `create_storyboards` was added for the status `200` - the `image_source` response's property default value `create_storyboards` was added for the status `200` - the `language_code` response's property default value `auto` was added for the status `200` - the `language_code` response's property default value `auto` was added for the status `200` - the `max_thumbnails` response's property default value `5` was added for the status `200` - the `replace_existing_tracks` response's property default value `fail` was added for the status `200` - the `replace_existing_tracks` response's property default value `fail` was added for the status `200` - the `replace_existing_tracks` response's property default value `fail` was added for the status `200` - the `replace_existing_tracks` response's property default value `replace` was added for the status `200` - the `tag_count` response's property default value `10` was added for the status `200` - response property `error/message` deprecated - response property `error/message` deprecated - response property `error/message` deprecated - response property `error/message` deprecated - **2026-10-02** `90f16ccd8b65`: 4 breaking, 3 warning, 9 info - the `data/workflows/items/oneOf[subschema #1: SummarizeBinding]/params/output_steering/scope` response's property type changed from `object` to no type for status `200` - the `data/workflows/items/oneOf[subschema #4: FindScenesBinding]/params/output_steering/topic_taxonomy` response's property type changed from `object` to no type for status `200` - removed the required property `data/workflows/items/oneOf[subschema #4: FindScenesBinding]/params/output_steering/topic_taxonomy/allow_other` from the response with the `200` status - removed the required property `data/workflows/items/oneOf[subschema #4: FindScenesBinding]/params/output_steering/topic_taxonomy/values` from the response with the `200` status - removed the optional property `data/workflows/items/oneOf[subschema #1: SummarizeBinding]/params/output_steering/scope/end_time` from the response with the `200` status - removed the optional property `data/workflows/items/oneOf[subschema #1: SummarizeBinding]/params/output_steering/scope/start_time` from the response with the `200` status - removed the optional property `data/workflows/items/oneOf[subschema #4: FindScenesBinding]/params/output_steering/topic_taxonomy/name` from the response with the `200` status - added the optional property `data/workflows/items/oneOf[subschema #5: EditCaptionsBinding]/params/replace_existing_tracks` to the response with the `200` status - added the optional property `data/workflows/items/oneOf[subschema #5: EditCaptionsBinding]/params/track_name` to the response with the `200` status - added the optional property `data/workflows/items/oneOf[subschema #6: TranslateCaptionsBinding]/params/track_name` to the response with the `200` status - added the optional property `data/workflows/items/oneOf[subschema #7: TranslateAudioBinding]/params/track_name` to the response with the `200` status - added `#/components/schemas/OutputSteeringScope, subschema #2` to the `data/workflows/items/oneOf[subschema #1: SummarizeBinding]/params/output_steering/scope` response property `allOf` list for the response status `200` - added `#/components/schemas/OutputSteeringTaxonomy, subschema #2` to the `data/workflows/items/oneOf[subschema #4: FindScenesBinding]/params/output_steering/topic_taxonomy` response property `allOf` list for the response status `200` - the `delete_original_track` response's property default value `true` was removed for the status `200` - response property `data/workflows/items/oneOf[subschema #5: EditCaptionsBinding]/params/delete_original_track` deprecated - response property `data/workflows/items/oneOf[subschema #5: EditCaptionsBinding]/params/track_name_suffix` deprecated - **2026-09-28** `b57bb059a052`: 7 info - added the optional property `data/workflows/items/oneOf[subschema #11: GeneratePremiumCaptionsBinding]/params/replace_existing_tracks` to the response with the `200` status - added the optional property `data/workflows/items/oneOf[subschema #6: TranslateCaptionsBinding]/params/replace_existing_tracks` to the response with the `200` status - added the optional property `data/workflows/items/oneOf[subschema #7: TranslateAudioBinding]/params/replace_existing_tracks` to the response with the `200` status - the `replace_existing` response's property default value `false` was removed for the status `200` - response property `data/workflows/items/oneOf[subschema #11: GeneratePremiumCaptionsBinding]/params/replace_existing` deprecated - response property `data/workflows/items/oneOf[subschema #1: SummarizeBinding]/params/prompt_overrides` deprecated - response property `data/workflows/items/oneOf[subschema #3: GenerateChaptersBinding]/params/prompt_overrides` deprecated - **2026-09-17** `68a2dd0743bf`: 2 info - added the optional property `data/workflows/items/oneOf[subschema #3: GenerateChaptersBinding]/params/update_asset_chapters` to the response with the `200` status - added the optional property `data/workflows/items/oneOf[subschema #5: EditCaptionsBinding]/params/speaker_replacements` to the response with the `200` status - **2026-08-19** `a1c396b68b19`: 1 info - added the optional property `data/workflows/items/oneOf[subschema #6: TranslateCaptionsBinding]/params/never_translate` to the response with the `200` status - **2026-08-12** `5b4b3133f27d`: 1 info - endpoint added --- [Operation](https://skmtc.dev/muxinc/apis/mux-api/docs/robots/v0/directives/:DIRECTIVE_ID/get.md) - [API](https://skmtc.dev/muxinc/apis/mux-api.md) - [Page](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v0/directives/:DIRECTIVE_ID/get)