Coolify Octri Demo
POST/services/{uuid}/tags

Add tags to a service

Adds one or more tags to a service identified by its UUID. Provide either tag_name for a single tag or tag_names for multiple tags, with each name at least 2 characters long. A 201 response returns the added tag objects.

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

1 parameter · 2 body fields
uuidstringrequired
The UUID of the service to add tags to.

Provide either tag_name for a single tag or tag_names for multiple tags.

tag_namestringoptional
The tag name (min 2 characters). Required if tag_names is not provided.
tag_namesarray<string>optional
Array of tag names (each min 2 characters). Required if tag_name is not provided.

5 status codes
201Returns an array of the added tag objects, including each tag's UUID, name, and creation and update timestamps.
created_atstringoptional
namestringoptional
updated_atstringoptional
uuidstringoptional
400Returned when the token is invalid.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
404Returned when the service cannot be found.
messagestringoptional
422Returned when tag input fails validation.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned for an invalid token, and a 401 when the request is unauthenticated. A 404 is returned when the uuid path parameter does not identify an existing service. A 422 is returned when tag input fails validation: provide either tag_name or tag_names, and ensure each name has at least 2 characters.