# 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."}}}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.moregoodreviews.com/platform/api-reference/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.