---
title: "Attach background audio to a video"
method: POST
path: "/v1/videos/{videoId}/audio"
tags: ["Videos"]
---

# Attach background audio to a video

`POST /v1/videos/{videoId}/audio`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/videos/{videoId}/audio`
- Auth: HTTP bearer

Configure audio mixing or replacement on an unpublished video. The existing video publisher renders the mix during publishing; this does not return a pre-rendered preview. Original video duration is preserved. Audio must be a hosted file in your own media library. Scheduled videos will use the changed audio, so confirm before editing.

## Path parameters

- `videoId` string, uuid, required

## Request body

- object
  - `audioUrl` string, uri, required
  - `trackName` string
  - `mode` 'mix' | 'replace'
  - `audioVolume` number
  - `originalVolume` number
  - `audioStartTime` number
  - `videoStartTime` number
  - `fadeIn` number
  - `loopAudio` boolean

## Response `200`

Successful response.

- object
  - `success` true, required
  - `data` object, required
    - `video` object, required
      - `id` string, required
      - `audio_url` string, required
      - `audio_mix_options` object, required
    - `appliedDuringPublishing` true, required

## Other responses

- `400`: Invalid input.
- `404`: Not found or not owned.
- `409`: Content changed or cannot be edited in its current state.

---

[API](https://skmtc.dev/postquick/apis/postquickai-api.md) · [All operations](https://skmtc.dev/postquick/apis/postquickai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postquick/apis/postquickai-api/revisions/d9bc2bcf3042?raw)