# Brandfolder Tags API

**Canonical:** https://apis.io/apis/brandfolder/brandfolder-tags-api/  
**Provider:** Brandfolder — https://apis.io/providers/brandfolder/  
**Base URL:** https://brandfolder.com/api/v4  
**Documentation:** https://developers.smartsheet.com/api/brandfolder

Brandfolder Tags API is one of 13 APIs that [Brandfolder](https://apis.io/providers/brandfolder/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Tags. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Tags can be assigned to Assets and are generally helpful for organizing and searching Assets within a Brandfolder. Each Tag is essentially a keyword associated with exactly one Asset. For example, if you have several Assets that represent products you sell, you might create a "product" Tag for each one. If you modify or delete the "product" Tag for any particular Asset, it will not affect other Tags with the same value on other Assets. Tags have a read-only attribute called `auto_generated` which indicates if the Tag was created automatically by our smart analysis of the file Attachment(s) (`true`) or if a User created the Tag (`false`). > **IMPORTANT:** Think carefully about whether Tags or Custom Fields are better suited to meet the needs of your particular use case.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/collections/{collection_id}/tags` | List tags in a collection |
| GET | `/assets/{asset_id}/tags` | List tags for an asset |
| POST | `/assets/{asset_id}/tags` | Create tags for an asset |
| GET | `/brandfolders/{brandfolder_id}/tags` | List tags in a Brandfolder |
| PUT | `/tags/{tag_id}` | Update a tag |
| DELETE | `/async/tags/assets/{asset_key}` | Delete tags |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/openapi/brandfolder-tags-api-openapi.yml
- **Documentation** — https://developers.smartsheet.com/api/brandfolder
- **APIReference** — https://developers.smartsheet.com/api/brandfolder/openapi
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/asyncapi/brandfolder-webhooks.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/mcp/brandfolder-tool-crosswalk.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/errors/brandfolder-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/data-model/brandfolder-data-model.yml

## Other Brandfolder APIs (12)

- [Brandfolder Assets API](https://apis.io/apis/brandfolder/brandfolder-assets-api/)
- [Brandfolder Attachments API](https://apis.io/apis/brandfolder/brandfolder-attachments-api/)
- [Brandfolder Binary Upload API](https://apis.io/apis/brandfolder/brandfolder-binary-upload-api/)
- [Brandfolder Brandfolders API](https://apis.io/apis/brandfolder/brandfolder-brandfolders-api/)
- [Brandfolder Collections API](https://apis.io/apis/brandfolder/brandfolder-collections-api/)
- [Brandfolder Custom Fields API](https://apis.io/apis/brandfolder/brandfolder-custom-fields-api/)
- [Brandfolder Invitations API](https://apis.io/apis/brandfolder/brandfolder-invitations-api/)
- [Brandfolder Labels API](https://apis.io/apis/brandfolder/brandfolder-labels-api/)
- [Brandfolder Organizations API](https://apis.io/apis/brandfolder/brandfolder-organizations-api/)
- [Brandfolder Sections API](https://apis.io/apis/brandfolder/brandfolder-sections-api/)
- [Brandfolder User Permissions API](https://apis.io/apis/brandfolder/brandfolder-user-permissions-api/)
- [Brandfolder Webhooks API](https://apis.io/apis/brandfolder/brandfolder-webhooks-api/)

## Tags

Tags

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/brandfolder/brandfolder-tags-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/brandfolder/.
