---
title: "Uninstall Agent"
method: DELETE
path: "/v1/agents/{id}"
tags: ["Agents"]
---

# Uninstall Agent

`DELETE /v1/agents/{id}`

Schedules a remote uninstall of a single Agent, removing the Huntress agent
from the host. Uninstall is asynchronous: the host is tasked to uninstall on
its next callback, and the Agent is immediately removed from your account, so
subsequent requests for it return 404.

This endpoint requires an API key with permission to uninstall agents.
**Note that the default account API key is read-only, so you'll need to create a
user-based API key with the appropriate permissions to access this endpoint.**

## Path parameters

- `id` integer, required

## Response `204`

Agent scheduled for uninstall.

## Other responses

- `403` — There was an issue with your API credential or permissions.
- `404` — Agent not found.

---

[API](https://skmtc.net/huntress/apis/huntress-api-reference.md) · [All operations](https://skmtc.net/huntress/apis/huntress-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huntress/huntress-api-reference/revisions/94acb422c07d/schema)