Skip to main content
PUT
Set a video's music

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency.

Path Parameters

id
string
required

Body

application/json
library
enum<string>
default:lumisreach
required

Where the track is from, as GET /v1/videos/music lists it: lumisreach (the built-in royalty-free library), epidemic (Epidemic Sound's catalog), generated (a track your workspace made with POST /v1/videos/music/generated, once ready) or commercial (popular songs from TikTok's charts; needs your workspace's confirmation, in the dashboard, that it holds the rights).

Available options:
lumisreach,
epidemic,
generated,
commercial
track_id
string
required

The track's track_id from GET /v1/videos/music

Required string length: 1 - 100
accept_price_cents
integer

A premium Epidemic Sound track's price_cents, as the listing showed it: sending it agrees to the charge, made once per video. Needed for a premium track only; every other track is free to use.

Required range: 1 <= x <= 100000
smart
boolean

Smart Music: play the track only under the stretches where the story gets interesting, tapering off after each, instead of from start to finish. Default false.

Response

Success

data
object
required