POST/applications/{uuid}/tags

Create tags for an application

Creates one or more tags for an application. Provide either tag_name for one tag or tag_names for multiple tags; each tag name must contain at least 2 characters. The response includes the tags added to the application.

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

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

Tag details for an application. Provide either tag_name or tag_names.

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 tags added to the application, 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 requested application cannot be found.
messagestringoptional
422Returned when the tag input fails validation.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned for an invalid token, a 401 when the request is unauthenticated, a 404 when the application identified by the uuid path parameter cannot be found, and a 422 when tag input fails validation. Provide either tag_name or tag_names; each tag name must contain at least 2 characters.