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.


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


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.