v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB

Create a new tag.

Create a new tag with the specified data.

post/api/admin/tags

Request body

valuestring required

The value of the tag. The value must be between 2 and 50 characters long. Leading and trailing whitespace is ignored and will be trimmed before saving the tag value.

typestring required

The type of the tag

colorstring nullable

The hexadecimal color code for the tag type.

Example request

{
  "value": "a-tag-value",
  "type": "simple",
  "color": "#FFFFFF"
}

Response

The resource was successfully created.

versioninteger required

The version of the schema used to model the tag.

Example response

{
  "version": 1,
  "tag": {
    "value": "a-tag-value",
    "type": "simple",
    "color": "#FFFFFF"
  }
}