Skip to main content
POST
level audio

Authorizations

Authorization
string
header
required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key
string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id
string

The workspace this one call acts in, when it is not the key's own.

Body

application/json
timeline_id
string
required

The timeline id.

mode
enum<string>

match (default) brings every speaking clip to the target, so takes from different sources agree. offset moves the whole cut by one amount and keeps the mix as it is, for a piece already balanced by hand.

Available options:
match,
offset
platform
enum<string>

Where it plays, which sets the target: youtube, instagram and tiktok -14 LUFS, podcast -16, broadcast -23. Default youtube.

Available options:
youtube,
instagram,
tiktok,
podcast,
broadcast
target_lufs
number

A target of its own, over platform.

Required range: -30 <= x <= -6
clip_ids
string[]

Write only these clips. The level is still worked out over the whole cut, so one clip of an interview is matched to the conversation rather than to itself.

if_revision

The revision get_timeline returned. A stale one fails with revision_conflict instead of applying; so does no revision once a user edited the timeline in the app since this connection last read it.

context
string

Optional: one sentence shown to the user beside this action.

Maximum string length: 600

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

ok
any
required
data
object
required
meta
object
required
media
object[]