API How-Tos

The IONOS CLOUD Private Container Registry service allows you to manage Docker and OCI compatible registries for use by your managed Kubernetes clusters. Configure a Private Container Registry to ensure secure and reliable image pulling.

Quick Links

GET Locations

Learn how to retrieve a container Private Container Registry location.

GET Registries

Learn how to retrieve existing registries.

GET Registry by ID

Learn how to fetch Private Container Registry information by ID.

Create Private Container Registry

Learn how to create a new Private Container Registry.

Create Registry Token

Learn how to create a Private Container Registry token.

Delete Repository

Learn how to delete a repository.

Delete Token

Learn how to delete a Private Container Registry token.

Delete Private Container Registry

Learn how to delete your Private Container Registry.

ContainerRegistry API - OpenAPI Specification

Container Registry serviceapi.ionos.com

Click here for the OpenAPI Specification File

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:

Linux cURL - How to use the Curl Command in Linuxionos Digital Guide

Getting started with cURL in Windowsionos Digital Guide