Integrations - Providers - Registry

Container registry connections for image scanning.

📄️ Get Registry Images

Lists the authenticated client's container registry image specifications using cursor-based pagination. Supports sorting, field selection, and filters on provider or platform via filters[...] query parameters.

📄️ Create Registry Image Scan

Creates a container registry image scan specification for the authenticated client and returns its generated app_id. For Docker Hub and JFrog Artifactory platforms, the supplied registry credentials are stored in the client's registry plugin configuration.

📄️ Get Container Spec

Retrieves a single container spec (cloud or registry image) by ID from the authenticated client's configuration. The attributes field is null when the spec does not exist.

📄️ Delete Container Spec

Deletes a container spec (cloud or registry image) from the authenticated client's configuration; returns 404 if the spec does not exist. When the last spec for a registry platform is removed, its stored registry credentials are also cleaned up.

📄️ Update Container Spec

Replaces the configuration of an existing container spec (cloud or registry image) belonging to the authenticated client. Returns 404 if the spec does not exist.

📄️ List Registry Connections

Return all container registry connections configured for the authenticated client, including platform, status, last discovery time, image count, and linked repositories.

📄️ Create Registry Connection

Create a new registry connection for the given platform. The provided credentials are validated with a live connection test before persisting; invalid credentials return 400. Responds 201 with the new connection on success.

📄️ Get Registry Connection

Return a single registry connection by its ID, including platform, status, last discovery time, image count, and linked repositories. Responds 404 when the connection does not exist for the client.

📄️ Update Registry Connection

Update the credentials and/or linked repositories of an existing registry connection. New credentials are verified with a live connection test and rejected with 400 when invalid. Responds 404 when the connection does not exist.

📄️ Delete Registry Connection

Delete a registry connection and all container images discovered through it. Responds 204 on success and 404 when the connection does not exist for the client.

📄️ Trigger Registry Discovery

Start an asynchronous image discovery job for the registry connection and respond 202 with the workflow ID. Responds 404 when the connection does not exist and 429 when the per-client limit of concurrent discovery jobs is reached.

📄️ Trigger Registry Scan

Start an asynchronous vulnerability scan of the images discovered for the registry connection and respond 202 with the workflow ID. Responds 404 when the connection does not exist and 429 when the per-client concurrent scan limit is reached.

📄️ List Registry Images by Connection

List the container images discovered for a registry connection. Results can be narrowed with the optional lifecycle and scan_status query parameters.

📄️ Link Registry Image

Manually link a discovered registry image to a Dockerfile in an SCM repository. The body must provide scm_repo_id and dockerfile_path; the link is stored with full confidence (1.0).