Delete an agent Beta

DELETE /api/fleet/agents/{agentId}

Delete an agent by ID.

Headers

  • elastic-api-version string

    The version of the API to use

    Value is 2023-10-31. Default value is 2023-10-31.

  • kbn-xsrf string Required

    A required header to protect against CSRF attacks

Responses

  • 200 application/json; Elastic-Api-Version=2023-10-31
    Hide response attribute Show response attribute object
    • action string Required

      Value is deleted.
  • 400 application/json; Elastic-Api-Version=2023-10-31
    Hide response attributes Show response attributes object
DELETE /api/fleet/agents/{agentId} 
curl \
 -X DELETE https://localhost:5601/api/fleet/agents/{agentId} \
 -H "elastic-api-version: 2023-10-31" \
 -H "kbn-xsrf: true"
Response examples (200) 
{
  "action": "deleted"
}
Response examples (400) 
{
  "error": "string",
  "message": "string",
  "statusCode": 42.0
}