Skip to navigation

Validate custom Docker image

Requires an active environment. Dockerfile sources are unsupported for Cloudflare. Provider image validation may reject incompatible images.

Requires every scope: deployments:write, environments:read.

Authentication

AuthorizationBearer

JWT returned by POST /api/auth/token-exchange. Amazon, authorization invitations, and developer credentials require API-key-derived tokens.

Request

This endpoint expects an object.
environmentIddoubleRequired
imageSourceTypeenumRequired
Allowed values:
containerImagestringRequired>=1 character

Valid Docker repository, such as nginx, org/repo, or registry.example.com:5000/org/repo.

containerTagstringOptionalformat: "^[\w][\w.-]{0,127}$">=1 characterDefaults to latest

Response

Success
successboolean
providerenum
Allowed values:
platformstring
digeststring

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error
503
Service Unavailable Error