Delete a song

November 14, 2026

Table of contents

  1. Request Headers
  2. Responses
  3. Examples
  4. Try It

Delete a song from the ACE Music Library of the account that holds it. ACE Music moves it to the account’s trash, where it can be restored on acemusic.ai only. Through the API it is gone: its songId answers 404, and so does a job whose songs were all deleted.

https://api.useapi.net/v1/acemusic/music/songId

  • songId is URL-encoded in the path (it contains : and @).
Request Headers 
Authorization: Bearer {API token}
Responses

  • 204 No Content

    The song was moved to the account’s trash.

  • 400 Bad Request

    {
  "error": "Path parameter songId (not-a-song) is not a valid songId (user:<id>-<email>-song:so_…)",
  "code": 400
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "useapi.net ⁝ Unauthorized",
  "code": 401
}

  • 403 Forbidden

    {
  "error": "Song user:[email protected]:so_91fd58fded6b4617a47a5726 is not yours",
  "code": 403
}

  • 404 Not Found

    The song is already deleted, or its account is not connected.

    {
  "error": "Deleting the song: Not found",
  "code": 404
}
Examples 
  • SONGID="user:[email protected]:so_3f9c2a7d81e64b05a9d2c4e7"
curl -X DELETE -H "Authorization: Bearer …" \
     "https://api.useapi.net/v1/acemusic/music/$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1],safe=''))" "$SONGID")"

  • const token = "API token";
const songId = "user:[email protected]:so_3f9c2a7d81e64b05a9d2c4e7";
const response = await fetch(`https://api.useapi.net/v1/acemusic/music/${encodeURIComponent(songId)}`, {
  method: "DELETE",
  headers: { "Authorization": `Bearer ${token}` }
});
console.log(response.status);

  • import requests
from urllib.parse import quote

token = "API token"
songId = "user:[email protected]:so_3f9c2a7d81e64b05a9d2c4e7"
response = requests.delete(f"https://api.useapi.net/v1/acemusic/music/{quote(songId, safe='')}",
                           headers={"Authorization": f"Bearer {token}"})
print(response.status_code)
Try It