---
title: "POST video.asset.track.errored"
method: POST
path: "video.asset.track.errored"
---

# POST video.asset.track.errored

`POST video.asset.track.errored` (webhook)

## Payload

- object
  - `type` 'video.asset.track.errored', required — Type for the webhook event
  - `id` string, required — Unique identifier for the event
  - `created_at` string, date-time, required — Time the event was created
  - `object` object, required
    - `type` string, required
    - `id` string, required
  - `environment` object, required
    - `name` string, required — Name for the environment
    - `id` string, required — Unique identifier for the environment
  - `attempts` object[], required — Attempts for sending out the webhook event
    - `webhook_id` integer — Unique identifier for the webhook
    - `response_status_code` integer — HTTP response status code for the webhook attempt
    - `response_headers` object — HTTP response headers for the webhook attempt
    - `response_body` string, nullable — HTTP response body for the webhook attempt
    - `max_attempts` integer — Max attempts number for the webhook attempt
    - `id` string — Unique identifier for the webhook attempt
    - `created_at` string, date-time — Time the webhook request was attempted
    - `address` string — URL address for the webhook attempt
  - `request_id` string, nullable
  - `accessor` string, nullable
  - `accessor_source` string, nullable
  - `data` object, required
    - `id` string — Unique identifier for the Track
    - `type` 'video' | 'audio' | 'text' — The type of track
    - `duration` number, double — The duration in seconds of the track media. This parameter is not set for `text` type tracks. This field is optional and may not be set. The top level `duration` field of an asset will always be set.
    - `max_width` integer — The maximum width in pixels available for the track. Only set for the `video` type track.
    - `max_height` integer — The maximum height in pixels available for the track. Only set for the `video` type track.
    - `max_frame_rate` number, double — The maximum frame rate available for the track. Only set for the `video` type track. This field may return `-1` if the frame rate of the input cannot be reliably determined.
    - `max_channels` integer — The maximum number of audio channels the track supports. Only set for the `audio` type track.
    - `max_channel_layout` string — Only set for the `audio` type track.
    - `text_type` 'subtitles' — This parameter is only set for `text` type tracks.
    - `text_source` 'uploaded' | 'embedded' | 'generated_live' | 'generated_live_final' | 'generated_vod' — The source of the text contained in a Track of type `text`. Valid `text_source` values are listed below. * `uploaded`: Tracks uploaded to Mux as caption or subtitle files using the Create Asset Track API. * `embedded`: Tracks extracted from an embedded stream of CEA-608 closed captions. * `generated_vod`: Tracks generated by automatic speech recognition on an on-demand asset. * `generated_live`: Tracks generated by automatic speech recognition on a live stream configured with `generated_subtitles`. If an Asset has both `generated_live` and `generated_live_final` tracks that are `ready`, then only the `generated_live_final` track will be included during playback. * `generated_live_final`: Tracks generated by automatic speech recognition on a live stream using `generated_subtitles`. The accuracy, timing, and formatting of these subtitles is improved compared to the corresponding `generated_live` tracks. However, `generated_live_final` tracks will not be available in `ready` status until the live stream ends. If an Asset has both `generated_live` and `generated_live_final` tracks that are `ready`, then only the `generated_live_final` track will be included during playback.
    - `language_code` string — The language code value represents [BCP 47](https://tools.ietf.org/html/bcp47) specification compliant value, or 'auto'. For example, `en` for English or `en-US` for the US version of English. This parameter is only set for `text` and `audio` track types. During automatic language detection for generated subtitles, this value will be set to `auto` until the language is determined.
    - `name` string — The name of the track containing a human-readable description. The HLS manifest will associate a subtitle `text` or `audio` track with this value. For example, the value should be "English" for a subtitle text track for the `language_code` value of `en-US`. This parameter is only set for `text` and `audio` track types.
    - `closed_captions` boolean — Indicates the track provides Subtitles for the Deaf or Hard-of-hearing (SDH). This parameter is only set tracks where `type` is `text` and `text_type` is `subtitles`.
    - `passthrough` string — Arbitrary user-supplied metadata set for the track either when creating the asset or track. This parameter is only set for `text` type tracks. Max 255 characters.
    - `status` 'preparing' | 'ready' | 'errored' | 'deleted' — The status of the track. This parameter is only set for `text` type tracks.
    - `primary` boolean — For an audio track, indicates that this is the primary audio track, ingested from the main input for this asset. The primary audio track cannot be deleted.
    - `auto_language_confidence` number, double — The confidence value (0-1) of the determined language. This value only is available when automatic language detection is utilized in generated subtitles.
    - `asset_id` string — Unique identifier for the Asset. Max 255 characters.
    - `error` object — Object that describes any errors that happened when processing this asset.
      - `type` string — The type of error that occurred for this asset.
      - `messages` string[] — Error messages with more details.

## Acknowledgement `200`

Return a 200 to indicate that the data was received successfully

---

[API](https://skmtc.net/muxinc/apis/mux-api.md) · [All operations](https://skmtc.net/muxinc/apis/mux-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muxinc/mux-api/revisions/34a65dce0f31/schema)