# Conversation Tags

Conversation tags let you organize, filter, and automate around inbox conversations. Use these endpoints to list, look up, create, rename, and delete workspace conversation tags.

## List workspace tags

 - [GET /v2/tags](https://docs.featurebase.app/rest-api/conversation-tags/listtags.md): Returns the live conversation tags available in the workspace tag catalog. These are the canonical tags that power conversation payloads, filters, and tag mutation endpoints.

## Create or rename a tag

 - [POST /v2/tags](https://docs.featurebase.app/rest-api/conversation-tags/upserttag.md): Creates a new workspace conversation tag when only name is provided. If id is also provided, the existing tag is renamed instead.

## Get tag by ID

 - [GET /v2/tags/{id}](https://docs.featurebase.app/rest-api/conversation-tags/gettagbyid.md): Returns a single conversation tag by its Featurebase tag ID. Archived tags can still be retrieved directly by ID, while permanently deleted tags return 404.

## Delete a tag

 - [DELETE /v2/tags/{id}](https://docs.featurebase.app/rest-api/conversation-tags/deletetag.md): Deletes a conversation tag from the workspace catalog and removes it from aggregate conversation tag state. Archived and historical part applications remain part of the audit trail where applicable.