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:
​GET Locations​
​GET Registries​
​GET Registry by ID​
​Create Container Registry​
​Create Registry Token​
​Delete Registry​
ContainerRegistry API - OpenAPI Specification
Container Registry service
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
HTTP Basic authorization. A base64 encoded string of a username and password separated by a colon. [email protected]:password
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. Please refer to our blogpost about curl on Windows if you encounter any problems:
cURL in Linux: what you need to know to get started
IONOS Digitalguide
Getting started with cURL in Windows
IONOS Digitalguide

Header	Required	Type	Description
Authorization	yes	string	HTTP Basic authorization. A base64 encoded string of a username and password separated by a colon. `[email protected]:password`
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`.

Update Container Registry Settings

GET Locations

Last modified 7mo ago

GET Locations	GET Registries	GET Registry by ID
Create Container Registry	Create Registry Token	Delete Registry