Tags

List Tags

get

Retrieve project tags used to organize customers and reviews.

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Success

application/json

Object containing response data for this resource.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Short code or application-level status code for this resource.

get

/tags

HTTPcURLJavaScriptPython

GET /project/tags HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "success": true,
  "code": 200,
  "data": [
    {
      "id": 9,
      "uuid": "719c34f3-30fd-4d9e-82dd-172ce6d554af",
      "name": "VIP",
      "slug": "vip",
      "sprite": "fas fa-star",
      "color": "#F59E0B",
      "context": "customer",
      "ai_instructions": null,
      "has_ai_tagging": false
    }
  ]
}

Create Tag

post

Create a project tag for customer or review organization.

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Request body for creating a project tag.

namestringRequired

Display name for this tag.

colorstring · nullableOptional

Hex color associated with this tag.

spritestring · nullableOptional

Icon sprite class used when displaying this tag.

contextstring · enum · nullableOptional

Resource type this tag applies to.

Possible values:

ai_instructionsstring · nullableOptional

Instructions used by AI tagging for review tags.

has_ai_taggingboolean · nullableOptional

Whether AI tagging is enabled for this tag.

Responses

200

Success

application/json

Object containing response data for this resource.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Application-level status code returned by More Good Reviews.

post

/tags

HTTPcURLJavaScriptPython

POST /project/tags HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 207

{
  "name": "Great Service",
  "context": "review",
  "color": "#10B981",
  "sprite": "fas fa-thumbs-up",
  "ai_instructions": "Apply this tag to reviews that praise friendly, helpful, or timely service.",
  "has_ai_tagging": true
}

200

Success

{
  "success": true,
  "code": 200,
  "data": {
    "id": 801,
    "uuid": "19bb3170-f4dc-4fc7-986b-dd2360f07f4e",
    "name": "Great Service",
    "slug": "great-service",
    "sprite": "fas fa-thumbs-up",
    "color": "#10B981",
    "context": "review",
    "ai_instructions": null,
    "has_ai_tagging": false
  }
}

Update Tag

put

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

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idintegerRequired

Unique numeric identifier for this tag.

Body

application/json

Request body for updating a project tag.

namestringRequired

Display name for this tag.

slugstring · max: 30 · nullableOptional

Stable URL-safe slug override; must remain unique among project tags when provided.

colorstring · nullableOptional

Hex color associated with this tag.

spritestring · nullableOptional

Icon sprite class used when displaying this tag.

ai_instructionsstring · nullableOptional

Instructions used by AI tagging for review tags when has_ai_tagging is true.

has_ai_taggingboolean · nullableOptional

Whether AI tagging is enabled for this tag on review-context tags.

Responses

200

Success

application/json

Object containing response data for this resource.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Application-level status code returned by More Good Reviews.

put

/tags/{id}

HTTPcURLJavaScriptPython

PUT /project/tags/{id} HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 205

{
  "name": "Great Team",
  "slug": "great-team",
  "color": "#059669",
  "sprite": "fas fa-thumbs-up",
  "ai_instructions": "Apply when reviews mention friendly staff or standout teamwork experiences.",
  "has_ai_tagging": true
}

200

Success

{
  "success": true,
  "code": 200,
  "data": {
    "id": 801,
    "uuid": "19bb3170-f4dc-4fc7-986b-dd2360f07f4e",
    "name": "Great Team",
    "slug": "great-team",
    "sprite": "fas fa-thumbs-up",
    "color": "#059669",
    "context": "review",
    "ai_instructions": "Apply when reviews mention friendly staff or standout teamwork experiences.",
    "has_ai_tagging": true
  }
}

Delete Tag

delete

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

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idintegerRequired

Unique numeric identifier for this tag.

Responses

200

Success

application/json

Object confirming the tag was deleted.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Application-level status code returned by More Good Reviews.

delete

/tags/{id}

HTTPcURLJavaScriptPython

DELETE /project/tags/{id} HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "success": true,
  "code": 200
}