API ReferenceIntegrations

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 and authorization invitations require API-key-derived tokens.

Request

This endpoint expects an object.
environmentIddoubleRequired
imageSourceTypeenumRequired
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
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