Mux

Mux Incidents API

Incidents occur when an anomaly alert is triggered in Mux Data. The Incidents API provides operations related to the raising and managing of alerting incidents.

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 /data/v1/incidents List video quality incidents · List Incidents #
Ask an LLM
“Are there any open playback incidents affecting my viewers right now?”
“Can I list incidents by severity or status?”
Tell an agent
List my incidents.
List {status} incidents with severity {severity}.
GET /data/v1/incidents/{INCIDENT_ID} Get an incident's details · Get an Incident #
Ask an LLM
“What happened during a specific playback incident?”
“Can I look up one incident by its ID?”
Tell an agent
Show incident {incident_id}.
Get the details of incident {incident_id}.

Documentation

📖
Documentation
https://www.mux.com/docs/core/stream-video-files
📖
APIReference
https://www.mux.com/docs/api-reference
📖
Documentation
https://www.mux.com/docs/guides/start-live-streaming
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Live-Streams
📖
Documentation
https://www.mux.com/docs/core/monitor-your-video-streaming-performance
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Video-Views
📖
Documentation
https://www.mux.com/docs/guides/play-your-videos
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Streaming
📖
Documentation
https://www.mux.com/docs/guides/get-images-from-a-video
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Thumbnails
📖
Documentation
https://www.mux.com/docs/guides/mux-robots
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Jobs
📖
Documentation
https://www.mux.com/docs/guides/signing-jwts
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Signing-Keys

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mux-com/refs/heads/main/openapi/mux-com-incidents-api-openapi.yml

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/mux-com:mux-com-incidents-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

mux-com-incidents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mux Incidents API
  description: Mux is how developers build online video. This API encompasses both Mux Video and Mux Data functionality to help you build your video-related projects better and faster than ever before.
  version: v1
  contact:
    name: Mux DevEx
    url: https://docs.mux.com
    email: devex@mux.com
servers:
- url: https://api.mux.com
  description: Mux Production API
- url: https://image.mux.com
- url: https://stream.mux.com
- url: https://stats.mux.com
tags:
- name: Incidents
  description: Incidents occur when an anomaly alert is triggered in Mux Data. The Incidents API provides operations related to the raising and managing of alerting incidents.
  x-displayName: Incidents
