---
title: "Delete an Agent"
method: DELETE
path: "/v1/agents/{agentId}"
tags: ["Agents"]
---

# Delete an Agent

`DELETE /v1/agents/{agentId}`

This request can only be used to delete agents that have a STOPPED, PENDING or UNKNOWN status. In the case of an agent at UNKNOWN status, there is a delay of up to one hour after its preceding status before the agent can be deleted successfully.

## Path parameters

- `agentId` string, required

## Response `202`

Agent successfully deleted

## Other responses

- `400` — Wrong request parameters used
- `403` — Forbidden
- `404` — Agent not found
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/revisions/6239825f68eb/schema)