API Evangelist conversational phrasing for Dolby Channels API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dolby Channels API
  version: 1.0.0
extends: openapi/dolby-channels-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: 71
- target: $.paths['/api/v1/channels'].get
  update:
    x-apievangelist-phrasing:
      intent: List OptiView Ads channels
      effect: read
      questions:
      - Which ad-break channels do I have configured in OptiView Ads?
      - Can I sort my ads channels so the oldest ones come first?
      - Is there an RSQL filter I can apply when listing ads channels?
      instructions:
      - text: List all my OptiView Ads channels.
      - text: List ads channels matching the filter {filter}.
        slots:
          filter: query.filter
      - text: Show page {page} of my ads channels, sorted by {sort}.
        slots:
          page: query.page
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an OptiView Ads channel
      effect: write
      questions:
      - How do I set up a channel for scheduling ad breaks in OptiView Ads?
      - Can I choose wallclock or PTS timing when I create an ads channel?
      - What DVR window and ad prefetch settings can a new ads channel start with?
      instructions:
      - text: Create an ads channel named {name} using the {timebase} timebase.
        slots:
          name: requestBody.name
          timebase: requestBody.timebase
      - text: Set up a new ad-break channel with a {timebase} timebase and a DVR window of {dvrWindowMs} ms.
        slots:
          timebase: requestBody.timebase
          dvrWindowMs: requestBody.dvrWindowMs
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one OptiView Ads channel
      effect: read
      questions:
      - What timebase and polling intervals does one of my ads channels use?
      - Can I look up a single ad-break channel's delivery steering rules?
      instructions:
      - text: Show the ads channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Get the break-scheduling settings of ads channel {channelId}.
        slots:
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an OptiView Ads channel
      effect: destructive
      questions:
      - How do I remove an ad-break channel I no longer use?
      - Can I delete an OptiView Ads channel by its identifier?
      instructions:
      - text: Delete the ads channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Remove ad-break channel {channelId} permanently.
        slots:
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an OptiView Ads channel
      effect: write
      questions:
      - Can I change how far ahead breaks are prefetched on an existing ads channel?
      - How do I adjust the player polling intervals for an ad-break channel?
      instructions:
      - text: Set the ad prefetch window of ads channel {channelId} to {adPrefetchMs} ms.
        slots:
          channelId: path.channelId
          adPrefetchMs: requestBody.adPrefetchMs
      - text: Change the live offset of ads channel {channelId} to {liveOffsetMs} ms.
        slots:
          channelId: path.channelId
          liveOffsetMs: requestBody.liveOffsetMs
      - text: Rename ad-break channel {channelId} to {name}.
        slots:
          channelId: path.channelId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/detection/enable'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn on automatic ad-break detection
      effect: write
      questions:
      - How do I start automatic ad-break detection on a channel?
      - Can OptiView Ads detect breaks from stream markers on its own?
      instructions:
      - text: Enable automatic break detection on ads channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Start the detection scheduler for channel {channelId}.
        slots:
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/detection/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn off automatic ad-break detection
      effect: write
      questions:
      - How do I stop a channel from detecting ad breaks automatically?
      - Can I pause marker-based break detection on one channel?
      instructions:
      - text: Disable automatic break detection on ads channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Stop the detection scheduler for channel {channelId}.
        slots:
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/breaks'].get
  update:
    x-apievangelist-phrasing:
      intent: List ad breaks on a channel
      effect: read
      questions:
      - What ad breaks are scheduled on my channel?
      - Can I filter a channel's breaks by status, such as only READY ones?
      instructions:
      - text: List the ad breaks on channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Show breaks on channel {channelId} matching {filter}.
        slots:
          channelId: path.channelId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/breaks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an ad break on a channel
      effect: write
      questions:
      - How do I insert a new ad break into a channel?
      - Can I base a new ad break on an existing template?
      instructions:
      - text: Create an ad break on channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Add a new break to channel {channelId} from a break template.
        slots:
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/breaks'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete ad breaks
      effect: destructive
      questions:
      - Can I delete several ad breaks from a channel in one request?
      - How do I clear out a batch of breaks by their IDs?
      instructions:
      - text: Delete breaks {ids} from channel {channelId}.
        slots:
          ids: requestBody.ids
          channelId: path.channelId
      - text: Bulk remove the ad breaks {ids} on channel {channelId}.
        slots:
          ids: requestBody.ids
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/breaks/{breakId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one ad break
      effect: read
      questions:
      - What are the details and status of a specific ad break?
      - Can I check whether one break on a channel is still CUED?
      instructions:
      - text: Show break {breakId} on channel {channelId}.
        slots:
          breakId: path.breakId
          channelId: path.channelId
      - text: Get the status of ad break {breakId} in channel {channelId}.
        slots:
          breakId: path.breakId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/breaks/{breakId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single ad break
      effect: destructive
      questions:
      - How do I cancel one scheduled ad break?
      - Can I remove just a single break from a channel?
      instructions:
      - text: Delete ad break {breakId} from channel {channelId}.
        slots:
          breakId: path.breakId
          channelId: path.channelId
      - text: Cancel the single break {breakId} on channel {channelId}.
        slots:
          breakId: path.breakId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/breaks/{breakId}/punch'].post
  update:
    x-apievangelist-phrasing:
      intent: Punch a cued ad break to ready
      effect: write
      questions:
      - How do I trigger a cued ad break so it plays now?
      - Can I punch a break in at a specific start time instead of immediately?
      - What happens if I punch a break with a start time in the past?
      instructions:
      - text: Punch break {breakId} on channel {channelId} now.
        slots:
          breakId: path.breakId
          channelId: path.channelId
      - text: Schedule cued break {breakId} on channel {channelId} to start at {start}.
        slots:
          breakId: path.breakId
          channelId: path.channelId
          start: requestBody.start
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events on a channel
      effect: read
      questions:
      - Which events like games or shows are set up on my ads channel?
      - Can I sort a channel's events by start date?
      instructions:
      - text: List the events on channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Show events on channel {channelId} sorted by {sort}.
        slots:
          channelId: path.channelId
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an event on a channel
      effect: write
      questions:
      - How do I define an event window that ad breaks must fall within?
      - Can I give an event a description along with its start and end time?
      instructions:
      - text: Create event {name} on channel {channelId} from {startDate} to {endDate}.
        slots:
          name: requestBody.name
          channelId: path.channelId
          startDate: requestBody.startDate
          endDate: requestBody.endDate
      - text: Add an event called {name} to channel {channelId} running {startDate} until {endDate}, described as {description}.
        slots:
          name: requestBody.name
          channelId: path.channelId
          startDate: requestBody.startDate
          endDate: requestBody.endDate
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete events on a channel
      effect: destructive
      questions:
      - Can I delete several channel events at once?
      - How do I remove a list of events by their IDs?
      instructions:
      - text: Delete events {ids} from channel {channelId}.
        slots:
          ids: requestBody.ids
          channelId: path.channelId
      - text: Bulk remove the events {ids} on channel {channelId}.
        slots:
          ids: requestBody.ids
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events/{eventId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one event on a channel
      effect: read
      questions:
      - When does a particular event on my channel start and end?
      - Can I look up a single event's description?
      instructions:
      - text: Show event {eventId} on channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      - text: Get the start and end time of event {eventId} in channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events/{eventId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single event
      effect: destructive
      questions:
      - How do I remove one event from an ads channel?
      - Can I delete just one event and keep the others?
      instructions:
      - text: Delete event {eventId} from channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      - text: Remove the single event {eventId} on channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events/{eventId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an event's details or window
      effect: write
      questions:
      - Can I extend an event's end time after it has been created?
      - How do I rename an existing event on a channel?
      instructions:
      - text: Change the end date of event {eventId} on channel {channelId} to {endDate}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
          endDate: requestBody.endDate
      - text: Rename event {eventId} in channel {channelId} to {name}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events/{eventId}/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List templates linked to an event
      effect: read
      questions:
      - Which break templates are associated with an event?
      - Can I see what templates an event can use for its breaks?
      instructions:
      - text: List the templates linked to event {eventId} on channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      - text: Show break templates for event {eventId} in channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events/{eventId}/templates/{templateId}/breaks'].get
  update:
    x-apievangelist-phrasing:
      intent: List breaks made from a template in an event
      effect: read
      questions:
      - Which breaks during an event were created from one particular template?
      - Can I see how many times a template was used for breaks in an event?
      instructions:
      - text: List breaks created from template {templateId} during event {eventId} on channel {channelId}.
        slots:
          templateId: path.templateId
          eventId: path.eventId
          channelId: path.channelId
      - text: Show event {eventId} breaks on channel {channelId} that came from template {templateId}.
        slots:
          templateId: path.templateId
          eventId: path.eventId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events/{eventId}/breaks'].get
  update:
    x-apievangelist-phrasing:
      intent: List all breaks in an event
      effect: read
      questions:
      - What ad breaks belong to an event, regardless of template?
      - Can I page through every break associated with an event?
      instructions:
      - text: List all breaks in event {eventId} on channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      - text: Show page {page} of event {eventId} breaks for channel {channelId}.
        slots:
          page: query.page
          eventId: path.eventId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/events/{eventId}/breaks/current'].get
  update:
    x-apievangelist-phrasing:
      intent: Get breaks playing now in an event
      effect: read
      questions:
      - Which ad breaks are playing right now during an event?
      - Is an event-triggered break currently active for my event?
      instructions:
      - text: Show the breaks currently playing in event {eventId} on channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      - text: Check what is on air right now for event {eventId} in channel {channelId}.
        slots:
          eventId: path.eventId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/markerRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List marker rules on a channel
      effect: read
      questions:
      - Which HLS marker rules turn stream cues into ad breaks on my channel?
      - Can I filter a channel's marker rules to only the enabled ones?
      instructions:
      - text: List the marker rules on channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Show marker rules on channel {channelId} matching {filter}.
        slots:
          channelId: path.channelId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/markerRules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a marker rule for break detection
      effect: write
      questions:
      - How do I map an EXT-X-CUE or DATERANGE marker to a break template?
      - Can a marker rule require several attribute conditions to match?
      instructions:
      - text: Create a {type} marker rule on channel {channelId} for {streamType} that applies template {templateId} when {conditions} match.
        slots:
          type: requestBody.type
          channelId: path.channelId
          streamType: requestBody.streamType
          templateId: requestBody.templateId
          conditions: requestBody.conditions
      - text: Add an HLS DATERANGE rule to channel {channelId} using template {templateId}, stream type {streamType}, type {type} and conditions {conditions}.
        slots:
          channelId: path.channelId
          templateId: requestBody.templateId
          streamType: requestBody.streamType
          type: requestBody.type
          conditions: requestBody.conditions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/markerRules'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete marker rules
      effect: destructive
      questions:
      - Can I delete several marker rules from a channel at once?
      - How do I remove a set of break-detection rules by ID?
      instructions:
      - text: Delete marker rules {ids} from channel {channelId}.
        slots:
          ids: requestBody.ids
          channelId: path.channelId
      - text: Bulk remove the detection rules {ids} on channel {channelId}.
        slots:
          ids: requestBody.ids
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/markerRules/{markerRuleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one marker rule
      effect: read
      questions:
      - What conditions does a particular marker rule match on?
      - Which template does a given marker rule apply?
      instructions:
      - text: Show marker rule {markerRuleId} on channel {channelId}.
        slots:
          markerRuleId: path.markerRuleId
          channelId: path.channelId
      - text: Get the conditions of detection rule {markerRuleId} in channel {channelId}.
        slots:
          markerRuleId: path.markerRuleId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/markerRules/{markerRuleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single marker rule
      effect: destructive
      questions:
      - How do I remove one marker rule from a channel?
      - Can I delete a single break-detection rule and keep the rest?
      instructions:
      - text: Delete marker rule {markerRuleId} from channel {channelId}.
        slots:
          markerRuleId: path.markerRuleId
          channelId: path.channelId
      - text: Remove the single detection rule {markerRuleId} on channel {channelId}.
        slots:
          markerRuleId: path.markerRuleId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/markerRules/{markerRuleId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a marker rule
      effect: write
      questions:
      - Can I switch off a marker rule without deleting it?
      - How do I point an existing marker rule at a different template?
      instructions:
      - text: Set enabled to {enabled} on marker rule {markerRuleId} of channel {channelId}.
        slots:
          enabled: requestBody.enabled
          markerRuleId: path.markerRuleId
          channelId: path.channelId
      - text: Change marker rule {markerRuleId} on channel {channelId} to use template {templateId}.
        slots:
          markerRuleId: path.markerRuleId
          channelId: path.channelId
          templateId: requestBody.templateId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/detection/history'].get
  update:
    x-apievangelist-phrasing:
      intent: List detected ad-marker history
      effect: read
      questions:
      - Which ad markers has break detection found on my channel, and what did it do with them?
      - Can I see why some detected markers were skipped or failed?
      instructions:
      - text: Show the marker detection history for channel {channelId}.
        slots:
          channelId: path.channelId
      - text: List detected markers on channel {channelId} matching {filter}.
        slots:
          channelId: path.channelId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/detection/history/{markerDetectionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one marker detection record
      effect: read
      questions:
      - Which rule and break resulted from one specific detected marker?
      - Can I look up the reason a single marker detection was skipped?
      instructions:
      - text: Show detection record {markerDetectionId} on channel {channelId}.
        slots:
          markerDetectionId: path.markerDetectionId
          channelId: path.channelId
      - text: Get the outcome of marker detection {markerDetectionId} in channel {channelId}.
        slots:
          markerDetectionId: path.markerDetectionId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/integrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a channel's integrations
      effect: read
      questions:
      - Which ad-server integrations are attached to one of my ads channels?
      - Can I page through the channel-level integrations of a channel?
      instructions:
      - text: List the integrations on ads channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Show channel-level integrations for {channelId} sorted by {sort}.
        slots:
          channelId: path.channelId
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/integrations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a channel integration
      effect: write
      questions:
      - How do I connect an integration to a single ads channel?
      - Can I add a channel-level integration separate from my organization one?
      instructions:
      - text: Create an integration on ads channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Attach a new channel-level integration to channel {channelId}.
        slots:
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/integrations/{channelIntegrationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one channel integration
      effect: read
      questions:
      - How is a specific integration on my channel configured?
      - Can I inspect one channel-level integration by its ID?
      instructions:
      - text: Show integration {channelIntegrationId} on channel {channelId}.
        slots:
          channelIntegrationId: path.channelIntegrationId
          channelId: path.channelId
      - text: Get the configuration of channel integration {channelIntegrationId} in {channelId}.
        slots:
          channelIntegrationId: path.channelIntegrationId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/integrations/{channelIntegrationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a channel integration
      effect: destructive
      questions:
      - How do I disconnect an integration from one ads channel?
      - Can I remove a channel-level integration without touching the organization one?
      instructions:
      - text: Delete integration {channelIntegrationId} from channel {channelId}.
        slots:
          channelIntegrationId: path.channelIntegrationId
          channelId: path.channelId
      - text: Remove channel integration {channelIntegrationId} on ads channel {channelId}.
        slots:
          channelIntegrationId: path.channelIntegrationId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/integrations/{channelIntegrationId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a channel integration
      effect: write
      questions:
      - Can I change the settings of an integration attached to my channel?
      - How do I edit a channel-level integration in place?
      instructions:
      - text: Update integration {channelIntegrationId} on channel {channelId}.
        slots:
          channelIntegrationId: path.channelIntegrationId
          channelId: path.channelId
      - text: Edit the settings of channel integration {channelIntegrationId} for ads channel {channelId}.
        slots:
          channelIntegrationId: path.channelIntegrationId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/origins'].get
  update:
    x-apievangelist-phrasing:
      intent: List stream origins on a channel
      effect: read
      questions:
      - Which manifest origins does break detection poll for my channel?
      - Can I sort a channel's origins by failover priority?
      instructions:
      - text: List the origins on channel {channelId}.
        slots:
          channelId: path.channelId
      - text: Show origins for channel {channelId} sorted by {sort}.
        slots:
          channelId: path.channelId
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/origins'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a stream origin to a channel
      effect: write
      questions:
      - How do I give break detection a manifest URL to poll?
      - Can I add a backup DASH or HLS origin with a failover priority?
      instructions:
      - text: Add a {type} origin at {url} to channel {channelId}.
        slots:
          type: requestBody.type
          url: requestBody.url
          channelId: path.channelId
      - text: Create a {type} origin {url} on channel {channelId} with failover priority {priority}.
        slots:
          type: requestBody.type
          url: requestBody.url
          channelId: path.channelId
          priority: requestBody.priority
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/origins/{originId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one stream origin
      effect: read
      questions:
      - What manifest URL and format does one origin on my channel use?
      - Is a particular origin enabled for failover?
      instructions:
      - text: Show origin {originId} on channel {channelId}.
        slots:
          originId: path.originId
          channelId: path.channelId
      - text: Get the manifest URL of origin {originId} in channel {channelId}.
        slots:
          originId: path.originId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/origins/{originId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a stream origin
      effect: destructive
      questions:
      - How do I remove a manifest origin from a channel for good?
      - Can I delete an origin instead of just disabling it?
      instructions:
      - text: Delete origin {originId} from channel {channelId}.
        slots:
          originId: path.originId
          channelId: path.channelId
      - text: Permanently remove stream origin {originId} on channel {channelId}.
        slots:
          originId: path.originId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/origins/{originId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a stream origin
      effect: write
      questions:
      - Can I change an origin's manifest URL without recreating it?
      - How do I reorder an origin's failover priority?
      instructions:
      - text: Change the URL of origin {originId} on channel {channelId} to {url}.
        slots:
          originId: path.originId
          channelId: path.channelId
          url: requestBody.url
      - text: Set origin {originId} in channel {channelId} to failover priority {priority}.
        slots:
          originId: path.originId
          channelId: path.channelId
          priority: requestBody.priority
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/origins/{originId}/enable'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable a stream origin
      effect: write
      questions:
      - How do I bring a disabled origin back into break-detection failover?
      - Can I re-enable an origin I switched off earlier?
      instructions:
      - text: Enable origin {originId} on channel {channelId}.
        slots:
          originId: path.originId
          channelId: path.channelId
      - text: Turn stream origin {originId} back on for channel {channelId}.
        slots:
          originId: path.originId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/channels/{channelId}/origins/{originId}/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable a stream origin
      effect: write
      questions:
      - How do I take an origin out of failover without deleting it?
      - Can I temporarily stop detection from polling one origin?
      instructions:
      - text: Disable origin {originId} on channel {channelId}.
        slots:
          originId: path.originId
          channelId: path.channelId
      - text: Switch off stream origin {originId} for channel {channelId}.
        slots:
          originId: path.originId
          channelId: path.channelId
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dolby/refs/heads/main/overlays/dolby-channels-api-phrasing-overlay.yaml