# Tag management

You can manage your resource Tags via the following endpoints:

* List all tags: [`GET /v3/flexMetal/tags`](https://docs.i3d.net/api/api_flexmetal#get-v3-flexmetal-tags)
  * This will display all your tags with corresponding server count per tag.
* Remove a tag: [`DELETE /v3/flexMetal/tags/{tag}`](https://docs.i3d.net/api/api_flexmetal#delete-v3-flexmetal-tags-tag)
  * The tag will be removed from the system and will be removed from all servers that have the associated tag.
* Rename a tag: [`PUT /v3/flexMetal/tags/{tag}`](https://docs.i3d.net/api/api_flexmetal#put-v3-flexmetal-tags-tag)
  * This will rename the tag. Note that this renames the tag for all associated servers as well.
  * The request body must be: `{ "tag": "my_renamed_tag" }`
* Add a tag to a server: `POST /v3/flexMetal/servers/{uuid}/tag/{tag}`
* Remove a tag from a server: `DELETE /v3/flexMetal/servers/{uuid}/tag/{tag}`

{% hint style="info" %}

* Tags are case-sensitive.
* Tags can be up to 64 characters long and can contain only the following characters:\
  `[A-Za-z0-9_:-]{1,64}`
* A FlexMetal server can have up to 60 tags.
  {% endhint %}

## Related topics

* [What is FlexMetal?](/compute/flexmetal.md)
* [Getting started using API](/compute/flexmetal/api.md)
* [OS Customization using Linux](/compute/flexmetal/os-customization.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.i3d.net/compute/flexmetal/tag-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.