API Errors

The LightFlow API uses standard HTTP status codes to indicate the success or failure of an API call. The body of the response is in JSON with a format similar to the following:

BASH

{
  "message": "asset not found"
}

Asset processing errors

The asset object provides information on processing errors, for example:

BASH

{
  ...
  "assetError": {
    "code": 2404,
    "message": "Error downloading input file: remote server returned HTTP 404"
  }
  ...
}

Error Codes

General Errors

1001: Unknown error
1002: Error on asset creation
1003: Error on asset processing

Storage Errors

2001: Error downloading input file
2002: Error downloading input file: could not connect to remote server
2003: Input file is invalid or corrupt
2004: Input file bitrate exceeds the allowed limit for trial accounts
2005: Input file duration exceeds the allowed limit for trial accounts
2006: Input file format is not valid for 4K: asset has a width below 2560 pixels
2007: Storage credentials error
24XX: Range (2400-24XX). Represents HTTP 4XX error returned by remote server while attempting to download the input file:
- 2401: Unauthorized (please review your bucket credentials)
- 2403: Forbidden (your user does have not access to the resource)
- 2404: Not found (the resource does not exist)
- 2429: Too many requests (the external service is overloaded, try again later)
25XX: Range (2500-25XX). Represents HTTP 5XX error returned by remote server while attempting to download the input file:
- 2500: Remote server problem (the external service is not responding, try again later or contact support)
- 2503: Service unavailable (the external service is not responding, try again later or contact support)
- 2504: Gateway timeout (the external service is not responding, try again later or contact support)
2070: Error downloading subtitles

Brightcove Errors

3001: Error connecting to Brightcove
3002: Brightcove encoder: input file is invalid or corrupt
3003: Reference Id assigned to this asset is already in use and could not be published in Brightcove
3004: Brightcove encoder: Error creating the encoding profile for this asset
3005: Error publishing asset on Brightcove

Packaging/Uploading Errors

4001: Error uploading MP4 result files
4002: Error uploading DASH result files
4003: Error uploading HLS result files
4004: Error connecting to upload server
4013: Error uploading thumbnails
4014: Error stitching video chunks
4005: Unknown error preparing/uploading output files

Protection Errors

2050: EZDRM response is not as expected
2051: EZDRM request timed out
2052: EZDRM request has too many redirects
2053: EZDRM returned a general http error
2054: EZDRM general request error
2055: EZDRM request returned internal server error
2060: Irdeto response is not as expected
2061: Irdeto request timed out
2062: Irdeto request has too many redirects
2063: Irdeto returned a general http error
2064: Irdeto general request error
2065: Irdeto request returned internal server error
2066: DRM protection not selected

Inference Errors

6001: Error uploading inference results

LightFlow Encoder Errors

7001: Error encoding input