> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/containers/private-container-registry/api-howtos/delete_repo.md).

# Delete Repository

Once you have created a repository using the [<mark style="color:blue;">**Docker URIs**</mark>](https://distribution.github.io/distribution/spec/api/#overview) and completed your operations, you may want to delete it. As the [<mark style="color:blue;">**Docker Registry V2 API**</mark>](https://docs.docker.com/reference/api/registry/latest/) does not support deleting entire repositories, you must use the <code class="expression">space.vars.ionos\_cloud</code> **Container Registry API**. To perform this operation, you need:

* The `repository_name` you wish to delete. For more information about retrieving a list of repositories, see [<mark style="color:blue;">Retrieve all Repositories</mark>](https://api.ionos.com/docs/containerregistry/v1/#tag/Repositories/operation/registriesRepositoriesGet).
* The `registryId`, which can be obtained through the [<mark style="color:blue;">GET Registries</mark>](/cloud/containers/private-container-registry/api-howtos/registries.md) API call.

## Request

Run the following `curl` command to delete the repository:

{% hint style="info" %}
**Note:**

* In the following code, the sample `registryId` is `8fb592e4-494c-11ed-b878-0242ac120002` and `repository_name` is `dev/tests`.
* The repository name in the API URL must be URL-encoded. For example, `dev/tests` should be written as `dev%2Ftests` to prevent the slash from being interpreted as a path separator and causing a 404 error.
  {% endhint %}

```bash
curl --location \
--header 'Authorization: Bearer ${TOKEN}' \
--request DELETE 'https://api.ionos.com/containerregistries/registries/8fb592e4-494c-11ed-b878-0242ac120002/repositories/dev%2Ftests'
```

### Path parameters

| **Field**         | **Type** | **Description**                                                | **Example**                            |
| ----------------- | -------- | -------------------------------------------------------------- | -------------------------------------- |
| `registryId`      | string   | The ID of the registry to be returned. This is required.       | `8fb592e4-494c-11ed-b878-0242ac120002` |
| `repository_name` | string   | The name of the registry. It must be unique within the folder. | `dev%2Ftests`                          |

## Response

Upon success, the server returns **204 - No Content** to indicate the request was fulfilled without a response body.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ionos.com/cloud/containers/private-container-registry/api-howtos/delete_repo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.