POST /v1/generations/bulk-delete

Permanently delete up to 100 of your tracks in a single request. Deleted tracks disappear from your library, any playlists they were in, and all public pages immediately — this cannot be undone via the API.

Each ID is checked individually, so one bad ID doesn't fail the whole request: the response lists what was deleted plus a per-item errors array for anything that wasn't.

Request

POST https://pub.finetuning.ai/v1/generations/bulk-delete

Headers

Header	Type	Required	Description
`X-API-Key`	string	Yes	Your API key
`Content-Type`	string	Yes	`application/json`

Body

Field	Type	Required	Description
`ids`	string[]	Yes	1–100 track IDs you own

Example

curl -X POST https://pub.finetuning.ai/v1/generations/bulk-delete \
  -H "X-API-Key: ft_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["a4f6c1e9-2d3b-4c8a-9e5f-7b1d0c2a8e64", "c7d2e8a1-5f4b-4e9c-8a6d-3b9f1e0c5a72", "f0a3b6d9-8c2e-4f5a-b1c7-6e4d2a9b0c38"]}'

Response

200 OK

{
  "data": {
    "deleted": ["a4f6c1e9-2d3b-4c8a-9e5f-7b1d0c2a8e64", "c7d2e8a1-5f4b-4e9c-8a6d-3b9f1e0c5a72"],
    "errors": [
      { "id": "f0a3b6d9-8c2e-4f5a-b1c7-6e4d2a9b0c38", "error": "Track not found or not owned by you" }
    ]
  }
}

Response fields

Field	Type	Description
`data.deleted`	string[]	IDs that were successfully deleted
`data.errors`	array	Per-item failures — omitted when every ID succeeded
`data.errors[].id`	string	The ID that failed
`data.errors[].error`	string	Why it failed

The request returns 200 OK even if nothing was deleted — check data.deleted rather than the status code. A track fails individually if it doesn't exist, was already deleted, or belongs to another user.

Errors

Code	Status	Description
`VALIDATION_ERROR`	400	`ids` is missing, empty, contains non-strings, or has more than 100 items
`MISSING_API_KEY`	401	X-API-Key header was not provided
`INVALID_API_KEY`	401	API key is malformed, revoked, or does not exist
`INTERNAL_ERROR`	500	Unexpected server error