Skip to main content

Create Track

POST 
/tracks

Creates a new track

Request​

Query Parameters

    user_id stringrequired

    The user ID of the user making the request

Body

required

    track_id string

    Optional track ID (will be generated if not provided)

    title stringrequired

    Track title

    genre genre (string)required

    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 stringrequired

    IPFS CID for the track audio file (required)

    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 booleannullable

    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

    ddex_release_ids objectnullable

    DDEX release identifiers

    artists object[]nullable

    DDEX resource contributors / artists

    resource_contributors

    object[]

    nullable

    DDEX resource contributors

  • Array [

    • name stringrequired

    Possible values: non-empty

    Contributor name

    roles string[]required

    Possible values: >= 1

    Contributor roles

    sequence_number integer

    Sequence number for ordering

  • ]

    • indirect_resource_contributors

    object[]

    nullable

    DDEX indirect resource contributors

  • Array [

    • name stringrequired

    Possible values: non-empty

    Contributor name

    roles string[]required

    Possible values: >= 1

    Contributor roles

    sequence_number integer

    Sequence number for ordering

  • ]

    • rights_controller

    object

    nullable

    DDEX rights controller

    name stringrequired

    Possible values: non-empty

    roles string[]required

    Possible values: >= 1

    rights_share_unknown string

    Optional

    copyright_line

    object

    nullable

    year stringrequired

    Possible values: >= 4 characters and <= 4 characters

    Copyright year (4 characters)

    text stringrequired

    Possible values: non-empty

    Copyright text

    producer_copyright_line

    object

    nullable

    year stringrequired

    Possible values: >= 4 characters and <= 4 characters

    Copyright year (4 characters)

    text stringrequired

    Possible values: non-empty

    Copyright text

    parental_warning_type stringnullable

    Parental warning type

    cover_original_song_title stringnullable

    Original song title for cover tracks

    cover_original_artist stringnullable

    Original artist for cover tracks

    is_owned_by_user boolean

    Whether the track is owned by the user

    territory_codes string[]nullable

    Territory codes for distribution

    no_ai_use boolean

    Whether AI use is prohibited

Responses​

Track created successfully

Schema

    success boolean

    Whether the track was created successfully

    transaction_hash string

    The blockchain transaction hash

    track_id string

    The ID of the created track

Loading...