# Channels API error codes

## Error categories

| Category                 | What it means                                                                                                                                                                                                                                                        |
| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `USER_FIXABLE`           | You can fix this error by changing the configuration in the Essentials user interface (UI).                                                                                                                                                                          |
| `USER_FIXABLE_ADVANCED`  | You can fix this error by changing the configuration in the Advanced UI. A change made there usually causes it.                                                                                                                                                      |
| `EXTERNAL_ENVIRONMENTAL` | An environmental factor caused the error, usually because part of the system was unreachable or did not respond. These errors are usually temporary. Errors marked Transient should clear on their own under normal conditions. Investigate if the problem persists. |
| `INTERNAL_BUG`           | This is likely a software defect. Report it to [MediaKind Support](https://support.mk.io/) and include the error code.                                                                                                                                               |

## Look up an error

Each code has a fixed title and a message that can include values such as an input name. Braces such as `{slot}` mark placeholders. Expand **Technical details** to see the API’s `detail` field.

### CONFIG-0001-EL

**No RF output available**

This channel needs an RF output but none is available on this unit.

Category: `USER_FIXABLE`

**Technical details**

No RF modulator interface is available.

### CONFIG-0001-RT

**No RF output available**

This channel needs an RF output but none is available on this unit.

Category: `USER_FIXABLE`

**Technical details**

No RF modulator interface is available.

### CONFIG-0001-SP

**No RF output available**

This channel needs an RF output but none is available on this unit.

Category: `USER_FIXABLE`

**Technical details**

No RF modulator interface is available.

### CONFIG-0002-SP

**ASI connector unavailable**

This channel's ASI connection (slot {slot}, port {port}) is no longer available on this unit.

Category: `USER_FIXABLE`

**Technical details**

No ASI connector found for slot={slot} port={port}

### CONFIG-0003-SP

**Invalid ASI connection**

This channel's ASI connection details are invalid.

Category: `USER_FIXABLE`

**Technical details**

Invalid ASI URL: {url!r}

### CONFIG-0004-CP

**Invalid SDI connection**

This channel's SDI connection details are invalid.

Category: `USER_FIXABLE`

**Technical details**

Invalid SDI URL: {url!r}

### CONFIG-0004-EL

**Invalid SDI connection**

This channel's SDI connection details are invalid.

Category: `USER_FIXABLE`

**Technical details**

Invalid SDI URL: {url!r}

### CONFIG-0005-SP

**Invalid UDP connection**

This channel's UDP connection details are invalid.

Category: `USER_FIXABLE`

**Technical details**

Cannot parse UDP URL {url!r}: expected udp\://host:port or rtp\://host:port

### CONFIG-0006

**Input required**

This channel needs at least one input configured.

Category: `USER_FIXABLE`

**Technical details**

Channel has no inputs

### CONFIG-0007

**Output required**

This channel needs at least one output configured.

Category: `USER_FIXABLE`

**Technical details**

Channel has no outputs

### CONFIG-0008

**Invalid input/output setup**

This channel doesn't have a valid input/output combination configured.

Category: `USER_FIXABLE`

**Technical details**

No services in chain

### CONFIG-0009-EL

**SMPTE 2110 payload required**

This channel's SMPTE 2110 input needs its payload configured.

Category: `USER_FIXABLE`

**Technical details**

payload required for SMPTE ST 2110 input

### CONFIG-0010-EL

**UDP output has no source**

This channel's UDP output needs at least one video or audio source.

Category: `USER_FIXABLE`

**Technical details**

This channel's UDP output has no video or audio stream to send.

### CONFIG-0011-EL

**RF output has no source**

This channel's RF output needs at least one video or audio source.

Category: `USER_FIXABLE`

**Technical details**

This channel's RF output has no video or audio stream to send.

### CONFIG-0012-EL

**Streaming needs encoding**

This channel's streaming output needs an encoding configuration.

Category: `USER_FIXABLE`

**Technical details**

HttpStreaming output requires an ABR encoding transform

### CONFIG-0013-EL

**No quality levels configured**

This channel needs at least one output quality level configured.

Category: `USER_FIXABLE`

**Technical details**

HttpStreaming output requires at least one representation

### CONFIG-0014-EL

**Audio encoding needs a source**

This channel's audio encoding needs a source audio configured.

Category: `USER_FIXABLE`

**Technical details**

Audio encoding requires an input stream

### CONFIG-0015-EL

**Video encoding needs a source**

This channel's video encoding needs a source video configured.

Category: `USER_FIXABLE`

**Technical details**

Video encoding requires at least 1 video input stream

### CONFIG-0016-EL

**Audio encoding needs a source**

This channel's audio encoding needs at least one source audio.

Category: `USER_FIXABLE`

**Technical details**

Audio encoding requires at least 1 audio input stream

### CONFIG-0017-EL

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

This channel's video encoding is missing a required videoFormat value.

### CONFIG-0018-EL

**Streaming needs a video source**

This channel's streaming output needs a source video configured.

Category: `USER_FIXABLE`

**Technical details**

ABR encoding requires at least 1 video input stream

### CONFIG-0019-EL

**Streaming needs an audio source**

This channel's streaming output needs at least one source audio.

Category: `USER_FIXABLE`

**Technical details**

ABR audio encoding requires at least 1 audio input stream

### CONFIG-0020-CP

**Invalid connection details**

This channel's connection details are invalid.

Category: `USER_FIXABLE`

**Technical details**

Invalid ASI/RF-demod URL: {url!r}

### CONFIG-0021-CP

**Invalid CAM connection**

This channel's CAM connection details are invalid.

Category: `USER_FIXABLE`

**Technical details**

Invalid CAM URL: {url!r}

### CONFIG-0022-CP

**Too many SDI audio embeds**

This channel has more decoded audios than can fit in the available SDI audio embeds.

Category: `USER_FIXABLE`

**Technical details**

decoded audios require more SDI audio embeds than are available (max {max\_embeds})

### CONFIG-0023-CP

**Unknown audio source**

{audio\_input\_name!r} not found. Please check the SDI output's audio mapping.

Category: `USER_FIXABLE`

**Technical details**

SDI output audio embedding references unknown input audio {audio\_input\_name!r}

### CONFIG-0024-CP

**SDI output needs a video source**

This channel's SDI output needs a video source configured.

Category: `USER_FIXABLE`

**Technical details**

This channel's SDI output has no video stream configured.

### CONFIG-0025-CP

**Unknown transport reference**

This channel's SMPTE 2110 output references a transport that no longer exists.

Category: `USER_FIXABLE`

**Technical details**

transportName {name!r} does not match any entry in transports

### CONFIG-0026-CP

**SMPTE 2110 output needs video**

This channel's SMPTE 2110 output needs a video source configured.

Category: `USER_FIXABLE`

**Technical details**

This channel's SMPTE 2110 output has no video stream configured.

### CONFIG-0027

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No service is configured to handle an input of type {input\_type}

### CONFIG-0028

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No service is configured to handle an output of type {output\_type}

### CONFIG-0029

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Max internal connections ({max\_connections}) exceeded

### CONFIG-0030-CP

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No template for service type: {service\_type}

### CONFIG-0030-EL

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No template for service type: {service\_type}

### CONFIG-0030-PK

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No template for service type: {service\_type}

### CONFIG-0030-RT

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No template for service type: {service\_type}

### CONFIG-0030-SP

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No template for service type: {service\_type}

### CONFIG-0031-CP

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No config block is registered to build this part of a {service\_type} config

### CONFIG-0031-EL

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No config block is registered to build this part of a {service\_type} config

### CONFIG-0031-PK

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No config block is registered to build this part of a {service\_type} config

### CONFIG-0031-RT

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No config block is registered to build this part of a {service\_type} config

### CONFIG-0031-SP

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No config block is registered to build this part of a {service\_type} config

### CONFIG-0032

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Path '{json\_path}' not found in config

### CONFIG-0033

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Block requires 'id' field for dict insertion at '{json\_path}'

### CONFIG-0034

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Path '{json\_path}' is not an array or dict

### CONFIG-0035

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

{lookup\_name} not registered

### CONFIG-0036

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Hardware cache not initialized

### CONFIG-0037

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No board mapping found for slot {slot}

### CONFIG-0038

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No slot mapping found for board {board}

### CONFIG-0039-EL

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Attempted to write an unresolved (unsynced) audio pairing into this channel's encoding config

### CONFIG-0040

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Internal connection produced an output where an input was expected

### CONFIG-0041-CP

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Unsupported program decryptType: {decryptType!r}

### CONFIG-0042-EL

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Audio selection type has no mapping

### CONFIG-0043-SP

**Output program number used twice**

Two services on this output would use program number {program}. A service renumbered in the Advanced UI already uses it — renumber one of them.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

output program {program} is used by more than one service

### CONFIG-0044-EL

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Data encoding has no matching input data stream

### CONFIG-0045-SP

**ASI port direction mismatch**

This channel's ASI connection (slot {slot}, port {port}) is configured on this unit for {configured}, so it can't be used for {used}. Choose a different ASI port.

Category: `USER_FIXABLE`

**Technical details**

ASI connector slot={slot} port={port} is configured for {configured}, used for {used}

### CONFIG-0046-SP

**ASI port not configured**

This channel's ASI connection (slot {slot}, port {port}) is not configured on this unit for {used}. Choose a different ASI port, or configure your ASI ports. For advice on configuring ASI ports, please read [ASI Card Configuration Tool](https://docs.mediakind.com/beam/multiplexer/asi-card/).

Category: `USER_FIXABLE`

**Technical details**

No ASI connector found for slot={slot} port={port}, used for {used}

### CONN-0001-CP

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

Could not connect to {service\_type} (id={service\_id}): {cause}

### CONN-0001-EL

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

Could not connect to {service\_type} (id={service\_id}): {cause}

### CONN-0001-PK

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

Could not connect to {service\_type} (id={service\_id}): {cause}

### CONN-0001-RT

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

Could not connect to {service\_type} (id={service\_id}): {cause}

### CONN-0001-SP

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

Could not connect to {service\_type} (id={service\_id}): {cause}

### CONN-0002-CP

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

{service\_type} (id={service\_id}) returned an error: {status\_code} {cause}

### CONN-0002-EL

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

{service\_type} (id={service\_id}) returned an error: {status\_code} {cause}

### CONN-0002-PK

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

{service\_type} (id={service\_id}) returned an error: {status\_code} {cause}

### CONN-0002-RT

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

{service\_type} (id={service\_id}) returned an error: {status\_code} {cause}

### CONN-0002-SP

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

{service\_type} (id={service\_id}) returned an error: {status\_code} {cause}

### CONN-0003

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

No URL configured for service type: {service\_type}

### CONN-0004

**Temporarily unavailable**

This request couldn't be completed right now. This should resolve on its own — if it doesn't, contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

The database is unavailable: {cause}

### PLATFORM-0001

**Interfaces unavailable**

This unit's interfaces couldn't be read right now. This should resolve on its own — if it doesn't, contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

Could not read {interfaces} from the platform: {cause}

### PLATFORM-0002

**Internal error**

Something went wrong reading this unit's interfaces. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Could not read {interfaces} from the platform: {cause}

### PLATFORM-0003

**Packager state unavailable**

Whether this unit's packager is enabled couldn't be read right now. This should resolve on its own — if it doesn't, contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

Could not read the packager state from the platform: {cause}

### PLATFORM-0004

**Internal error**

Something went wrong reading whether this unit's packager is enabled. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

Could not read the packager state from the platform: {cause}

### SYNC-0001

**Services missing**

One or more services this channel uses no longer exist. They may have been removed in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

Service(s) no longer available: {missing\_services}

### SYNC-0002

**Temporary sync issue**

This channel's configuration couldn't be synced right now. This should resolve on its own — if it doesn't, please contact support and reference the code.

Category: `EXTERNAL_ENVIRONMENTAL` (Transient)

**Technical details**

Stopping the channel timed out after {timeout\_seconds} seconds

### SYNC-0003-CP

**Configuration mismatch**

This channel's configuration no longer matches what's actually running. This can happen after a change made directly in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

{service\_type} (id={service\_id}) live config mismatch: {cause}

### SYNC-0003-EL

**Configuration mismatch**

This channel's configuration no longer matches what's actually running. This can happen after a change made directly in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

{service\_type} (id={service\_id}) live config mismatch: {cause}

### SYNC-0003-RT

**Configuration mismatch**

This channel's configuration no longer matches what's actually running. This can happen after a change made directly in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

{service\_type} (id={service\_id}) live config mismatch: {cause}

### SYNC-0003-SP

**Configuration mismatch**

This channel's configuration no longer matches what's actually running. This can happen after a change made directly in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

{service\_type} (id={service\_id}) live config mismatch: {cause}

### SYNC-0004-CP

**Configuration mismatch**

This channel's configuration no longer matches what's actually running. This can happen after a change made directly in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

{service\_type} (id={service\_id}) live config unparseable: {cause}

### SYNC-0004-EL

**Configuration mismatch**

This channel's configuration no longer matches what's actually running. This can happen after a change made directly in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

{service\_type} (id={service\_id}) live config unparseable: {cause}

### SYNC-0004-RT

**Configuration mismatch**

This channel's configuration no longer matches what's actually running. This can happen after a change made directly in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

{service\_type} (id={service\_id}) live config unparseable: {cause}

### SYNC-0004-SP

**Configuration mismatch**

This channel's configuration no longer matches what's actually running. This can happen after a change made directly in the Advanced UI — check for anything recently changed there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

{service\_type} (id={service\_id}) live config unparseable: {cause}

### SYNC-0005-CP

**Audio routing mismatch**

An audio on this channel's output is routed from an audio that isn't set up on the input. This can happen after a change made directly in the Advanced UI — check the output's audio settings there. If nothing looks wrong, contact support.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

live config routes output audio {stream\_id!r} (id={service\_id}) from decode stream {decode\_stream\_id!r}, which no processing block declares

### SYNC-0006-SP

**Service duplicated on output**

A program is passed through more than once on this output. Duplicating a service isn't supported on a service-filtering output — remove the copy in the Advanced UI and duplicate the service upstream instead.

Category: `USER_FIXABLE_ADVANCED`

**Technical details**

live config (id={service\_id}) passes input program {program} through in more than one service

### UNKNOWN-0000

**Internal error**

Something went wrong configuring this channel. Contact support and reference the code.

Category: `INTERNAL_BUG`

**Technical details**

An unclassified internal error occurred.
