Dolby.io Webhooks API

The Webhooks API from Dolby.io — 4 operation(s) for webhooks.

Operations 7

GET /webhooks Get all webhooks #
POST /webhooks Create a new webhook #
GET /webhooks/{id} Get a webhook by ID #
PATCH /webhooks/{id} Update a webhook by ID #
DELETE /webhooks/{id} Delete a webhook by ID #
GET /webhooks/{id}/secret Get a webhook secret #
GET /webhooks/{id}/logs Get webhook logs #

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-io-webhooks-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.

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

OpenAPI Specification

dolby-io-webhooks-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Dolby OptiView THEOlive Webhooks API
  version: v2
  description: REST API for managing OptiView Live (THEOlive) channels, ingests, engines, distributions, analytics, and webhooks.
servers:
- url: https://api.theo.live/v2
  description: V2 API
- url: https://api.theo.live
  description: Base (for /v1 endpoints)
security:
- BasicAuth: []
tags:
- name: Webhooks
paths:
  /webhooks:
    get:
      tags:
      - Webhooks
      operationId: get-webhooks
      summary: Get all webhooks
      responses:
        '200':
          description: List of webhooks
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedWebhookResult'
    post:
      tags:
      - Webhooks
      operationId: create-webhook
      summary: Create a new webhook
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateWebhookBody'
      responses:
        '200':
          description: Webhook created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookObjectResult'
  /webhooks/{id}:
    get:
      tags:
      - Webhooks
      operationId: get-webhook
      summary: Get a webhook by ID
      parameters:
      - schema:
          type: string
          description: Webhook ID
        required: true
        description: Webhook ID
        name: id
        in: path
      responses:
        '200':
          description: The requested webhook
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookObjectResult'
    patch:
      tags:
      - Webhooks
      operationId: update-webhook
      summary: Update a webhook by ID
      parameters:
      - schema:
          type: string
          description: Webhook ID
        required: true
        description: Webhook ID
        name: id
        in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWebhookBody'
      responses:
        '200':
          description: Updated webhook
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookObjectResult'
    delete:
      tags:
      - Webhooks
      operationId: delete-webhook
      summary: Delete a webhook by ID
      parameters:
      - schema:
          type: string
          description: Webhook ID
        required: true
        description: Webhook ID
        name: id
        in: path
      responses:
        '204':
          description: Empty response
  /webhooks/{id}/secret:
    get:
      tags:
      - Webhooks
      operationId: get-webhook-secret
      summary: Get a webhook secret
      parameters:
      - schema:
          type: string
          description: Webhook ID
        required: true
        description: Webhook ID
        name: id
        in: path
      responses:
        '200':
          description: The webhook secret
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookSecretResult'
  /webhooks/{id}/logs:
    get:
      tags:
      - Webhooks
      operationId: get-webhook-logs
      summary: Get webhook logs
      parameters:
      - schema:
          type: string
          description: Webhook ID
        required: true
        description: Webhook ID
        name: id
        in: path
      - schema:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
          description: Start date in 'YYYY-MM-DDTHH:mm:ss.sssZ' format
        required: false
        description: Start date in 'YYYY-MM-DDTHH:mm:ss.sssZ' format
        name: startDate
        in: query
      - schema:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
          description: End date in 'YYYY-MM-DDTHH:mm:ss.sssZ' format
        required: false
        description: End date in 'YYYY-MM-DDTHH:mm:ss.sssZ' format
        name: endDate
        in: query
      - schema:
          type:
          - number
          - 'null'
          maximum: 100
          description: Maximum number of logs to return (max 100)
        required: false
        description: Maximum number of logs to return (max 100)
        name: limit
        in: query
      responses:
        '200':
          description: Webhook logs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedWebhookLogResult'
