Get agent tags

Auth

Get a list of all tags used across enrolled agents.

Required privileges

space_id string optional: An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.

kuery string · min length: 0: A KQL query string to filter results
showInactive boolean · default: false: When true, include tags from inactive agents

Successful response

application/json

Bad Request

application/json

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

GET kbn:/api/fleet/agents/tags

Generated from the API spec

curl Shell

curl -X GET "${KIBANA_URL}/api/fleet/agents/tags" \
  -H "Authorization: ApiKey ${API_KEY}"

Generated from the API spec

Response

List of tags used across agents

{
  "items": [
    "production",
    "linux",
    "datacenter-1"
  ]
}

{
  "error": "Bad Request",
  "message": "An error message describing what went wrong",
  "statusCode": 400
}