---
title: "Update an engine by ID"
method: PATCH
path: "/engines/{id}"
tags: ["Engines"]
---

# Update an engine by ID

`PATCH /engines/{id}`

## Path parameters

- `id` string, required — Engine ID

## Request body

- object
  - `ingestId` string — Ingest ID to connect the engine to
  - `name` string — Name of the engine
  - `region` string — Region ID
  - `priority` number — Engine priority (-100 to 100), lower value is higher priority
  - `drm` boolean — Enable DRM. Only possible when enabled for your organization.
  - `quality` object — Quality configuration
    - `abrLadderId` string, required — ABR ladder ID
  - `daiAssetKey` string, nullable — DAI asset key
  - `overlays` object[] — Image overlay configuration
    - `url` string, required — URL of the overlay image
    - `position` object — Overlay position
      - `top` integer — Pixels from top
      - `bottom` integer — Pixels from bottom (ignored if top is present)
      - `left` integer — Pixels from left
      - `right` integer — Pixels from right (ignored if left is present)
    - `size` object — Overlay size
      - `width` integer — Width in pixels
      - `height` integer — Height in pixels
    - `opacity` number — Overlay opacity (`0`=fully transparent, `1`=fully opaque)
  - `outputs` object — Output format configuration
    - `hesp` boolean — Enable HESP output. Enabled by default.
    - `hls` boolean — Enable HLS output. Enabled by default.
    - `hlsMpegTs` boolean — Enable HLS MPEG-TS output. Only available when enabled for your organization.
  - `vision` object, nullable — Vision configuration. Only available when enabled for your organization. Pass `null` to disable.
    - `saturationBoost` 'high' | 'low', required — Saturation boost level
    - `strength` 'low' | 'medium' | 'high', required — Vision processing strength
  - `atmos` object, nullable — Dolby Atmos configuration. Only available when the connected ABR ladder has Dolby Atmos audio configured. Pass `null` to disable.
    - `dialnorm` integer, nullable, required — Dolby Atmos dialnorm value. Must be an integer between -1 and -31. Pass `null` to unset it.

## Response `200`

Updated engine

- EngineObjectResult
  - `data` object, required — Engine object
    - `id` string, required — Unique identifier of the engine
    - `name` string, required — Name of the engine
    - `createdAt` string, required — Creation timestamp
    - `updatedAt` string, required — Last update timestamp
    - `quality` object, required — Quality configuration
      - `abrLadderId` string, required — ABR ladder ID
    - `overlays` object[], required — Image overlay configuration
      - `url` string, required — URL of the overlay image
      - `position` object — Overlay position
        - `top` integer — Pixels from top
        - `bottom` integer — Pixels from bottom (ignored if top is present)
        - `left` integer — Pixels from left
        - `right` integer — Pixels from right (ignored if left is present)
      - `size` object — Overlay size
        - `width` integer — Width in pixels
        - `height` integer — Height in pixels
      - `opacity` number — Overlay opacity (`0`=fully transparent, `1`=fully opaque)
    - `drm` boolean, required — Whether DRM is enabled
    - `priority` number, required — Engine priority
    - `status` 'stopped' | 'deploying' | 'starting' | 'waiting' | 'ingesting' | 'playing' | 'stopping' | 'error' | 'deleting' | 'deleted', required — Current status of the engine
    - `daiAssetKey` string, nullable — DAI asset key
    - `outputs` object, required — Output format configuration
      - `hesp` boolean — Enable HESP output. Enabled by default.
      - `hls` boolean — Enable HLS output. Enabled by default.
      - `hlsMpegTs` boolean — Enable HLS MPEG-TS output. Only available when enabled for your organization.
    - `vision` object, nullable — Vision configuration
      - `saturationBoost` 'high' | 'low', required — Saturation boost level
      - `strength` 'low' | 'medium' | 'high', required — Vision processing strength
    - `atmos` object, nullable — Dolby Atmos configuration
      - `dialnorm` integer, required — Dolby Atmos dialnorm value. Must be an integer between -1 and -31.

## Changes

- **2026-07-26** `7bfe58df4d98` — 1 info
  - the request property `atmos/dialnorm` became nullable

[Change history](https://skmtc.dev/dolby/apis/theolive-api/changes/engines/:id/patch.md)

---

[API](https://skmtc.dev/dolby/apis/theolive-api.md) · [All operations](https://skmtc.dev/dolby/apis/theolive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dolby/theolive-api/revisions/7bfe58df4d98/schema)