Delete Music

August 17, 2026

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

Deletes a song from the MiniMax account it was generated on. The track disappears from GET music and its audio_url stops resolving, so download anything you want to keep first.

https://api.useapi.net/v1/minimax/music/{musicId}

Request Headers 
Authorization: Bearer {API token}
Query Parameters
  • musicId is required, the value returned by POST music/create. Path parameter, for example user:12345-minimax:123456789012345678-music:987654321098765.

Notes:

  • The account is taken from the musicId itself, so no account parameter is needed.
  • A song that is still rendering cannot be deleted — the call returns 409. Wait until GET music/musicId reports statusFinal as true, then delete. The generation is unaffected by the rejected attempt.
Responses

  • 200 OK

    {
  "musicId": "user:12345-minimax:123456789012345678-music:987654321098765",
  "deleted": true
}

  • 400 Bad Request

    {
  "error": "Path parameter musicId (bogus) has incorrect format",
  "code": 400
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}

  • 409 Conflict

    {
  "error": "This song is still generating and cannot be deleted yet. Wait for statusFinal, then delete.",
  "code": 409
}

  • 596 Account Error

    {
  "error": "Your minimax account has pending error. Please address this issue at https://useapi.net/docs/api-minimax-v1/post-minimax-accounts-account before making any new API calls.",
  "code": 596
}

A musicId belonging to a different useapi.net user is rejected with 400 Path parameter musicId (…) unauthorized access to user:NNNNN detected.

Model 
{ // TypeScript, all fields are optional
  musicId: string,       // The song that was deleted
  deleted: boolean
}
Examples 
  • curl -X DELETE "https://api.useapi.net/v1/minimax/music/user:12345-minimax:123456789012345678-music:987654321098765" \
  -H "Authorization: Bearer …"

  • const musicId = "user:12345-minimax:123456789012345678-music:987654321098765";

const response = await fetch(`https://api.useapi.net/v1/minimax/music/${musicId}`, {
  method: "DELETE",
  headers: { "Authorization": "Bearer …" }
});

console.log(await response.json());

  • import requests

music_id = "user:12345-minimax:123456789012345678-music:987654321098765"

response = requests.delete(
    f"https://api.useapi.net/v1/minimax/music/{music_id}",
    headers={"Authorization": "Bearer …"}
)

print(response.json())
Try It