Artifacts

Artifacts are the individual files stored in a repository

This tag groups all operations for artifacts.

Retrieve all Artifacts by Registry

get

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

Authorizations

tokenAuth

AuthorizationstringRequired

Please provide header value as 'Bearer' and don't forget to add 'Bearer' HTTP Authorization Scheme before the token

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 this parameter together with the limit for pagination.

Default: 0Example: 0

limitinteger · int32 · min: 1 · max: 1000Optional

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

Default: 100Example: 100

filter.vulnerabilityIdstringOptional

Filter resources by vulnerabilityId.

orderBystring · enumOptional

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

Default: -pullCountPossible values:

Responses

200

Returned all requested Artifacts successfully.

application/json

idstring · enumRequiredPossible values:

typestring · enumRequiredPossible values:

hrefstringRequiredExample: https://api.ionos.com/containerregistries/registries/artifacts

offsetintegerRead-onlyRequired

The offset specified in the request (if none was specified, the default offset is 0).

Example: 0

limitintegerRead-onlyRequired

The limit specified in the request (if none was specified, use the endpoint's default pagination limit).

Example: 42

400

Bad Request

The request send to the API was malformed.

application/json

401

Unauthorized

The request is missing authorization information or the authorization information provided are expired.

application/json

403

Not Allowed

The user issuing the request does not have the needed permissions.

application/json

429

Too Many Requests

The user has sent too many requests in a given amount of time.

application/json

500

Internal Server Error

An internal error occurred. We apologize for the inconvenience!

application/json

503

Service Unavailable

The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.

application/json

default

Unexpected Internal Server Error

An unexpected internal error occurred. We apologize for the inconvenience!

application/json

get

/registries/{registryId}/artifacts

HTTPcURLJavaScriptPython

GET /containerregistries/registries/{registryId}/artifacts HTTP/1.1
Host: api.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "artifacts",
  "type": "collection",
  "href": "https://api.ionos.com/containerregistries/registries/artifacts",
  "items": [
    {
      "id": "sha256:12345678901234567890123456789012",
      "type": "artifact",
      "href": "https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service/artifacts/sha256:12345678901234567890123456789012",
      "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>",
        "lastPushedAt": "2026-04-03T17:31:28.793Z",
        "lastPulledAt": "2026-04-03T17:31:28.793Z",
        "lastScannedAt": "2026-04-03T17:31:28.793Z",
        "pushCount": 1,
        "pullCount": 42,
        "vulnMaxSeverity": "high",
        "vulnTotalScore": 9.8,
        "vulnTotalCount": 20,
        "vulnFixableCount": 10
      },
      "properties": {
        "repositoryName": "my-service",
        "digest": "sha256:12345678901234567890123456789012",
        "tags": [
          "latest",
          "1.0.0"
        ],
        "mediaType": "application/vnd.oci.image.manifest.v1+json"
      }
    }
  ],
  "offset": 0,
  "limit": 42,
  "_links": {
    "prev": "http://PREVIOUS-PAGE-URI",
    "self": "http://THIS-PAGE-URI",
    "next": "http://NEXT-PAGE-URI"
  }
}

Retrieve all Artifacts by Repository

get

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

Authorizations

tokenAuth

AuthorizationstringRequired

Please provide header value as 'Bearer' and don't forget to add 'Bearer' HTTP Authorization Scheme before the token

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

Query parameters

offsetinteger · int32Optional

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

Default: 0Example: 0

limitinteger · int32 · min: 1 · max: 1000Optional

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

Default: 100Example: 100

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 Artifacts successfully.

application/json

idstring · enumRequiredPossible values:

typestring · enumRequiredPossible values:

hrefstringRequiredExample: https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service/artifacts

offsetintegerRead-onlyRequired

The offset specified in the request (if none was specified, the default offset is 0).

Example: 0

limitintegerRead-onlyRequired

