---
title: "DELETE /agents/{agentId}/"
method: DELETE
path: "/agents/{agentId}/"
---

# DELETE /agents/{agentId}/

`DELETE /agents/{agentId}/`

Deletes an agent.

## Path parameters

- `agentId` string, required

## Query parameters

- `skipResourceInUseCheck` boolean

## Response `202`

Success

- DeleteAgentResponse
  - `agentId` string, required — The unique identifier of the agent that was deleted.
  - `agentStatus` 'CREATING' | 'PREPARING' | 'PREPARED' | 'NOT_PREPARED' | 'DELETING' | 'FAILED' | 'VERSIONING' | 'UPDATING', required — The status of the agent.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — InternalServerException
- `484` — ResourceNotFoundException
- `485` — ConflictException

---

[API](https://skmtc.net/aws/apis/bedrock-agent.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agent/versions/a3b2356f17da/schema)