Deploy external image

Deploy an external container image to a project environment

POST

/auth/v1/seed/{namespace}/projects/{id_or_slug}/deploy-image

curl --request POST \
  --url /auth/v1/seed/{namespace}/projects/{id_or_slug}/deploy-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"image_ref":"ghcr.io/acme/inference-engine:v2.1","registry_id":"reg_3c4d5e6f","environment":"production"}'

Path parameters

namespace

string

required

The namespace (user or organization) the project belongs to.

id_or_slug

string

required

The project ID or slug.

Body parameters

image_ref

string

required

Container image reference to deploy (e.g., `ghcr.io/acme/api:v2.1`).

registry_id

string

Registry credential ID for pulling private images.

environment

string

Target environment name (e.g., `production`, `staging`).

Previous → Deploy from git

Next List deployments →