---
title: "Delete an agent"
method: DELETE
path: "/api/v1/agents/{agent}"
---

# Delete an agent

`DELETE /api/v1/agents/{agent}`

Permanently deletes an agent and all of its associated resources. This action cannot
be undone.

The authenticated caller must own the agent or hold sufficient permissions within its
owning org or team. When called under a developer app scope, the caller must hold the
app scope for the target app.

## Path parameters

- `agent` string, required

## Response `204`

No content

## Other responses

- `401` — Unauthorized
- `403` — App-scoped token required. Use a token scoped to the target app.; Permission denied. The connected account may not have the required permissions. Try reconnecting your account.
- `404` — Agent not found

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)