Creates a new tag with the provided properties.
If successful, this endpoint will return a 200 OK status.
One of the following scopes are required to use this endpoint.
The following arguments are supported for this endpoint.
Name | Type | Default Value |
---|---|---|
organization Required The organization to create the new tag for |
Organization Lookup | None |
properties Required The details for the new tag to be created |
TagArguments | None |
The following errors may occur during this request.
Details | HTTP status |
---|---|
An organization was found from the arguments provided but it wasn't activated yet |
403 Forbidden |
No organization was found matching any of the criteria provided in the arguments |
404 Not Found |
An organization was found from the arguments provided but it was suspended |
403 Forbidden |
The authenticated identity is not permitted to perform this action |
403 Forbidden |
A validation error occurred with the object that was being created/updated/deleted |
422 Unprocessable Entity |
When the request is successful, you can expect an object matching the specification below to be returned.
{ tag: Tag { id: String name: String color: TagColorsEnum created_at: Unix Timestamp } }