POST ​/api​/v3​/track​/:id​/skip

Records a skip for the specified track. Used to track metrics about given tracks. Clients are required to call this API when the user skips a track.

Request

Example Request

{
  "elapsed": 25
}

Example Parameters

  • elapsed: The number of seconds the user was at in the song when the skip button was pressed.
    • Required: yes
    • Type: integer
    • Example: 25

Response

Example Response

{
  "track_id": 2,
  "status": "skip"
}

Response Parameters

  • track_id: The id of the track that was skipped.

    • Required: no
    • Type: integer
    • Example: 2
  • status: A message indicating the status of the skip action.

    • Required: no
    • Type: string
    • Example: skip

Response Codes

Successful Response Codes

  • 200: The skip was recorded successfully.

Failure Response Codes

  • 422: A required parameter was not present or was invalid.

  • 404: The track could not be found.