Set how the music sits under the voice

Ducking mode (bed | off), the duck dials, sidechain ducks from any source, the aux room, and film-editor MOMENTS hung off scene edges (swell, out, in, hit).

Ducking mode (bed | off), the duck dials, sidechain ducks from any source, the aux room, and film-editor MOMENTS hung off scene edges (swell, out, in, hit). Applied in the editor, the share link and the export alike. expected_version makes it a compare-and-set.

Authorization

bearerAuth

AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Path Parameters

id*string

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

mode?string

Value in"bed" | "off"

duck?

duck_db, attack_sec, release_sec, bridge_sec, carve_db; null = default.

ducks?array<>

Sidechain from any source: REPLACES all rules ([] clears), at most 4. The target bus (music | sfx) dips while the source (vo | sfx) sounds; duck_db -30..0 (default -8 on music, -4 on sfx).

Itemsitems <= 4

room?|

Aux sends into one shared reverb: send.vo|music|sfx 0..1 (default 0 = no room), return_db -24..6 (default -6), decay_ms 100..6000, pre_delay_ms 0..200, damping 500..16000 Hz. A merge; null knobs reset, null clears the room.

moments?array<>

Replace ALL moments ([] clears).

add_moments?array<>

remove_moments?array<>

clear_scenes?array<string>

expected_version?integer

The project's edit_version as you last read it (GET /projects/{id} returns it; every project-level write answers with the new one). When sent, the write is a compare-and-set: if anyone changed the project settings since, NOTHING is written and the response is a 409 conflict carrying current_version and last_writer. Omit it to write unconditionally.

Range0 <= value

Response Body

`application/json`

curl -X PUT "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/mix" \  -H "Content-Type: application/json" \  -d '{}'

{
  "data": {
    "mode": "bed",
    "edit_version": 0
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "conflict",
    "code": "conflict",
    "message": "string",
    "current_version": 0,
    "expected_version": 0,
    "last_writer": {
      "label": "string",
      "kind": "editor",
      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
      "at": "string"
    }
  }
}

Set how the music sits under the voice

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

404application/json

409application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`