Create tag

View as Markdown

Creates a workspace tag. Requires the tags:write scope.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired1-255 characters
descriptionstringOptional1-2000 characters
hex_colorstringOptionalformat: "^#[A-Fa-f0-9]{6}$"
auto_tagging_enabledbooleanOptional

Response headers

X-Api-Versionstring

Response

Created tag response.
objectenum
Allowed values:
idstringformat: "^tag_[A-Za-z0-9]+$"
namestring
created_atdatetime
updated_atdatetime
hex_colorstring or nullformat: "^#[A-Fa-f0-9]{6}$"
descriptionstring or null
auto_tagging_enabledboolean

Errors

401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error