---
title: "DELETE /registries/{registryId}"
method: DELETE
path: "/registries/{registryId}"
---

# DELETE /registries/{registryId}

`DELETE /registries/{registryId}`

Deletes a registry. The registry must contain zero records before it can be deleted. This operation initiates the deletion process asynchronously.

## Path parameters

- `registryId` string, required

## Response `202`

Success

- DeleteRegistryResponse
  - `status` 'CREATING' | 'READY' | 'UPDATING' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETING' | 'DELETE_FAILED', required — The current status of the registry, set to <code>DELETING</code> when deletion is initiated. For a list of all possible registry statuses, see the <code>RegistryStatus</code> data type.

## Other responses

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

---

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