PUT ​/api​/v3​/account​/:id​/artistprofile​/track​/:trackid

Update an artist track title, album ID, or position. To change the track itself, use the DELETE endpoint to remove the track and the POST endpoint to upload the new track.

Request

Example Request

{
  "auth_token": "abc1245920feab98ca",
  "track": {
    "title": "I Am Trying to Break Your Heart",
    "album_id": 1,
    "position": 1
  }
}

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
    • title: The track title
      • Required: no
      • Type: string
      • Example: I Am Trying to Break Your Heart
    • album_id: The unique ID of the album
      • Required: no
      • Type: integer
      • Example: 1
    • position: The track sort/display position
      • Required: no
      • Type: integer
      • Example: 1

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

  • 200: The artist track was updated.

Failure Response Codes

  • 422: Indicates a bad request including validation errors.

  • 404: Indicates the account or track was not found.

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