# API How-Tos

The IONOS Cloud Container Registry service allows you to manage Docker and OCI compatible registries for use by your managed Kubernetes clusters. Use a container registry to make sure you have a private registry to effectively support pulling images.

## Quick Links

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>GET Locations</strong></mark></td><td>Learn how to retrieve a container registry location.</td><td><a href="api-howtos/locations">locations</a></td></tr><tr><td><mark style="color:blue;"><strong>GET Registries</strong></mark></td><td>Learn how to retrieve existing registries.</td><td><a href="api-howtos/registries">registries</a></td></tr><tr><td><mark style="color:blue;"><strong>GET Registry by ID</strong></mark></td><td>Learn how to fetch registry information by ID.</td><td><a href="api-howtos/registry_id">registry_id</a></td></tr><tr><td><mark style="color:blue;"><strong>Create Container Registry</strong></mark></td><td>Learn how to create a new registry.</td><td><a href="api-howtos/create_registry">create_registry</a></td></tr><tr><td><mark style="color:blue;"><strong>Create Registry Token</strong></mark></td><td>Learn how to create a registry token.</td><td><a href="api-howtos/create_token">create_token</a></td></tr><tr><td><mark style="color:blue;"><strong>Delete Repository</strong></mark></td><td>Learn how to delete a repository.</td><td><a href="api-howtos/delete_repo">delete_repo</a></td></tr><tr><td><mark style="color:blue;"><strong>Delete Token</strong></mark></td><td>Learn how to delete a registry token.</td><td><a href="api-howtos/delete_token">delete_token</a></td></tr><tr><td><mark style="color:blue;"><strong>Delete Registry</strong></mark></td><td>Learn how to delete your container registry.</td><td><a href="api-howtos/delete_registry">delete_registry</a></td></tr></tbody></table>

## ContainerRegistry API - OpenAPI Specification

{% embed url="<https://api.ionos.com/docs/containerregistry/v1/>" %}
Click here for the OpenAPI Specification File
{% endembed %}

**Endpoint:** `https://api.ionos.com/containerregistries`

To make authenticated requests to the API, you must include a few fields in the request headers. Please find relevant descriptions below:

## Request parameter headers

| **Header**            | **Required** | **Type** | **Description**                                                                              |
| --------------------- | :----------: | :------: | -------------------------------------------------------------------------------------------- |
| **Authorization**     |      yes     |  string  | The `Bearer token`.                                                                          |
| **X-Contract-Number** |      no      |  integer | Users with more than one contract may apply this header to indicate the applicable contract. |
| **Content-Type**      |      yes     |  string  | Set this to `application/json`.                                                              |

## Examples

We use `curl` in our examples, as this tool is available on Windows 10, Linux, and macOS. If you encounter any problems, refer to our blog post about `curl` on Windows:

{% embed url="<https://www.ionos.com/digitalguide/server/tools/introduction-to-curl-in-linux>" %}

{% embed url="<https://www.ionos.com/digitalguide/server/tools/introduction-to-curl-in-windows>" %}