Dolby

Dolby Monetized Stream V2 API

The Monetized-Stream-V2 API from Dolby — 3 operation(s) for monetized-stream-v2.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/monetized-streams Page through monetized streams · Get monetized streams paginated #
Ask an LLM
“Can I page through my monetized streams with a limit and skip?”
“How do I list monetized streams a batch at a time?”
Tell an agent
List my monetized streams, {limit} per page.
Show monetized streams skipping the first {skip}.
GET /v2/monetized-streams/{monetizedStreamId}/break Page through a stream's ad breaks · Get monetized stream breaks paginated #
Ask an LLM
“Can I paginate the ad breaks on a monetized stream?”
“What's the way to list ad breaks for one stream in pages?”
Tell an agent
List ad breaks on monetized stream {monetizedStreamId}, {limit} at a time.
Show the next page of ad breaks for {monetizedStreamId} after skipping {skip}.
GET /v2/monetized-streams/{monetizedStreamId}/overlay Page through a stream's overlays · Get monetized stream overlays paginated #
Ask an LLM
“Can I paginate the overlay ads on a monetized stream?”
“Which overlays does a stream have, fetched page by page?”
Tell an agent
List overlays on monetized stream {monetizedStreamId}, {limit} at a time.
Show the next page of overlays for {monetizedStreamId} after skipping {skip}.

Documentation

📖
Documentation
https://optiview.dolby.com/docs/theolive/
📖
APIReference
https://optiview.dolby.com/docs/theolive/api/theolive-api/
📖
Authentication
https://optiview.dolby.com/docs/theolive/api/authentication/
📖
Documentation
https://optiview.dolby.com/docs/millicast/
📖
APIReference
https://optiview.dolby.com/docs/millicast/api/millicast-api/
📖
Documentation
https://optiview.dolby.com/docs/ads/
📖
APIReference
https://optiview.dolby.com/docs/ads/api/
📖
Documentation
https://optiview.dolby.com/docs/ad-engine/
📖
APIReference
https://optiview.dolby.com/docs/ad-engine/reference/dolby-optiview-ad-engine/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dolby/refs/heads/main/openapi/dolby-monetized-stream-v2-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/dolby/refs/heads/main/asyncapi/dolby-webhooks.yml
🔗
StatusPage
https://status.theo.live
🔗
ChangeLog
https://optiview.dolby.com/docs/millicast/changelog/changelog-rest-apis/
🔗
StatusPage
https://status.dolby.io

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dolby:dolby-monetized-stream-v2-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dolby-monetized-stream-v2-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: THEOads Monetized Stream V2 API
  version: 25.9.0
  description: The THEOads REST API allows you to create and manage monetized streams, which are deployments of signaling services. Each monetized stream corresponds to an origin stream that is monetized using THEOads (SGAI). For detailed information on the various parameters and their usage, please refer to the getting started guide.
  license:
    name: UNLICENSED
  contact: {}
servers:
- url: /ads-client/api
tags:
- name: Monetized-Stream-V2
paths:
  /v2/monetized-streams:
    get:
      operationId: GetMonetizedStreamsPaginated
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/MonetizedStreamApiResponse'
                - type: string
      tags:
      - Monetized-Stream-V2
      security: []
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          format: double
          type: number
      - in: query
        name: skip
        required: false
        schema:
          format: double
          type: number
      summary: Get monetized streams paginated
      x-summary-source: derived
  /v2/monetized-streams/{monetizedStreamId}/break:
    get:
      operationId: GetMonetizedStreamBreaksPaginated
      responses:
        '200':
          description: A monetized stream
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/AdbreakApiResponse'
                - type: string
      description: Retrieves all adbreaks linked to the monetized stream
      tags:
      - Monetized-Stream-V2
      security: []
      parameters:
      - description: The Monetized stream identifier.
        in: path
        name: monetizedStreamId
        required: true
        schema:
          type: string
      - in: query
        name: limit
        required: false
        schema:
          format: double
          type: number
      - in: query
        name: skip
        required: false
        schema:
          format: double
          type: number
      summary: Get monetized stream breaks paginated
      x-summary-source: derived
  /v2/monetized-streams/{monetizedStreamId}/overlay:
    get:
      operationId: GetMonetizedStreamOverlaysPaginated
      responses:
        '200':
          description: A monetized stream
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/OverlayApiResponse'
                - type: string
      description: Retrieves all overlays linked to the monetized sctream
      tags:
      - Monetized-Stream-V2
      security: []
      parameters:
      - description: The Monetized stream identifier.
        in: path
        name: monetizedStreamId
        required: true
        schema:
          type: string
      - in: query
        name: limit
        required: false
        schema:
          format: double
          type: number
      - in: query
        name: skip
        required: false
        schema:
          format: double
          type: number
      summary: Get monetized stream overlays paginated
      x-summary-source: derived