paths:
  /data/v1/incidents:
    get:
      tags:
      - Incidents
      summary: List Incidents
      description: Returns a list of incidents.
      operationId: list-incidents
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/order_by'
      - $ref: '#/components/parameters/order_direction'
      - $ref: '#/components/parameters/incident_status'
      - $ref: '#/components/parameters/severity'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListIncidentsResponse'
              example:
                data:
                - affected_views: 71
                  affected_views_per_hour: 29
                  affected_views_per_hour_on_open: 75
                  breakdowns:
                  - id: abcdef
                    name: error_type_id
                    value: '697070'
                  description: Something is broken
                  error_description: No seriously, something is really really broken :(
                  id: 4u13td
                  impact: '*71 views* were affected at a rate of *29 per hour*'
                  incident_key: 5312a7c0bbb5d8353bd88602f01fe58eb15e9febac8fd2f0d8ce8f1cb138145c
                  measured_value: 5.9
                  measured_value_on_close: 0.1
                  measurement: error_rate
                  notification_rules: []
                  notifications:
                  - attempted_at: '2021-01-05T09:52:15.119040Z'
                    id: 103014
                    queued_at: '2021-01-05T09:52:14.945157Z'
                  - attempted_at: '2021-01-05T11:31:08.244462Z'
                    id: 102025
                    queued_at: '2021-01-05T11:31:08.061924Z'
                  resolved_at: '2021-01-05T11:31:04.000000Z'
                  sample_size: 1000
                  sample_size_unit: views
                  severity: alert
                  started_at: '2021-01-05T09:04:46.000000Z'
                  status: closed
                  threshold: 5
                - affected_views: 132
                  affected_views_per_hour: 11
                  affected_views_per_hour_on_open: 65
                  breakdowns:
                  - id: abcdef
                    name: video_title
                    value: Layla the dog video 1337
                  - id: abcdef
                    name: error_type_id
                    value: '697065'
                  description: Something else is broken
                  error_description: 'Detailed error: On no!'
                  id: rd9579
                  impact: '*132 views* were affected at a rate of *11 per hour*'
                  incident_key: fd9add7a85a013d768f4039f9e726133eddb476c2f16b22ebfe56f18f7c03b27
                  measured_value: 97
                  measured_value_on_close: 1
                  measurement: error_rate
                  notification_rules: []
                  notifications:
                  - attempted_at: '2020-12-31T09:26:19.416919Z'
                    id: 102198
                    queued_at: '2020-12-31T09:26:18.987717Z'
                  - attempted_at: '2020-12-31T20:23:57.279325Z'
                    id: 101269
                    queued_at: '2020-12-31T20:23:56.997068Z'
                  resolved_at: '2020-12-31T20:22:54.000000Z'
                  sample_size: 100
                  sample_size_unit: views
                  severity: alert
                  started_at: '2020-12-31T07:56:22.000000Z'
                  status: closed
                  threshold: 96
                timeframe:
                - 1610035979
                - 1610122379
                total_row_count: 2
      security:
      - accessToken: []
      - authorizationToken: []
  /data/v1/incidents/{INCIDENT_ID}:
    get:
      tags:
      - Incidents
      summary: Get an Incident
      description: Returns the details of an incident.
      operationId: get-incident
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/incident_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IncidentResponse'
              example:
                data:
                  affected_views: 2026
                  affected_views_per_hour: 84
                  affected_views_per_hour_on_open: 12857
                  breakdowns:
                  - id: abcdef
                    name: error_type_id
                    value: '499680'
                  - id: abcdef
                    name: video_title
                    value: Cute dogs
                  description: This video is erroring a lot
                  error_description: Error Type ID 499680
                  id: g7q2df
                  impact: '*2026 views* were affected at a rate of *84 per hour*'
                  incident_key: 045dfcbefdb68c6003aaf3bf5ed217493772519f28f14d129f95eaff159ea6d6b
                  measured_value: 100
                  measured_value_on_close: 8
                  measurement: error_rate
                  notification_rules: []
                  notifications:
                  - attempted_at: '2020-05-14T17:23:08.034662Z'
                    id: 63293
                    queued_at: '2020-05-14T17:23:07.944457Z'
                  - attempted_at: '2020-05-13T17:22:30.444389Z'
                    id: 62212
                    queued_at: '2020-05-13T17:22:30.354828Z'
                  resolved_at: '2020-05-14T17:22:30.000000Z'
                  sample_size: 100
                  sample_size_unit: views
                  severity: alert
                  started_at: '2020-05-13T17:21:54.000000Z'
                  status: closed
                  threshold: 100
                timeframe:
                - 1610036456
                - 1610122856
                total_row_count: 1
      security:
      - accessToken: []
      - authorizationToken: []
  /data/v1/incidents/{INCIDENT_ID}/related:
    get:
      tags:
      - Incidents
      summary: List Related Incidents
      description: Returns all the incidents that seem related to a specific incident.
      operationId: list-related-incidents
      servers:
      - url: https://api.mux.com
      parameters:
      - $ref: '#/components/parameters/incident_id'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/order_by'
      - $ref: '#/components/parameters/order_direction'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRelatedIncidentsResponse'
              example:
                data:
                - affected_views: 71
                  affected_views_per_hour: 29
                  affected_views_per_hour_on_open: 75
                  breakdowns:
                  - id: abcdef
                    name: error_type_id
                    value: '697070'
                  description: Something is broken
                  error_description: No seriously, something is really really broken :(
                  id: 4u13td
                  impact: '*71 views* were affected at a rate of *29 per hour*'
                  incident_key: 5312a7c0bbb5d8353bd88602f01fe58eb15e9febac8fd2f0d8ce8f1cb138145c
                  measured_value: 5.9
                  measured_value_on_close: 0.1
                  measurement: error_rate
                  notification_rules: []
                  notifications:
                  - attempted_at: '2021-01-05T09:52:15.119040Z'
                    id: 103014
                    queued_at: '2021-01-05T09:52:14.945157Z'
                  - attempted_at: '2021-01-05T11:31:08.244462Z'
                    id: 102025
                    queued_at: '2021-01-05T11:31:08.061924Z'
                  resolved_at: '2021-01-05T11:31:04.000000Z'
                  sample_size: 1000
                  sample_size_unit: views
                  severity: alert
                  started_at: '2021-01-05T09:04:46.000000Z'
                  status: closed
                  threshold: 5
                - affected_views: 132
                  affected_views_per_hour: 11
                  affected_views_per_hour_on_open: 65
                  breakdowns:
                  - id: abcdef
                    name: video_title
                    value: Layla the dog video 1337
                  - id: abcdef
                    name: error_type_id
                    value: '697065'
                  description: Something else is broken
                  error_description: 'Detailed error: On no!'
                  id: rd9579
                  impact: '*132 views* were affected at a rate of *11 per hour*'
                  incident_key: fd9add7a85a013d768f4039f9e726133eddb476c2f16b22ebfe56f18f7c03b27
                  measured_value: 97
                  measured_value_on_close: 1
                  measurement: error_rate
                  notification_rules: []
                  notifications:
                  - attempted_at: '2020-12-31T09:26:19.416919Z'
                    id: 102198
                    queued_at: '2020-12-31T09:26:18.987717Z'
                  - attempted_at: '2020-12-31T20:23:57.279325Z'
                    id: 101269
                    queued_at: '2020-12-31T20:23:56.997068Z'
                  resolved_at: '2020-12-31T20:22:54.000000Z'
                  sample_size: 100
                  sample_size_unit: views
                  severity: alert
                  started_at: '2020-12-31T07:56:22.000000Z'
                  status: closed
                  threshold: 96
                timeframe:
                - 1610035979
                - 1610122379
                total_row_count: 2
      security:
      - accessToken: []
      - authorizationToken: []
components:
  parameters:
    severity:
      name: severity
      in: query
      description: Severity to filter incidents by
      required: false
      schema:
        type: string
        enum:
        - warning
        - alert
    incident_id:
      name: INCIDENT_ID
      in: path
      description: ID of the Incident
      required: true
      example: abcd1234
      schema:
        type: string
    order_by:
      name: order_by
      in: query
      description: Value to order the results by
      required: false
      schema:
        type: string
        enum:
        - negative_impact
        - value
        - views
        - field
    order_direction:
      name: order_direction
      in: query
      description: Sort order.
      required: false
      schema:
        type: string
        enum:
        - asc
        - desc
    page:
      name: page
      in: query
      description: Offset by this many pages, of the size of `limit`
      required: false
      schema:
        type: integer
        format: int32
        default: 1
    limit:
      name: limit
      in: query
      description: Number of items to include in the response
      required: false
      schema:
        type: integer
        format: int32
        default: 25
    incident_status:
      name: status
      in: query
      description: Status to filter incidents by
      required: false
      schema:
        type: string
        enum:
        - open
        - closed
        - expired
  schemas:
    IncidentBreakdown:
      type: object
      properties:
        value:
          type: string
        name:
          type: string
        id:
          type: string
      required:
      - id
      - name
      - value
    IncidentNotificationRule:
      type: object
      properties:
        status:
          type: string
        rules:
          type: array
          items:
            $ref: '#/components/schemas/NotificationRule'
        property_id:
          type: string
        id:
          type: string
        action:
          type: string
      required:
      - status
      - rules
      - property_id
      - id
      - action
    ListIncidentsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Incident'
        total_row_count:
          type: integer
          format: int64
          nullable: true
        timeframe:
          type: array
          items:
            type: integer
            format: int64
      required:
      - data
      - timeframe
      - total_row_count
    Incident:
      type: object
      properties:
        threshold:
          type: number
          format: double
        status:
          type: string
        started_at:
          type: string
        severity:
          type: string
        sample_size_unit:
          type: string
        sample_size:
          type: integer
          format: int64
        resolved_at:
          type: string
          nullable: true
        notifications:
          type: array
          items:
            $ref: '#/components/schemas/IncidentNotification'
        notification_rules:
          type: array
          items:
            $ref: '#/components/schemas/IncidentNotificationRule'
        measurement:
          type: string
        measured_value_on_close:
          type: number
          format: double
          nullable: true
        measured_value:
          type: number
          format: double
          nullable: true
        incident_key:
          type: string
        impact:
          type: string
        id:
          type: string
        error_description:
          type: string
        description:
          type: string
        breakdowns:
          type: array
          items:
            $ref: '#/components/schemas/IncidentBreakdown'
        affected_views_per_hour_on_open:
          type: integer
          format: int64
        affected_views_per_hour:
          type: integer
          format: int64
        affected_views:
          type: integer
          format: int64
      required:
      - id
      - started_at
      - resolved_at
      - incident_key
      - measurement
      - measured_value
      - measured_value_on_close
      - sample_size
      - sample_size_unit
      - breakdowns
      - severity
      - description
      - impact
      - affected_views
      - affected_views_per_hour
      - affected_views_per_hour_on_open
      - threshold
      - notifications
      - notification_rules
      - error_description
      - status
    IncidentNotification:
      type: object
      properties:
        queued_at:
          type: string
        id:
          type: integer
          format: int64
        attempted_at:
          type: string
      required:
      - queued_at
      - id
      - attempted_at
    ListRelatedIncidentsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Incident'
        total_row_count:
          type: integer
          format: int64
          nullable: true
        timeframe:
          type: array
          items:
            type: integer
            format: int64
      required:
      - data
      - timeframe
      - total_row_count
    NotificationRule:
      type: object
      properties:
        value:
          type: string
        name:
          type: string
        id:
          type: string
      required:
      - value
      - name
      - id
    IncidentResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/Incident'
        total_row_count:
          type: integer
          format: int64
          nullable: true
        timeframe:
          type: array
          items:
            type: integer
            format: int64
      required:
      - data
      - timeframe
      - total_row_count
  securitySchemes:
    accessToken:
      description: 'The Mux Video API uses an Access Token and Secret Key for authentication. If you haven''t already, [generate a new Access Token](https://dashboard.mux.com/settings/access-tokens) in the Access Token settings of your Mux account dashboard.


        Once you have an Access Token ID and Secret, you can then simply include those as the username (id) and password (secret) in the same way you use traditional basic auth.

        '
      scheme: basic
      type: http
    authorizationToken:
      description: 'OAuth authorization token, used as a Bearer Auth header

        '
      scheme: bearer
      type: http
x-tagGroups:
- name: Video
  tags:
  - Assets
  - Live Streams
  - Playback ID
  - URL Signing Keys
  - Direct Uploads
  - Delivery Usage
  - Playback Restrictions
  - DRM Configurations
  - Transcription Vocabularies
- name: Data
  tags:
  - Video Views
  - Errors
  - Filters
  - Exports
  - Metrics
  - Monitoring
  - Real-Time
  - Dimensions
  - Incidents
  - Annotations
  - View and Viewer Counts
- name: System
  tags:
  - Signing Keys
  - Utilities
- name: Robots
  tags:
  - Jobs
  - Ask Questions
  - Edit Captions
  - Find Key Moments
  - Generate Chapters
  - Moderate
  - Summarize
  - Translate Captions
- name: Playback
  tags:
  - Thumbnails
  - Animated Images
  - Storyboards
  - Streaming
  - Captions and Transcripts