> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lavendly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update track

> Adjust a track's mix, trim window, or subtitle style.

<ParamField path="id" type="string" required>Workflow id.</ParamField>
<ParamField path="track_id" type="string" required>Track id.</ParamField>

### Body, any subset

<ParamField body="volume" type="number">`0..2`.</ParamField>

<ParamField body="muted" type="boolean" />

<ParamField body="ducking" type="boolean" />

<ParamField body="startTime" type="number">Trim start, seconds.</ParamField>
<ParamField body="duration" type="number">Trim duration, seconds.</ParamField>
<ParamField body="subtitleStyle" type="string">`off | tiktok | minimal | bold | …`</ParamField>

Writes are applied to the **source audio node's data**, never to a cached
`audioTracks` array, so the canvas and the API stay in sync.

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.lavendly.ai/v1/workflows/wf_xyz/tracks/tr_a1b2c3d4e5f6 \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer $LAVENDLY_API_KEY' \
    -d '{ "volume": 0.7, "ducking": true }'
  ```
</RequestExample>