Bulk update agent tags

POST /api/fleet/agents/bulk_update_agent_tags

Headers

  • kbn-xsrf string Required

    Kibana's anti Cross-Site Request Forgery token. Can be any string value.

application/json; Elastic-Api-Version=2023-10-31

Body

Responses

  • 200 application/json; Elastic-Api-Version=2023-10-31

    OK

    Hide response attribute Show response attribute object
  • 400 application/json; Elastic-Api-Version=2023-10-31

    Generic Error

    Hide response attributes Show response attributes object
POST /api/fleet/agents/bulk_update_agent_tags
curl \
 -X POST https://localhost:5601/api/fleet/agents/bulk_update_agent_tags \
 -H "Content-Type: application/json; Elastic-Api-Version=2023-10-31" \
 -H "kbn-xsrf: string"
Request example
{
  "agents": [
    "agent1",
    "agent2"
  ],
  "tagsToAdd": [
    "newTag"
  ],
  "tagsToRemove": [
    "existingTag"
  ]
}
Response examples (200)
{
  "actionId": "string"
}
Response examples (400)
{
  "error": "string",
  "message": "string",
  "statusCode": 42.0
}