The limit specified in the request (if none was specified, use the endpoint's default pagination limit).

Example: 42

400

Bad Request

The request send to the API was malformed.

application/json

401

Unauthorized

The request is missing authorization information or the authorization information provided are expired.

application/json

403

Not Allowed

The user issuing the request does not have the needed permissions.

application/json

429

Too Many Requests

The user has sent too many requests in a given amount of time.

application/json

500

Internal Server Error

An internal error occurred. We apologize for the inconvenience!

application/json

503

Service Unavailable

The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.

application/json

default

Unexpected Internal Server Error

An unexpected internal error occurred. We apologize for the inconvenience!

application/json

get

/registries/{registryId}/repositories/{repositoryName}/artifacts

HTTPcURLJavaScriptPython

GET /containerregistries/registries/{registryId}/repositories/{repositoryName}/artifacts HTTP/1.1
Host: api.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "artifacts",
  "type": "collection",
  "href": "https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service/artifacts",
  "items": [
    {
      "id": "sha256:12345678901234567890123456789012",
      "type": "artifact",
      "href": "https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service/artifacts/sha256:12345678901234567890123456789012",
      "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>",
        "lastPushedAt": "2026-04-03T17:31:28.793Z",
        "lastPulledAt": "2026-04-03T17:31:28.793Z",
        "lastScannedAt": "2026-04-03T17:31:28.793Z",
        "pushCount": 1,
        "pullCount": 42,
        "vulnMaxSeverity": "high",
        "vulnTotalScore": 9.8,
        "vulnTotalCount": 20,
        "vulnFixableCount": 10
      },
      "properties": {
        "repositoryName": "my-service",
        "digest": "sha256:12345678901234567890123456789012",
        "tags": [
          "latest",
          "1.0.0"
        ],
        "mediaType": "application/vnd.oci.image.manifest.v1+json"
      }
    }
  ],
  "offset": 0,
  "limit": 42,
  "_links": {
    "prev": "http://PREVIOUS-PAGE-URI",
    "self": "http://THIS-PAGE-URI",
    "next": "http://NEXT-PAGE-URI"
  }
}

Retrieve Artifact

get

Returns the Artifact by Digest.

Authorizations

tokenAuth

AuthorizationstringRequired

Please provide header value as 'Bearer' and don't forget to add 'Bearer' HTTP Authorization Scheme before the token

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

digeststring · max: 128Required

The Digest of the Artifact.

Example: sha256:12345678901234567890123456789012

Responses

200

Getting Artifact was successful.

application/json

idstringRequired

The digest of the artifact

Example: sha256:12345678901234567890123456789012

typestring · enumRequiredPossible values:

hrefstringRequiredExample: https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service/artifacts/sha256:12345678901234567890123456789012

400

Bad Request

The request send to the API was malformed.

application/json

401

Unauthorized

The request is missing authorization information or the authorization information provided are expired.

application/json

403

Not Allowed

The user issuing the request does not have the needed permissions.

application/json

404

Not Found

The resource that was requested could not be found.

application/json

429

Too Many Requests

The user has sent too many requests in a given amount of time.

application/json

500

Internal Server Error

An internal error occurred. We apologize for the inconvenience!

application/json

503

Service Unavailable

The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.

application/json

default

Unexpected Internal Server Error

An unexpected internal error occurred. We apologize for the inconvenience!

application/json

get

/registries/{registryId}/repositories/{repositoryName}/artifacts/{digest}

HTTPcURLJavaScriptPython

GET /containerregistries/registries/{registryId}/repositories/{repositoryName}/artifacts/{digest} HTTP/1.1
Host: api.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "sha256:12345678901234567890123456789012",
  "type": "artifact",
  "href": "https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service/artifacts/sha256:12345678901234567890123456789012",
  "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>",
    "lastPushedAt": "2026-04-03T17:31:28.793Z",
    "lastPulledAt": "2026-04-03T17:31:28.793Z",
    "lastScannedAt": "2026-04-03T17:31:28.793Z",
    "pushCount": 1,
    "pullCount": 42,
    "vulnMaxSeverity": "high",
    "vulnTotalScore": 9.8,
    "vulnTotalCount": 20,
    "vulnFixableCount": 10
  },
  "properties": {
    "repositoryName": "my-service",
    "digest": "sha256:12345678901234567890123456789012",
    "tags": [
      "latest",
      "1.0.0"
    ],
    "mediaType": "application/vnd.oci.image.manifest.v1+json"
  }
}

