# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Video Creatives Video Creative Management (V2) API version: 1.0.0 extends: openapi/mediamath-video-creative-management-v2-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 10 - target: $.paths['/video/v2.0/creatives/{video_id}/companions'].get update: x-apievangelist-phrasing: intent: List companion ads for a video creative effect: read questions: - Which companion banners are attached to my video creative? - How do I see a video creative's companions on the deprecated v2 API? instructions: - text: List the companion ads for video creative {video_id}. slots: video_id: path.video_id - text: Show v2 companions attached to video {video_id}. slots: video_id: path.video_id method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/{video_id}/companions'].post update: x-apievangelist-phrasing: intent: Add a companion ad to a video creative effect: write questions: - How do I attach a companion banner to a video creative? - Can I add a companion by resource URL instead of uploading the file? instructions: - text: Add a companion to video creative {video_id} with details {details}. slots: video_id: path.video_id details: requestBody.details - text: Create a companion for video {video_id} from resource URL {resourceUrl}. slots: video_id: path.video_id resourceUrl: requestBody.resourceUrl method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/{video_id}/upload'].post update: x-apievangelist-phrasing: intent: Upload the media file for a video creative effect: write questions: - How do I upload the actual video file for a creative on v2? - Can I set the file name when uploading video media? instructions: - text: Upload a video file for creative {video_id}. slots: video_id: path.video_id - text: Upload {fileName} as the media for video creative {video_id}. slots: fileName: query.fileName video_id: path.video_id method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/{video_id}/variants'].get update: x-apievangelist-phrasing: intent: List encoded variants of a video creative effect: read questions: - What encoded versions were produced for my video creative? - Where are the asset paths for each encoded video variant? instructions: - text: List all encoded variants for video creative {video_id}. slots: video_id: path.video_id - text: Show every variant's asset path and video info for video {video_id}. slots: video_id: path.video_id method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/{video_id}/variants/{variant_id}'].get update: x-apievangelist-phrasing: intent: Get one encoded variant of a video effect: read questions: - How do I look up a single encoded variant of a video creative? - Can I get details for one specific video variant ID? instructions: - text: Get variant {variant_id} of video creative {video_id}. slots: variant_id: path.variant_id video_id: path.video_id - text: Show encoding details for variant {variant_id} on video {video_id}. slots: variant_id: path.variant_id video_id: path.video_id method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/{video_id}/status'].get update: x-apievangelist-phrasing: intent: Check a video creative's upload and encoding status effect: read questions: - Has my video creative finished encoding yet? - What percent of encoding is done for an uploaded video? instructions: - text: Check the upload and encoding status of video {video_id}. slots: video_id: path.video_id - text: Show the encoding percent for video creative {video_id}. slots: video_id: path.video_id method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/{video_id}/companions/{companion_id}/delete'].get update: x-apievangelist-phrasing: intent: Delete a companion ad from a video creative effect: destructive questions: - How do I remove a companion banner from a video creative? - Can I delete one companion without touching the video itself? instructions: - text: Delete companion {companion_id} from video creative {video_id}. slots: companion_id: path.companion_id video_id: path.video_id - text: Remove companion ad {companion_id} on video {video_id}. slots: companion_id: path.companion_id video_id: path.video_id method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/validateVAST'].post update: x-apievangelist-phrasing: intent: Validate VAST XML effect: read questions: - How can I check my VAST XML for errors before trafficking it? - Will the API return warnings as well as errors for my VAST tag? instructions: - text: Validate this VAST XML and report errors or warnings. - text: Check my VAST tag for problems using the v2 validator. method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/{video_id}/vast'].get update: x-apievangelist-phrasing: intent: Get a video creative's VAST XML effect: read questions: - How do I get the VAST XML for one of my video creatives? - Can I download a video creative as XML instead of JSON? instructions: - text: Get the VAST XML for video creative {video_id}. slots: video_id: path.video_id - text: Export video {video_id} as a VAST document. slots: video_id: path.video_id method: generated generated: '2026-10-01' - target: $.paths['/video/v2.0/creatives/{video_id}/vast/extension'].post update: x-apievangelist-phrasing: intent: Add an Extension node to a creative's VAST effect: write questions: - How do I add custom extension XML to a video creative's VAST template? - Can I inject an Extension node into an existing VAST? instructions: - text: Add an Extension node to the VAST of video creative {video_id}. slots: video_id: path.video_id - text: Insert my extension XML into video {video_id}'s VAST template. slots: video_id: path.video_id method: generated generated: '2026-10-01'