Skip to main content
POST
/
project
/
{projectId}
/
integrations
/
dockerhub
/
container-registry
/
scan
Start DockerHub container scan
curl --request POST \
  --url https://us.cybedefend.com/project/{projectId}/integrations/dockerhub/container-registry/scan \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "credentialId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "imageName": "my-app:v1.0.0",
  "privateScan": false,
  "severities": [
    "CRITICAL",
    "HIGH"
  ]
}
'
{
  "success": true,
  "message": "<string>",
  "scanId": "<string>",
  "detectedLanguages": [
    "<string>"
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
projectId
string<uuid>
required

CybeDefend project ID

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

Container scan configuration

​
credentialId
string
required

Credential ID to use for authentication

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
imageName
string
required

Image name with tag to scan (e.g., my-app:v1.0.0)

Example:

"my-app:v1.0.0"

​
privateScan
boolean
default:false

Whether the scan results should be private

​
severities
string[]

Vulnerability severities to include

Example:
["CRITICAL", "HIGH"]

Response

Scan started successfully

​
success
boolean
required

Whether the scan started successfully

​
message
string
required

Message describing the scan start result

​
scanId
string

The unique identifier of the created scan

​
detectedLanguages
string[]

Detected languages (if any) during scan initialization