AI Model Hub for free till June 30, 2025.
Try now
Test nowLog inShare Feedback

Repositories

Repositories contain container images and other artifacts

This tag groups all operations for repositories.

Retrieve all Repositories

get

This endpoint enables retrieving all Repositories using pagination and optional filters.

Authorizations
Path parameters
registryIdstring · uuidRequired

The ID (UUID) of the Registry.

Example: 1e41a73c-59d0-5507-86dd-fa2fc2501cfd
Query parameters
offsetinteger · int32Optional

The first element (of the total list of elements) to include in the response. Use together with limit for pagination.

Default: 0Example: 0
limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of elements to return. Use together with offset for pagination.

Default: 100Example: 100
filter.namestringOptional

Filter resources by name.

filter.vulnerabilitySeveritystringOptional

The CVSS vulnerability severity rating

Example: high
orderBystring · enumOptional

The field to order the results by. If not provided, the results will be ordered by the default field.

Default: -lastPushPossible values:
Responses
200
Returned all requested Repositories successfully.
application/json
get
GET /containerregistries/registries/{registryId}/repositories HTTP/1.1
Host: api.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "repositories",
  "type": "collection",
  "href": "https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories",
  "items": [
    {
      "id": "my-service",
      "type": "repository",
      "href": "https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service",
      "metadata": {
        "createdDate": "2020-12-10T13:37:50+01:00",
        "createdBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "createdByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "lastModifiedDate": "2020-12-11T13:37:50+01:00",
        "lastModifiedBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "lastModifiedByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "resourceURN": "ionos:<product>:<location>:<contract>:<resource-path>",
        "artifactCount": 125,
        "pullCount": 4200,
        "pushCount": 200,
        "lastPulledAt": "2025-07-17T03:52:56.361Z",
        "lastPushedAt": "2025-07-17T03:52:56.361Z",
        "lastSeverity": "high"
      },
      "properties": {
        "name": "my-service"
      }
    }
  ],
  "offset": 0,
  "limit": 42,
  "_links": {
    "prev": "http://PREVIOUS-PAGE-URI",
    "self": "http://THIS-PAGE-URI",
    "next": "http://NEXT-PAGE-URI"
  }
}

Retrieve Repository

get

Returns the Repository by Name.

Authorizations
Path parameters
registryIdstring · uuidRequired

The ID (UUID) of the Registry.

Example: 1e41a73c-59d0-5507-86dd-fa2fc2501cfd
repositoryNamestring · max: 256Required

The Name of the Repository.

Example: my-service
Responses
200
Getting Repository was successful.
application/json
get
GET /containerregistries/registries/{registryId}/repositories/{repositoryName} HTTP/1.1
Host: api.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "my-service",
  "type": "repository",
  "href": "https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service",
  "metadata": {
    "createdDate": "2020-12-10T13:37:50+01:00",
    "createdBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
    "createdByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
    "lastModifiedDate": "2020-12-11T13:37:50+01:00",
    "lastModifiedBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
    "lastModifiedByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
    "resourceURN": "ionos:<product>:<location>:<contract>:<resource-path>",
    "artifactCount": 125,
    "pullCount": 4200,
    "pushCount": 200,
    "lastPulledAt": "2025-07-17T03:52:56.361Z",
    "lastPushedAt": "2025-07-17T03:52:56.361Z",
    "lastSeverity": "high"
  },
  "properties": {
    "name": "my-service"
  }
}

Delete repository

delete

Delete all repository contents

	The registry V2 API allows manifests and blobs to be deleted individually but it is not possible to remove an entire repository.
	This operation is provided for convenience
Authorizations
Path parameters
registryIdstring · uuidRequired

The unique ID of the registry

Pattern: ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
repositoryNamestringRequired

The name of the repository

Example: my-servicePattern: ^[a-z0-9]+(?:[._-][a-z0-9]+)*$
Responses
204
No Content
delete
DELETE /containerregistries/registries/{registryId}/repositories/{repositoryName} HTTP/1.1
Host: api.ionos.com
Authorization: Basic username:password
Accept: */*
204

No Content

No content
PreviousTokensNextArtifacts

Was this helpful?