Skip to content

TagColors

User Guide

For a user-facing walkthrough, see Items & Tags.

Per-location color assignments for tags.


GET /api/tag-colors

Lists all tag color assignments for a location.

Query parameters

ParameterTypeRequiredDescription
location_idUUIDYes

Response (200)

json
{
  "results": [
    {
      "id": "uuid",
      "location_id": "uuid",
      "tag": "fragile",
      "color": "red-500",
      "created_at": "...",
      "updated_at": "..."
    }
  ],
  "count": 5
}

PUT /api/tag-colors

Creates or updates the color for a tag in a location (upsert).

Request body

FieldTypeRequiredDescription
locationIdUUIDYes
tagstringYesTag name
colorstringYesColor preset key

Response (200): The saved TagColor object.


DELETE /api/tag-colors/{tag}

Removes the color assignment for a tag.

Path parameters: tag (tag name)

Query parameters

ParameterTypeRequiredDescription
location_idUUIDYes

Response (200): { "message": "Tag color removed" }

Released under the GPL-3.0 License.