Deletes an existing Song. Only allowed if the requestor is the Song owner.

URL: /v1/songs/{songId}

Method: DELETE

Path Parameters:

Query Parameters: None

Headers:

Authorization: Bearer {accessToken}

Code: 204 NO CONTENT

Headers: None

Code: 401 UNAUTHORIZED

Condition: If {accessToken} is invalid or expired.

Code: 403 FORBIDDEN

Condition: If the requestor is not the Song owner.

Headers:

Content-Type: application/json

Content example:

{
    "code": 403,
    "description": "Forbidden",
    "cause": "operation allowed only by owner"
}

Code: 404 NOT FOUND

Condition: If the specified Song is not found.

Headers:

Content-Type: application/json

Content example:

{
    "code": 404,
    "description": "Not Found",
    "cause": "Entity UserSong, id=d0907e3d-a9a7-43b1-93dc-f3b0ee929021 not found in the database"
}

Code: 422 UNPROCESSABLE ENTITY

Condition: If {songId} is malformed.

Headers:

Content-Type: application/json

Content example:

{
    "code": 422,
    "description": "Unprocessable Entity",
    "cause": "Invalid UUID string: 123456789"
}

Post Song (Add New Song)

Get Song

Get Songs

Get Song Count

Patch Song

Upload Song Audio

Process Song Stream Token Agreement

Get Song Smart Links

Get Song Genres

Get Song Genre Count