# Update Audio Tags

> Learn how to update tags on a brand audio file

- **URL**: https://orshot.com/docs/api-reference/brand-audio-update

---

## Overview

This endpoint allows you to update the tags on a specific brand audio file in your workspace.```markdown tab="Endpoint"
https://api.orshot.com/v1/brand-assets/audio/update/:id
```## Request```js
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"],
  }),
});
```</Tab>```json
{
  "data": {
    "id": 42,
    "created_at": "2025-09-10T15:30:45.123Z",
    "name": "background-music.mp3",
    "original_filename": "background-music.mp3",
    "file_size": 2621440,
    "direct_url": "https://storage.orshot.com/cloud/w-50/renders/audio/background-music.mp3",
    "duration": 169.5,
    "format": "mp3",
    "mime_type": "audio/mpeg",
    "waveform_url": null,
    "metadata": {},
    "tags": ["intro", "music", "upbeat"],
    "workspace_id": 50,
    "user_id": "abcdef01-2345-6789-abcd-ef0123456789"
  }
}
```</Tab>
</Tabs>

## Path Parameters

| Parameter | Type   | Required | Description                                  |
| --------- | ------ | -------- | -------------------------------------------- |
| `id`      | Number | Yes      | The unique identifier of the audio to update |

## Request Parameters

| Parameter | Type     | Required | Description                                                    |
| --------- | -------- | -------- | -------------------------------------------------------------- |
| `tags`    | String[] | Yes      | Array of tags to set on the audio (replaces any existing tags) |

## 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)```json
{
  "error": "Audio not found"
}
```### Invalid Tags (400)```json
{
  "error": "\"tags\" must be an array of strings"
}
```## Rate Limits

- 30 requests per minute per endpoint