---
title: "Destroy an agent"
method: DELETE
path: "/agents/{agent_id}"
tags: ["Agents"]
---

# Destroy an agent

`DELETE /agents/{agent_id}`

## Request

- Base URL: `https://api-docs.jackhamr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.jackhamr.ai/agents/{agent_id}`
- Auth: none declared

Destroy an agent and clean up all resources.

Removes the Proxmox LXC container, WireGuard tunnel, SSH pool
registration, and snapshots. ``force=true`` destroys even if the
agent is currently running. This is a **soft delete**: the record
remains readable via ``GET /agents/{id}`` afterward with
``status: "destroyed"`` (it does not 404). See that endpoint.

## Path parameters

- `agent_id` string, required

## Query parameters

- `force` boolean: Force destroy even if running

## Response `200`

Successful Response

- AgentDestroyResponse: Destroy response.
  - `agent_id` string, required
  - `status` string, required
  - `message` string, required
  - `destroyed_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jackhamr/apis/jackhamr-api.md) · [All operations](https://skmtc.dev/jackhamr/apis/jackhamr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jackhamr/apis/jackhamr-api/revisions/f75d221481d8?raw)