Retrieve all Vulnerabilities

get

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

Authorizations

tokenAuth

AuthorizationstringRequired

Please provide header value as 'Bearer' and don't forget to add 'Bearer' HTTP Authorization Scheme before the token

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

digeststring · max: 128Required

The Digest of the Artifact.

Example: sha256:12345678901234567890123456789012

Query parameters

offsetinteger · int32Optional

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

Default: 0Example: 0

limitinteger · int32 · min: 1 · max: 1000Optional

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

Default: 100Example: 100

filter.severitystringOptional

The CVSS vulnerability severity rating

Example: high

filter.fixablebooleanOptional

Filter resources by fixable (i.e. remediation action is available)

orderBystring · enumOptional

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

Default: -scorePossible values:

Responses

200

Returned all requested Vulnerabilities successfully.

application/json

idstring · enumRequiredPossible values:

typestring · enumRequiredPossible values:

hrefstringRequiredExample: https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service/artifacts/sha256:12345678901234567890123456789012/vulnerabilities

offsetintegerRead-onlyRequired

The offset specified in the request (if none was specified, the default offset is 0).

Example: 0

limitintegerRead-onlyRequired

The limit specified in the request (if none was specified, use the endpoint's default pagination limit).

Example: 42

400

Bad Request

The request send to the API was malformed.

application/json

401

Unauthorized

The request is missing authorization information or the authorization information provided are expired.

application/json

403

Not Allowed

The user issuing the request does not have the needed permissions.

application/json

429

Too Many Requests

The user has sent too many requests in a given amount of time.

application/json

500

Internal Server Error

An internal error occurred. We apologize for the inconvenience!

application/json

503

Service Unavailable

The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.

application/json

default

Unexpected Internal Server Error

An unexpected internal error occurred. We apologize for the inconvenience!

application/json

get

/registries/{registryId}/repositories/{repositoryName}/artifacts/{digest}/vulnerabilities

HTTPcURLJavaScriptPython

GET /containerregistries/registries/{registryId}/repositories/{repositoryName}/artifacts/{digest}/vulnerabilities HTTP/1.1
Host: api.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "vulnerabilities",
  "type": "collection",
  "href": "https://api.ionos.com/containerregistries/registries/f39c94e6-e84b-4d25-b54f-75e4289be43c/repositories/my-service/artifacts/sha256:12345678901234567890123456789012/vulnerabilities",
  "items": [
    {
      "id": "CVE-2019-1234",
      "type": "vulnerability",
      "href": "https://api.ionos.com/containerregistries/vulnerabilities/CVE-2019-1234",
      "metadata": {
        "publishedAt": "2019-01-01T00:00:00+00:00",
        "updatedAt": "2019-01-01T00:00:00+00:00"
      },
      "properties": {
        "description": "A vulnerability in the web UI of Cisco IOS XE Software could allow an authenticated, remote attacker to execute commands on the underlying Linux shell of an affected device with root privileges.",
        "recommendations": "Cisco has released software updates that address this vulnerability. There are no workarounds that address this vulnerability.",
        "dataSource": {
          "id": "osv",
          "url": "https://github.com/pypa/advisory-db"
        },
        "fixable": true,
        "affects": [
          {
            "type": "maven",
            "name": "org.apache.commons:commons-lang3",
            "version": "3.8.1"
          }
        ],
        "references": [
          "https://access.redhat.com/security/cve/CVE-2019-1234"
        ],
        "severity": "high",
        "score": 9.8
      }
    }
  ],
  "offset": 0,
  "limit": 42,
  "_links": {
    "prev": "http://PREVIOUS-PAGE-URI",
    "self": "http://THIS-PAGE-URI",
    "next": "http://NEXT-PAGE-URI"
  }
}