POST/databases/{uuid}/tags

Create tags for a database

Creates one or more tags for a database. Provide either tag_name for one tag or tag_names for multiple tags, and make each tag name at least two characters long. The 201 response returns the created tags with their identifiers and timestamps.

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

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

Tag names to add to the database. 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 created 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 database resource is not found.
messagestringoptional
422Returned when the request fails validation.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned for an invalid token, and a 401 is returned when the request is unauthenticated. A 404 indicates that the database resource was not found; a 422 indicates that the request failed validation. Provide either tag_name or tag_names, and make each tag name at least two characters long; the uuid path parameter must identify a database.