components:
  schemas:
    WebhookObjectResult:
      type: object
      properties:
        data:
          allOf:
          - $ref: '#/components/schemas/Webhook'
          - description: Webhook object
      required:
      - data
    Webhook:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the webhook
        createdAt:
          type: string
          description: Creation timestamp
        updatedAt:
          type: string
          description: Last update timestamp
        name:
          type: string
          description: Name of the webhook
        active:
          type: boolean
          description: Whether the webhook is active
        description:
          type: string
          description: Description of the webhook
        url:
          type: string
          description: URL to send webhook events to
        events:
          type: array
          items:
            type: string
            enum:
            - '*'
            - channel.created
            - channel.stopped
            - channel.deleted
            - channel.deploying
            - channel.updated
            - webhook.created
            - webhook.updated
            - webhook.deleted
            - scheduler.created
            - scheduler.updated
            - scheduler.deleted
            - scheduler.active
            - scheduler.terminated
            - engine.deploying
            - engine.waiting
            - engine.starting
            - engine.error
            - engine.playing
            - engine.ingesting
            - engine.created
            - engine.updated
            - engine.stopping
            - engine.stopped
            - engine.deleting
            - engine.deleted
            - engine.log.warn
            - engine.log.error
            - engine.log.info
            - ingest.created
            - ingest.updated
            - ingest.deleted
            - distribution.created
            - distribution.enabled
            - distribution.disabled
            - distribution.updated
            - distribution.deleted
            - distribution.security.key.added
            - distribution.security.key.deleted
            - distribution.security.keys.deleted
          description: List of subscribed events. "*" means all events.
      required:
      - id
      - createdAt
      - updatedAt
      - name
      - active
      - url
      - events
    PaginatedWebhookLogResult:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/WebhookLog'
          description: List of webhook logs
        pagination:
          type: object
          properties:
            hasMore:
              type: boolean
              description: Whether more results are available
            cursor:
              type: string
              description: Cursor for the next page of results
          required:
          - hasMore
          - cursor
          description: Pagination info
      required:
      - data
      - pagination
    PaginatedWebhookResult:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Webhook'
          description: List of webhooks
        pagination:
          type: object
          properties:
            hasMore:
              type: boolean
              description: Whether more results are available
            cursor:
              type: string
              description: Cursor for the next page of results
          required:
          - hasMore
          - cursor
          description: Pagination info
      required:
      - data
      - pagination
    CreateWebhookBody:
      type: object
      properties:
        name:
          type: string
          description: Name of the webhook
        description:
          type: string
          description: Description of the webhook
        url:
          type: string
          format: uri
          description: URL to send webhook events to
        events:
          type: array
          items:
            type: string
            enum:
            - '*'
            - channel.created
            - channel.stopped
            - channel.deleted
            - channel.deploying
            - channel.updated
            - webhook.created
            - webhook.updated
            - webhook.deleted
            - scheduler.created
            - scheduler.updated
            - scheduler.deleted
            - scheduler.active
            - scheduler.terminated
            - engine.deploying
            - engine.waiting
            - engine.starting
            - engine.error
            - engine.playing
            - engine.ingesting
            - engine.created
            - engine.updated
            - engine.stopping
            - engine.stopped
            - engine.deleting
            - engine.deleted
            - engine.log.warn
            - engine.log.error
            - engine.log.info
            - ingest.created
            - ingest.updated
            - ingest.deleted
            - distribution.created
            - distribution.enabled
            - distribution.disabled
            - distribution.updated
            - distribution.deleted
            - distribution.security.key.added
            - distribution.security.key.deleted
            - distribution.security.keys.deleted
          minItems: 1
          description: List of events to subscribe to
      required:
      - name
      - url
      - events
      additionalProperties: false
    WebhookLog:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the log entry
        timestamp:
          type: string
          description: Timestamp of the log entry
        type:
          type: string
          enum:
          - '*'
          - channel.created
          - channel.stopped
          - channel.deleted
          - channel.deploying
          - channel.updated
          - webhook.created
          - webhook.updated
          - webhook.deleted
          - scheduler.created
          - scheduler.updated
          - scheduler.deleted
          - scheduler.active
          - scheduler.terminated
          - engine.deploying
          - engine.waiting
          - engine.starting
          - engine.error
          - engine.playing
          - engine.ingesting
          - engine.created
          - engine.updated
          - engine.stopping
          - engine.stopped
          - engine.deleting
          - engine.deleted
          - engine.log.warn
          - engine.log.error
          - engine.log.info
          - ingest.created
          - ingest.updated
          - ingest.deleted
          - distribution.created
          - distribution.enabled
          - distribution.disabled
          - distribution.updated
          - distribution.deleted
          - distribution.security.key.added
          - distribution.security.key.deleted
          - distribution.security.keys.deleted
          description: Event type that triggered the webhook
        statusCode:
          type: number
          description: HTTP status code of the webhook delivery
        requestData:
          type: object
          properties:
            type:
              type: string
              enum:
              - '*'
              - channel.created
              - channel.stopped
              - channel.deleted
              - channel.deploying
              - channel.updated
              - webhook.created
              - webhook.updated
              - webhook.deleted
              - scheduler.created
              - scheduler.updated
              - scheduler.deleted
              - scheduler.active
              - scheduler.terminated
              - engine.deploying
              - engine.waiting
              - engine.starting
              - engine.error
              - engine.playing
              - engine.ingesting
              - engine.created
              - engine.updated
              - engine.stopping
              - engine.stopped
              - engine.deleting
              - engine.deleted
              - engine.log.warn
              - engine.log.error
              - engine.log.info
              - ingest.created
              - ingest.updated
              - ingest.deleted
              - distribution.created
              - distribution.enabled
              - distribution.disabled
              - distribution.updated
              - distribution.deleted
              - distribution.security.key.added
              - distribution.security.key.deleted
              - distribution.security.keys.deleted
              description: Event type
            created:
              type: number
              description: Unix timestamp of when the event was created
            object:
              type: object
              properties:
                type:
                  type: string
                  enum:
                  - channel
                  - ingest
                  - engine
                  - distribution
                  - alias
                  - scheduler
                  description: Type of the related object
                id:
                  type: string
                  description: ID of the related object
                parent:
                  type: object
                  properties:
                    type:
                      type: string
                      enum:
                      - channel
                      - ingest
                      - engine
                      - distribution
                      - alias
                      - scheduler
                      description: Type of the parent object
                    id:
                      type: string
                      description: ID of the parent object
                  required:
                  - type
                  - id
                  description: Parent object reference
                organizationId:
                  type: string
                  description: Organization ID
              required:
              - type
              - id
              - organizationId
              description: Object that triggered the event
            data:
              description: Additional event data
          required:
          - type
          - created
          - object
          description: Request data sent in the webhook delivery
      required:
      - id
      - timestamp
      - type
      - statusCode
      - requestData
    WebhookSecretResult:
      type: object
      properties:
        data:
          type: object
          properties:
            secret:
              type: string
              description: The webhook signing secret
          required:
          - secret
          description: Secret object
      required:
      - data
    UpdateWebhookBody:
      type: object
      properties:
        name:
          type: string
          description: Name of the webhook
        description:
          type: string
          description: Description of the webhook
        url:
          type: string
          format: uri
          description: URL to send webhook events to
        events:
          type: array
          items:
            type: string
            enum:
            - '*'
            - channel.created
            - channel.stopped
            - channel.deleted
            - channel.deploying
            - channel.updated
            - webhook.created
            - webhook.updated
            - webhook.deleted
            - scheduler.created
            - scheduler.updated
            - scheduler.deleted
            - scheduler.active
            - scheduler.terminated
            - engine.deploying
            - engine.waiting
            - engine.starting
            - engine.error
            - engine.playing
            - engine.ingesting
            - engine.created
            - engine.updated
            - engine.stopping
            - engine.stopped
            - engine.deleting
            - engine.deleted
            - engine.log.warn
            - engine.log.error
            - engine.log.info
            - ingest.created
            - ingest.updated
            - ingest.deleted
            - distribution.created
            - distribution.enabled
            - distribution.disabled
            - distribution.updated
            - distribution.deleted
            - distribution.security.key.added
            - distribution.security.key.deleted
            - distribution.security.keys.deleted
          description: List of events to subscribe to
        active:
          type: boolean
          description: Whether the webhook is active
      additionalProperties: false
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic