Create a new tag. | Unleash Documentation

Create a new tag with the specified data.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

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

Request

createTagSchema

valuestringRequiredformat: "^\s*\S.{0,48}\S\s*$"

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.

typestringRequired2-50 characters

The type of the tag

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

The hexadecimal color code for the tag type.

Response headers

locationstring

The location of the newly created resource.

Response

The resource was successfully created.

versioninteger

The version of the schema used to model the tag.

tagobject

Representation of a tag

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/tags \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"value": "a-tag-value",
>	"type": "simple"
>	}'

1	{
2	"version": 1,
3	"tag": {
4	"value": "a-tag-value",
5	"type": "simple",
6	"color": "#FFFFFF"
7	}
8	}

$	curl -X POST https://app.unleash-instance.example.com/api/admin/tags \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"value": "a-tag-value",
>	"type": "simple"
>	}'

1	{
2	"version": 1,
3	"tag": {
4	"value": "a-tag-value",
5	"type": "simple",
6	"color": "#FFFFFF"
7	}
8	}