Delete an agent

DELETE /api/fleet/agents/{agentId}

Delete an agent by ID.

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

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
- error string
- message string Required
- statusCode number

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
}