Delete Audio

Overview#

This endpoint allows you to delete a specific brand audio file from your workspace using its unique ID.

https://api.orshot.com/v1/brand-assets/audio/delete/:id

Request#

await fetch("https://api.orshot.com/v1/brand-assets/audio/delete/42", {
  method: "DELETE",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Path Parameters#

Error Responses#

Audio Not Found (404)#

{
  "error": "Audio not found"
}

Missing Audio ID (400)#

{
  "error": "Audio ID is required"
}

Unauthorized (403)#

{
  "error": "Access Forbidden"
}

Notes#

• The audio must belong to your workspace
• Once deleted, audio cannot be recovered

Query Parameters#

Per-User Libraries#

Pass embedId and embedUserId together to target only that embed user's audio, so one user's ID can never delete another's. This is how one embed serves many brands or tenants, each with its own brand space.

Omit them and this endpoint behaves exactly as documented above. See Per-User Brand Assets for the full picture.

Rate Limits#

• 30 requests per minute per endpoint