> For the complete documentation index, see [llms.txt](https://docs.moregoodreviews.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moregoodreviews.com/platform/api-reference/tags.md).

# Tags

## List Tags

> Retrieve project tags used to organize customers and reviews.

```json
{"openapi":"3.0.3","info":{"title":"MGR Project API","version":"1.0.0"},"tags":[{"name":"Tags"}],"servers":[{"url":"https://api.moregoodreviews.com/project"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ApiKey"}},"schemas":{"SpriteClass":{"type":"string","maxLength":50,"pattern":"^(fab|fad|fak|fal|far|fas|fat)\\s+fa-[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Font Awesome icon: two CSS class names as used with Font Awesome Web Fonts / classic CSS (not SVG/React props).\nFormat is a style prefix (`fab`, `fad`, `fak`, `fal`, `far`, `fas`, or `fat`), one ASCII space, then an icon slug\nstarting with `fa-` (lowercase letters and digits, hyphen-separated words). Examples: `fab fa-google`, `fas fa-star`.\nOn write, omit, send null, or whitespace-only to clear. Font Awesome 6 semantic pairs such as `fa-solid fa-star`\nare not accepted; use `fas fa-star` instead."}}},"paths":{"/tags":{"get":{"tags":["Tags"],"summary":"List Tags","operationId":"listTags","description":"Retrieve project tags used to organize customers and reviews.","parameters":[{"name":"context","in":"query","required":false,"schema":{"type":"string","nullable":true,"description":"When set, only tags for this scope are returned; omit for all tags.","enum":["customer","review"]},"description":"When set, only tags for this scope are returned; omit for all tags."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Object containing response data for this resource.","properties":{"success":{"type":"boolean","description":"Indicates whether the request completed successfully."},"code":{"type":"integer","description":"Short code or application-level status code for this resource."},"data":{"type":"array","description":"Response payload for the request.","items":{"type":"object","description":"Response payload for the request.","properties":{"id":{"type":"integer","description":"Unique numeric identifier for this resource."},"uuid":{"type":"string","description":"Stable UUID for this resource."},"name":{"type":"string","description":"Display name for this resource."},"slug":{"type":"string","description":"URL-friendly identifier for this resource."},"sprite":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/SpriteClass"}]},"color":{"type":"string","description":"Hex color associated with the resource."},"context":{"type":"string","description":"Additional context describing how this resource is used."},"ai_instructions":{"type":"string","description":"Instructions used by AI features for this resource.","nullable":true},"has_ai_tagging":{"type":"boolean","description":"Whether AI tagging is enabled for this resource."}}}}}}}}}}}}}}
```

## Create Tag

> Create a project tag for customer or review organization.

```json
{"openapi":"3.0.3","info":{"title":"MGR Project API","version":"1.0.0"},"tags":[{"name":"Tags"}],"servers":[{"url":"https://api.moregoodreviews.com/project"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ApiKey"}},"schemas":{"SpriteClass":{"type":"string","maxLength":50,"pattern":"^(fab|fad|fak|fal|far|fas|fat)\\s+fa-[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Font Awesome icon: two CSS class names as used with Font Awesome Web Fonts / classic CSS (not SVG/React props).\nFormat is a style prefix (`fab`, `fad`, `fak`, `fal`, `far`, `fas`, or `fat`), one ASCII space, then an icon slug\nstarting with `fa-` (lowercase letters and digits, hyphen-separated words). Examples: `fab fa-google`, `fas fa-star`.\nOn write, omit, send null, or whitespace-only to clear. Font Awesome 6 semantic pairs such as `fa-solid fa-star`\nare not accepted; use `fas fa-star` instead."}}},"paths":{"/tags":{"post":{"tags":["Tags"],"summary":"Create Tag","operationId":"createTag","description":"Create a project tag for customer or review organization.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request body for creating a project tag.","properties":{"name":{"type":"string","description":"Display name for this tag."},"color":{"type":"string","nullable":true,"description":"Hex color associated with this tag."},"sprite":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/SpriteClass"}]},"context":{"type":"string","nullable":true,"description":"Resource type this tag applies to.","enum":["review","customer"]},"ai_instructions":{"type":"string","nullable":true,"description":"Instructions used by AI tagging for review tags."},"has_ai_tagging":{"type":"boolean","nullable":true,"description":"Whether AI tagging is enabled for this tag."}},"required":["name"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Object containing response data for this resource.","properties":{"success":{"type":"boolean","description":"Indicates whether the request completed successfully."},"code":{"type":"integer","description":"Application-level status code returned by this API."},"data":{"type":"object","description":"Project tag metadata.","properties":{"id":{"type":"integer","description":"Unique numeric identifier for this tag."},"uuid":{"type":"string","description":"Stable UUID for this tag."},"name":{"type":"string","description":"Display name for this tag."},"slug":{"type":"string","description":"URL-friendly identifier for this tag."},"sprite":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/SpriteClass"}]},"color":{"type":"string","description":"Hex color associated with this tag."},"context":{"type":"string","description":"Resource type this tag applies to.","enum":["review","customer"]},"ai_instructions":{"type":"string","nullable":true,"description":"Instructions used by AI tagging for review tags."},"has_ai_tagging":{"type":"boolean","description":"Whether AI tagging is enabled for this tag."}}}}}}}}}}}}}
```

## Update Tag

> Rename, recolor, or adjust slug and AI tagging settings for an existing workspace tag.

```json
{"openapi":"3.0.3","info":{"title":"MGR Project API","version":"1.0.0"},"tags":[{"name":"Tags"}],"servers":[{"url":"https://api.moregoodreviews.com/project"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ApiKey"}},"schemas":{"SpriteClass":{"type":"string","maxLength":50,"pattern":"^(fab|fad|fak|fal|far|fas|fat)\\s+fa-[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Font Awesome icon: two CSS class names as used with Font Awesome Web Fonts / classic CSS (not SVG/React props).\nFormat is a style prefix (`fab`, `fad`, `fak`, `fal`, `far`, `fas`, or `fat`), one ASCII space, then an icon slug\nstarting with `fa-` (lowercase letters and digits, hyphen-separated words). Examples: `fab fa-google`, `fas fa-star`.\nOn write, omit, send null, or whitespace-only to clear. Font Awesome 6 semantic pairs such as `fa-solid fa-star`\nare not accepted; use `fas fa-star` instead."}}},"paths":{"/tags/{id}":{"put":{"tags":["Tags"],"summary":"Update Tag","operationId":"updateTag","description":"Rename, recolor, or adjust slug and AI tagging settings for an existing workspace tag.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request body for updating a project tag.","properties":{"name":{"type":"string","description":"Display name for this tag."},"slug":{"type":"string","nullable":true,"maxLength":30,"description":"Stable URL-safe slug override; must remain unique among project tags when provided."},"color":{"type":"string","nullable":true,"description":"Hex color associated with this tag."},"sprite":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/SpriteClass"}]},"ai_instructions":{"type":"string","nullable":true,"description":"Instructions used by AI tagging for review tags when has_ai_tagging is true."},"has_ai_tagging":{"type":"boolean","nullable":true,"description":"Whether AI tagging is enabled for this tag on review-context tags."}},"required":["name"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Object containing response data for this resource.","properties":{"success":{"type":"boolean","description":"Indicates whether the request completed successfully."},"code":{"type":"integer","description":"Application-level status code returned by this API."},"data":{"type":"object","description":"Project tag metadata.","properties":{"id":{"type":"integer","description":"Unique numeric identifier for this tag."},"uuid":{"type":"string","description":"Stable UUID for this tag."},"name":{"type":"string","description":"Display name for this tag."},"slug":{"type":"string","description":"URL-friendly identifier for this tag."},"sprite":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/SpriteClass"}]},"color":{"type":"string","description":"Hex color associated with this tag."},"context":{"type":"string","description":"Resource type this tag applies to.","enum":["review","customer"]},"ai_instructions":{"type":"string","nullable":true,"description":"Instructions used by AI tagging for review tags."},"has_ai_tagging":{"type":"boolean","description":"Whether AI tagging is enabled for this tag."}}}}}}}}}}}}}
```

## Delete Tag

> Soft-delete a workspace tag shared across customers and reviews.

```json
{"openapi":"3.0.3","info":{"title":"MGR Project API","version":"1.0.0"},"tags":[{"name":"Tags"}],"servers":[{"url":"https://api.moregoodreviews.com/project"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ApiKey"}}},"paths":{"/tags/{id}":{"delete":{"tags":["Tags"],"summary":"Delete Tag","operationId":"deleteTag","description":"Soft-delete a workspace tag shared across customers and reviews.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Object confirming the tag was deleted.","properties":{"success":{"type":"boolean","description":"Indicates whether the request completed successfully."},"code":{"type":"integer","description":"Application-level status code returned by this API."}}}}}}}}}}}
```