CommonTags

Create a tag

Create a new tag. The tag name must be unique. Tag names are case-sensitive, that is Marketing and marketing are two different tags.

The response returns an auto-generated ID assigned to this tag. To assign this tag to a resource, send the tag ID in the tag_ids list when creating or updating a resource.

Authentication

AuthorizationBearer

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

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
namestringRequired1-255 characters
The tag name. Must be unique.
categoryenumOptional
The tag category.
descriptionstringOptional1-255 characters
The tag description.

Response

Successful Response
idstringformat: "uuid"
A unique ID of this tag.
created_atdatetime
Date and time when the tag was created. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
updated_atdatetime
Date and time when the tag was last updated. Timestamps follow the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
namestring
The tag name.
categoryenum
The tag category.
created_by_entity_user_idstringformat: "uuid"
ID of the user who created the tag.
descriptionstring1-255 characters
The tag description.

Errors

400
Post Tags Request Bad Request Error
401
Post Tags Request Unauthorized Error
403
Post Tags Request Forbidden Error
404
Post Tags Request Not Found Error
406
Post Tags Request Not Acceptable Error
422
Post Tags Request Unprocessable Entity Error
500
Post Tags Request Internal Server Error