Update Audio Tags

Overview#

This endpoint allows you to update the tags on a specific brand audio file in your workspace.

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

Request#

await fetch("https://api.orshot.com/v1/brand-assets/audio/update/42", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    tags: ["intro", "music", "upbeat"],
  }),
});

Path Parameters#

Request Parameters#

Notes#

• Tags are automatically normalized: trimmed, deduplicated (case-insensitive), and empty values are removed
• Passing an empty array [] will clear all tags from the audio

Error Responses#

Audio Not Found (404)#

{
  "error": "Audio not found"
}

Invalid Tags (400)#

{
  "error": "\"tags\" must be an array of strings"
}

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 retag 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