Coolify Octri Demo
POST/tags

Create a team tag

Creates a tag for the authenticated user's team. Set name to a value between 2 and 255 characters; tag names must be unique within the team. A 201 response returns the created tag with its identifier and timestamps.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 body field

The tag details to create for the authenticated user's team.

namestringrequired
The tag name. Must be between 2 and 255 characters.

5 status codes
201Returns the created tag object, including its `uuid`, `name`, `created_at`, and `updated_at`.
created_atstringoptional
namestringoptional
updated_atstringoptional
uuidstringoptional
400Returned when the authentication token is invalid.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
409Returned when a tag with the same name already exists.
422Returned when the request body fails validation, such as when `name` is missing or outside the allowed length.
errorsobjectoptional
messagestringoptional

Error handling

An invalid token returns a 400. A 401 is returned when the request is unauthenticated. A 409 indicates that a tag with the same name already exists. The name field must be 2 to 255 characters; invalid values return a 422.