Update Deploy Image

Updates the Docker image of the project to initiate a new deploy.

PATCH /project/:id/image

Path Parameters

Parameter	Type	Description
`id`	string	Project ID (ObjectId)

Headers

Header	Required	Description
`x-api-key`	Yes	Project API Key
`x-organization-id`	Yes	Active project organization
`Content-Type: application/json`	Yes	Required because the request has a JSON body

Body

Field	Type	Required	Description
`image`	string	Yes	Docker image name with registry and tag (e.g., `docker.io/nginx:perl`, `myregistry.com/myapp:v1.0`). Important: Always use a specific, immutable tag (like `v1.0.0`) instead of `latest` to avoid pulling different images unexpectedly.

Example

{
  "image": "docker.io/nginx:perl"
}

Response

{
  "status": "success",
  "message": "updated with success"
}

Examples

curl

curl -X PATCH "https://api.zenifra.com/v1/project/507f1f77bcf86cd799439011/image" \
  -H "x-api-key: your-api-key" \
  -H "x-organization-id: your-organization-id" \
  -H "Content-Type: application/json" \
  -d '{"image": "docker.io/nginx:perl"}'

Python

import requests

API_KEY = "your-api-key"
ORGANIZATION_ID = "your-organization-id"
PROJECT_ID = "507f1f77bcf86cd799439011"

response = requests.patch(
    f"https://api.zenifra.com/v1/project/{PROJECT_ID}/image",
    headers={"x-api-key": API_KEY, "x-organization-id": ORGANIZATION_ID},
    json={"image": "docker.io/nginx:perl"}
)
print(response.json())

Node.js

const axios = require('axios');

const API_KEY = 'your-api-key';
const ORGANIZATION_ID = 'your-organization-id';
const PROJECT_ID = '507f1f77bcf86cd799439011';

axios.patch(
  `https://api.zenifra.com/v1/project/${PROJECT_ID}/image`,
  { image: 'docker.io/nginx:perl' },
  { headers: { 'x-api-key': API_KEY, 'x-organization-id': ORGANIZATION_ID } }
).then(res => console.log(res.data));

On this page