Back to Docs

API Keys

Authenticate with the ImageSentinel API using API keys.

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

terminal
curl -X GET "https://api.imagesentinel.io/v1/images" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Endpoints

GET/v1/images

List all hardened images available in your account.

Response
{
  "images": [
    {
      "name": "python",
      "tag": "3.12-hardened",
      "digest": "sha256:abc123...",
      "created": "2024-01-15T10:30:00Z",
      "vulnerabilities": { "critical": 0, "high": 0 }
    }
  ]
}
POST/v1/scan

Scan an image for vulnerabilities.

Request/Response
# Request
{
  "image": "myapp:latest",
  "registry": "docker.io"
}

# Response
{
  "scan_id": "scan_123abc",
  "status": "completed",
  "vulnerabilities": {
    "critical": 0,
    "high": 0,
    "medium": 3,
    "low": 12
  }
}