Create and manage labels

Create, edit, search, and delete labels on the Labels page, or manage them with the API.

• Create a label
• Edit a label
• Delete labels
• Search the label list
• Manage labels with the API

Create a label

1. Navigate to the Labels page.
2. Click Add Label.
3. Enter a name and, optionally, a description and a color. Label names must be unique.
4. Click Save.

Edit a label

1. On the Labels page, click the menu on the label’s row.
2. Click Edit.
3. Update the name, description, or color, and save. Renaming a label to an existing label’s name is rejected.

Edits apply everywhere the label is assigned.

Delete labels

To delete a single label, click the menu on the label’s row, and then click Delete.

To delete multiple labels, select their rows with the checkboxes, and then click Delete Labels.

Search the label list

Use the search box on the Labels page to find labels. The search matches both label names and descriptions. The list is sorted by name.

Manage labels with the API

Label management requires an API token with permission on the Labels API: read to list labels, write to create and edit them, and delete to delete them.

For example, to create a label:

curl -X POST "https://telegraf-controller.example.com/api/labels" \
  -H "Authorization: Bearer 
API_TOKEN
" \
  -H "Content-Type: application/json" \
  -d '{"name": "production", "description": "Production fleet", "color": "#3b82f6"}'

For request and response details, see the API reference at /api/docs on your Telegraf Controller server.