For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Tags are custom labels you can apply to Weaviate clusters and other DigitalOcean resources. You can use tags to organize clusters for billing and reporting.

Choosing terms that describe a cluster’s function can help you locate and administer clusters that share common roles. For example, you might tag a cluster by:

• Environment, like production, staging or development.
• Purpose, like a project name or any other key term that describes the use of the cluster.
• Person, like the individual or team responsible for managing the cluster.

You can add tags during or after creation.

Limits

• Tags must be a single word containing only letters, numbers, colons, dashes, and underscores.

Known Issues

• You cannot edit existing tags. Instead, create a new tag, apply it to the appropriate resources, and delete the old one.
• Tag names are case stable, which means the capitalization you use when you first create a tag is canonical.
  • Tagged resources in the Control Panel always display the canonical capitalization. For example, if you create a tag named PROD, you can tag resources in the Control Panel by entering prod. The tag still displays with its canonical capitalization, PROD.
  • When working with tags in the API, you must use the tag’s canonical capitalization. For example, if you create a tag named PROD, the URL to add that tag to a resource would be https://api.digitalocean.com/v2/tags/PROD/resources (not /v2/tags/prod/resources).

Tag Clusters During Creation

You can add tags when you create a Weaviate cluster. In the Finalize and Create section of the Create Vector Database page, in the Tags field, enter your tags.

You can also pass tags in the API request body when creating a cluster:

curl -X POST "https://api.digitalocean.com/v2/vector-databases" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-vector-db",
    "region": "tor1",
    "size": "small",
    "project_id": "'"$PROJECT_ID"'",
    "tags": ["production", "ml-team"]
  }'

Tag Existing Clusters

To add or modify an existing cluster’s tags, go to the Vector Databases page, click the cluster’s … menu, and then select Edit tags. You can also select a cluster, click the Settings tab, and then click Edit tags in the Tags section.

In the Edit tags window, add tags as needed. When finished, click Save tags.

To replace the full tag set using the API, send a PUT request:

curl -X PUT "https://api.digitalocean.com/v2/vector-databases/$CLUSTER_ID/tags" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "tags": ["production", "v2", "critical"] }'

This replaces all existing tags with the new set. To remove all tags, pass an empty array.

Filter by Tag

After you tag clusters, filter the Control Panel to see every resource that uses a tag. Click a tag on a project dashboard or on the database clusters list to open the filtered view.

Filter lists are limited to a single tag, displayed at the top of the list.