Deployments Commands

Manage deployments from the terminal. List all deployments for a site, publish a specific deployment by ID, roll back to a previous version, or permanently delete a deployment.

zyber deployments list <siteSlug>

List all deployments for a site in reverse chronological order. Displays a table with columns: ID, STATUS (active ✓ or draft), FILES, SIZE, CREATED. Requires deployments:read scope.

zyber deployments publish <siteSlug> <deploymentId>

Publish a specific deployment by ID, making it the live version. Useful for publishing a draft created earlier or promoting a specific deployment without re-uploading. Requires deployments:write scope.

zyber deployments rollback <siteSlug> <deploymentId>

Roll back to a previous deployment by ID. Identical to publish — the specified deployment becomes live immediately. Requires deployments:write scope.

zyber deployments delete <siteSlug> <deploymentId>

Permanently delete a deployment and its files. Prompts for confirmation unless --force is passed. Cannot delete the active deployment — publish another first. Requires deployments:write scope.

Example response

 Deployments for "my-site" (3 total)
ID STATUS FILES SIZE CREATED
v-abc123def456 active ✓ 42 1.2 MB Mar 25, 2026
v-xyz789ghi012 draft 38 1.1 MB Mar 24, 2026
v-old345jkl678 draft 35 980 KB Mar 20, 2026

Code examples

cURL

# List deployments
zyber deployments list my-site

# Publish a specific deployment
zyber deployments publish my-site v-abc123def456

# Roll back to a previous deployment
zyber deployments rollback my-site v-xyz789ghi012

# Delete a deployment (with confirmation)
zyber deployments delete my-site v-old345jkl678

# Delete without confirmation
zyber deployments delete my-site v-old345jkl678 --force

JavaScript

// Equivalent API calls:

// List deployments
const deps = await fetch(`https://www.zyberspace.com/api/v1/{teamSlug}/sites/my-site/deployments`, {
headers: { Authorization: "Bearer zxk_live_YOUR_API_KEY" },
}).then(r => r.json());

// Publish a deployment
await fetch(`https://www.zyberspace.com/api/v1/{teamSlug}/sites/my-site/deployments/v-abc123/publish`, {
method: "POST",
headers: { Authorization: "Bearer zxk_live_YOUR_API_KEY" },
});

// Rollback
await fetch(`https://www.zyberspace.com/api/v1/{teamSlug}/sites/my-site/deployments/v-xyz789/rollback`, {
method: "POST",
headers: { Authorization: "Bearer zxk_live_YOUR_API_KEY" },
});

// Delete
await fetch(`https://www.zyberspace.com/api/v1/{teamSlug}/sites/my-site/deployments/v-old345`, {
method: "DELETE",
headers: { Authorization: "Bearer zxk_live_YOUR_API_KEY" },
});

Base URL: https://www.zyberspace.com

Get your API key →