---
title: "Delete agent"
method: DELETE
path: "/v2/agents/{agent_key}"
tags: ["Agents"]
---

# Delete agent

`DELETE /v2/agents/{agent_key}`

Permanently removes an agent from the workspace. This operation is irreversible and will delete all associated configuration including model assignments, tools, knowledge bases, memory stores, and cached data. Active agent sessions will be terminated, and the agent key will become available for reuse.

## Path parameters

- `agent_key` string, required — The unique key of the agent to delete

## Response `204`

Agent successfully deleted. No content is returned, but the agent has been permanently removed from the workspace.

## Other responses

- `404` — Agent not found. The specified agent key does not exist in the workspace or has already been deleted.

---

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