POST ​/api​/v3​/account​/:id​/artist_profile​/track

Add an artist track

Request

Example Request

{
  "auth_token": "abc1245920feab98ca",
  "track": {
    "album_id": 1,
    "track_number": 1,
    "title": "I Am Trying to Break Your Heart",
    "position": 1,
    "single": true,
    "is_download_on": true,
    "remote_file_url": "http://example.com/track.mp3"
  }
}

Example Parameters

  • auth_token: The user's auth_token obtained by calling the auth API.

    • Required: yes
    • Type: string
    • Example: abc1245920feab98ca
  • track: The track object containing the attributes for the track to update.

    • Required: yes
    • album_id: The unique ID of the album.
      • Required: yes
      • Type: integer
      • Example: 1
    • track_number: The album track number
      • Required: no
      • Type: integer
      • Example: 1
    • title: The track title
      • Required: no
      • Type: string
      • Example: I Am Trying to Break Your Heart
    • position: The track sort/display position
      • Required: no
      • Type: integer
      • Example: 1
    • single: Whether or not the track is a single. These are given higher priority when building playlists for upcoming shows, etc.
      • Required: no
      • Type: boolean
    • isdownloadon: Whether or not the track can be downloaded
      • Required: no
      • Type: boolean
    • remotefileurl: URL to download the track.
      • Required: yes
      • Type: string
      • Format: uri
      • Example: http://example.com/track.mp3

Response

Example Response

{
  "track": {
    "id": 1,
    "album_id": 1,
    "track_number": 1,
    "title": "I Am Trying to Break Your Heart",
    "duration": "06:58",
    "position": 1,
    "single": true,
    "is_download_on": true,
    "download_url": "http://example.com/track.mp3\""
  }
}

Response Parameters

  • track:

    • Required: yes
    • id: The unique ID of the track
      • Required: yes
      • Type: integer
      • Example: 1
    • album_id: The unique ID of the album
      • Required: yes
      • Type: integer
      • Example: 1
    • track_number: The album track number
      • Required: no
      • Type: integer
      • Example: 1
    • title: The track title
      • Required: no
      • Type: string
      • Example: I Am Trying to Break Your Heart
    • duration: The duration of the track. In minutes:seconds format.
      • Required: yes
      • Type: string
      • Example: 06:58
    • position: The track sort/display position
      • Required: no
      • Type: integer
      • Example: 1
    • single: Whether or not the track is a single. These are given higher priority when building playlists for upcoming shows, etc.
      • Required: no
      • Type: boolean
    • isdownloadon: Whether or not the track can be downloaded
      • Required: no
      • Type: boolean
    • download_url: The track download URL
      • Required: no
      • Type:
        • null
        • string
      • Example: http://example.com/track.mp3"

Response Codes

Successful Response Codes

  • 201: The artist track was created.

Failure Response Codes

  • 401: Unauthorized request. Indicates a missing or invalid auth_token.

  • 422: Indicates a bad request including validation errors.