Skip to main content

Update Track

PUT 
/tracks/:track_id

Updates an existing track

Request​

Path Parameters

    track_id stringrequired

    A Track ID

Query Parameters

    user_id stringrequired

    The user ID of the user making the request

Body

required

    title string

    Track title

    genre genre (string)

    Possible values: [Electronic, Rock, Metal, Alternative, Hip-Hop/Rap, Experimental, Punk, Folk, Pop, Ambient, Soundtrack, World, Jazz, Acoustic, Funk, R&B/Soul, Devotional, Classical, Reggae, Podcasts, Country, Spoken Word, Comedy, Blues, Kids, Audiobooks, Latin, Lo-Fi, Hyperpop, Dancehall, Techno, Trap, House, Tech House, Deep House, Disco, Electro, Jungle, Progressive House, Hardstyle, Glitch Hop, Trance, Future Bass, Future House, Tropical House, Downtempo, Drum & Bass, Dubstep, Jersey Club, Vaporwave, Moombahton]

    Music genre

    description stringnullable

    Possible values: <= 1000 characters

    Track description

    mood mood (string)

    Possible values: [Peaceful, Romantic, Sentimental, Tender, Easygoing, Yearning, Sophisticated, Sensual, Cool, Gritty, Melancholy, Serious, Brooding, Fiery, Defiant, Aggressive, Rowdy, Excited, Energizing, Empowering, Stirring, Upbeat, Other]

    Music mood

    bpm numbernullable

    Beats per minute (tempo)

    musical_key stringnullable

    Musical key of the track

    tags stringnullable

    Comma-separated tags

    license stringnullable

    License type

    isrc stringnullable

    International Standard Recording Code

    iswc stringnullable

    International Standard Musical Work Code

    release_date date

    Release date

    track_cid string

    IPFS CID for the track audio file

    orig_file_cid string

    IPFS CID for the original track file

    orig_filename string

    Original filename of the track

    cover_art_cid string

    IPFS CID for cover art

    cover_art_sizes string

    Cover art sizes metadata

    preview_cid string

    IPFS CID for the track preview

    preview_start_seconds float

    Preview start time in seconds

    duration float

    Track duration in seconds

    is_downloadable boolean

    Whether the track is downloadable

    is_unlisted boolean

    Whether the track is unlisted

    is_stream_gated boolean

    Whether streaming is restricted behind an access gate

    stream_conditions

    object

    nullable

    oneOf

    tip_user_id integerrequired

    Must tip the given user ID to unlock

    download_conditions

    object

    nullable

    oneOf

    tip_user_id integerrequired

    Must tip the given user ID to unlock

    field_visibility

    object

    mood booleanrequired
    tags booleanrequired
    genre booleanrequired
    share booleanrequired
    play_count booleanrequired
    remixes booleanrequired
    placement_hosts string

    Placement hosts for the track

    stem_of

    object

    category stringrequired
    parent_track_id integerrequired

    remix_of

    object

    tracks

    object[]

    required

  • Array [

    • parent_track_id stringrequired

  • ]

    • ddex_app stringnullable

    DDEX application identifier

    parental_warning_type stringnullable

    Parental warning type

Responses​

Track updated successfully

Schema

    success boolean

    Whether the operation was successful

    transaction_hash string

    The blockchain transaction hash

Loading...