components:
  schemas:
    IAdBreak:
      properties:
        id:
          type: string
        startDate:
          type: string
        endDate:
          type:
          - string
          - 'null'
          format: date-time
        duration:
          type: number
          format: double
        source:
          type: string
        layout:
          $ref: '#/components/schemas/MonetizedStreamLayout'
        assetURI:
          type: string
        status:
          $ref: '#/components/schemas/SignaledAdBreakStatus'
        asset_key:
          type: string
        network_code:
          type: string
        backdropURI:
          type: string
        backdropURIGamProperties:
          $ref: '#/components/schemas/IGamProperties'
        startPts:
          type: number
          format: double
        name:
          type: string
      required:
      - id
      - startDate
      type: object
      additionalProperties: false
    PaginationDetails:
      properties:
        total_records:
          type: number
          format: double
        current_page:
          type: number
          format: double
        total_pages:
          type: number
          format: double
        next_page:
          type:
          - number
          - 'null'
          format: double
        prev_page:
          type:
          - number
          - 'null'
          format: double
      required:
      - total_records
      - current_page
      - total_pages
      - next_page
      - prev_page
      type: object
      additionalProperties: false
    AdbreakApiResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/IAdBreak'
          type: array
        pagination:
          $ref: '#/components/schemas/PaginationDetails'
      required:
      - data
      - pagination
      type: object
      additionalProperties: false
    MonetizedStreamLayout:
      enum:
      - SINGLE
      - DOUBLE
      - LSHAPE_AD
      - LSHAPE_CONTENT
      type: string
    MonetizedStreamType:
      enum:
      - LIVE
      - VOD
      type: string
    IOverlay:
      properties:
        name:
          type: string
        id:
          type: string
        startDate:
          type: string
        endDate:
          type: string
        duration:
          type: number
          format: double
        type:
          $ref: '#/components/schemas/OverlayTypes'
        position:
          properties:
            bottom:
              type: number
              format: double
            top:
              type: number
              format: double
            right:
              type: number
              format: double
            left:
              type: number
              format: double
          type: object
        size:
          properties:
            height:
              type: number
              format: double
            width:
              type: number
              format: double
          required:
          - height
          - width
          type: object
        opacity:
          type: number
          format: double
        gamProperties:
          $ref: '#/components/schemas/IGamProperties'
        resourceURI:
          items:
            properties:
              tv:
                type: string
              phone:
                type: string
              default:
                type: string
              type:
                $ref: '#/components/schemas/OverlayURITypes'
            required:
            - default
            - type
            type: object
          type: array
        clickThroughURI:
          type: string
      required:
      - id
      - startDate
      - duration
      - type
      - position
      - size
      type: object
      additionalProperties: false
    OverlayTypes:
      enum:
      - image
      type: string
    IMonetizedStream:
      properties:
        name:
          type: string
        version:
          type: string
        streamId:
          type: string
        streamType:
          $ref: '#/components/schemas/MonetizedStreamType'
        origin:
          type: string
        segmentOrigin:
          type: string
        layout:
          $ref: '#/components/schemas/MonetizedStreamLayout'
        assetKey:
          type: string
        networkCode:
          type: string
        originPath:
          type: string
        assetURI:
          type: string
        backdropURI:
          type: string
        backdropURIGamProperties:
          $ref: '#/components/schemas/IGamProperties'
      required:
      - streamId
      - layout
      type: object
      additionalProperties: false
    IGamProperties:
      properties:
        iu:
          type: string
        sz:
          properties:
            tv:
              type: string
            phone:
              type: string
            default:
              type: string
          required:
          - default
          type: object
      required:
      - iu
      - sz
      type: object
      additionalProperties: false
    SignaledAdBreakStatus:
      enum:
      - new
      - future
      - signaled
      - finished
      - error
      - continuous
      type: string
    OverlayApiResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/IOverlay'
          type: array
        pagination:
          $ref: '#/components/schemas/PaginationDetails'
      required:
      - data
      - pagination
      type: object
      additionalProperties: false
    MonetizedStreamApiResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/IMonetizedStream'
          type: array
        pagination:
          $ref: '#/components/schemas/PaginationDetails'
      required:
      - data
      - pagination
      type: object
      additionalProperties: false
    OverlayURITypes:
      enum:
      - png
      - svg
      type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      name: X-API-KEY
      in: header