Skip to main content
POST
Recovery Audio
Used to recover playable audio links for a music generation task that has already completed. Submit the sunoTaskId of the original task and the service regenerates accessible audio URLs for every track that belongs to it.

🚀 User Guide

  • Suno’s original links are only valid for a limited period of time. Once they expire, the audio can no longer be played or downloaded from those URLs.
  • Submit the sunoTaskId of the original music generation task — all tracks of that task are recovered together.
  • This endpoint only creates the task: it returns a recovery task_id immediately and the recovery itself runs asynchronously.
  • The result is pushed to callBackUrl when the task finishes, and can also be read by polling Get Recovery Audio Details.
source_audio_url is deprecated.source_audio_url in the generation responses and callbacks points to Suno’s original file. That link expires after a period of time and is no longer maintained, so it must not be stored for long-term use. Call this endpoint to obtain a fresh playable link instead.

📌 Usage Scenarios

  • 🔗 Restoring playback for songs that were generated a long time ago
  • 📦 Refreshing audio links before archiving or migrating your own library
  • 🛠️ Repairing broken audio URLs reported by your end users

⚠️ Notes

  • sunoTaskId in the request body is the music generation task ID (for example the one returned by Generate Music), not the ID returned by this endpoint.
  • The task_id in the response is the recovery task ID and is only accepted by Get Recovery Audio Details.
  • callBackUrl is required. The recovery result is pushed to it once the task finishes.
  • Creating the task successfully does not guarantee that every track can be recovered — check the final result for the per-track status.

📩 Callback

Once the recovery task finishes, a POST request is sent to callBackUrl:
The task level code is 200 when at least one track was recovered, and 500 when all of them failed. The order of data matches the tracks of the original task.

Authorizations

Authorization
string
header
required

🔑 API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

⚠️ Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Body

application/json
sunoTaskId
string
required

The task ID of the original music generation task whose audio links need to be recovered.

Example:

"5c79****be8e"

callBackUrl
string<uri>
required

Callback URL notified when the recovery task finishes. The recovery result is pushed to this address.

Example:

"https://api.example.com/callback"

Response

Request successful

code
enum<integer>

Status Codes

  • ✅ 200 - Request successful
  • ⚠️ 400 - Invalid parameters
  • ⚠️ 401 - Unauthorized access
  • ⚠️ 404 - Invalid request method or path
  • ⚠️ 405 - Rate limit exceeded
  • ⚠️ 413 - Theme or prompt too long
  • ⚠️ 429 - Insufficient credits
  • ⚠️ 430 - Your call frequency is too high. Please try again later.
  • ⚠️ 455 - System maintenance
  • ❌ 500 - Server error
Available options:
200,
400,
401,
404,
405,
413,
429,
430,
455,
500
Example:

200

msg
string

Error message when code != 200

Example:

"success"

data
object