Validate a tag type | Unleash Documentation

Validates whether if the body of the request is a valid tag and whether the a tag type with that name already exists or not. If a tag type with the same name exists, this operation will return a 409 status code.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

API key needed to access this API, in Bearer token format

Request

tagTypeSchema

namestringRequired

The name of the tag type.

descriptionstringOptional

The description of the tag type.

iconstring or nullOptional

The icon of the tag type.

colorstring or nullOptionalformat: "^#[0-9A-Fa-f]{6}$"

The hexadecimal color code for the tag type.

Response

validateTagTypeSchema

validboolean

Whether or not the tag type is valid.

tagTypeobject

A tag type.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

415

Unsupported Media Type Error

$	curl -X POST https://app.unleash-instance.example.com/api/admin/tag-types/validate \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "color"
>	}'

1	{
2	"valid": true,
3	"tagType": {
4	"name": "color",
5	"description": "A tag type for describing the color of a tag.",
6	"icon": "not-really-used",
7	"color": "#FFFFFF"
8	}
9	}

$	curl -X POST https://app.unleash-instance.example.com/api/admin/tag-types/validate \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "color"
>	}'

1	{
2	"valid": true,
3	"tagType": {
4	"name": "color",
5	"description": "A tag type for describing the color of a tag.",
6	"icon": "not-really-used",
7	"color": "#FFFFFF"
8	}
9	}