Deployments
See and delete the builds of your tasks.
deployment:list
List your live deployments with the size of each image.
- needs API key
- --json: full
$ ignitify deployment:list [--limit N] [--after-id <id>] [--after <iso>]$ ignitify deployment:listid 019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2resource_id dep_Hn4TqXw8Zc2Ptenant_id 019f2b10-3c55-7a01-b2e4-9d0c61f7a8b3task_id 019f3c1e-7a42-7d10-9b3e-5c8e2a41f0d7task_slug image-resizecontent_hash 9891a4918eaea18984ccb0d30a724cf2e5cd1705a54cf168954e0741c981f1e4runtime node22status READYsecrets -failure_reason -notify_url -created_at 2026-10-14T09:12:03.540Zupdated_at 2026-10-14T09:12:04.118Zdeleted_at -size 8.0 MiBTenant total: 8.0 MiB of 1.0 GiB
$ ignitify deployment:list --json{
"deployments": [
{
"id": "019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2",
"resource_id": "dep_Hn4TqXw8Zc2P",
"tenant_id": "019f2b10-3c55-7a01-b2e4-9d0c61f7a8b3",
"task_id": "019f3c1e-7a42-7d10-9b3e-5c8e2a41f0d7",
"task_slug": "image-resize",
"content_hash": "9891a4918eaea18984ccb0d30a724cf2e5cd1705a54cf168954e0741c981f1e4",
"runtime": "node22",
"status": "READY",
"secrets": null,
"failure_reason": null,
"notify_url": null,
"image_bytes": 8410112,
"image_present": true,
"created_at": "2026-10-14T09:12:03.540Z",
"updated_at": "2026-10-14T09:12:04.118Z",
"deleted_at": null
}
],
"tenant_total_bytes": 8410112,
"tenant_limit_bytes": 1073741824
}| Flag | Value | Default | Description |
|---|---|---|---|
--limit | N | — | Rows on the page. The server sets the default and the largest value. |
--after | <iso> | — | Only rows after this ISO 8601 time. |
--after-id | <id> | — | Page cursor. Pass the id of the last row of the page before. |
deployment:get
Show one deployment: status, size, integrity and build details.
- needs API key
- --json: full
$ ignitify deployment:get <deployment-id>$ ignitify deployment:get dep_Hn4TqXw8Zc2PDeployment Detailsid 019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2resource_id dep_Hn4TqXw8Zc2Ptenant_id 019f2b10-3c55-7a01-b2e4-9d0c61f7a8b3task_id 019f3c1e-7a42-7d10-9b3e-5c8e2a41f0d7task_slug image-resizecontent_hash 9891a4918eaea18984ccb0d30a724cf2e5cd1705a54cf168954e0741c981f1e4runtime node22status READYsecrets -failure_reason -notify_url -created_at 2026-10-14T09:12:03.540Zupdated_at 2026-10-14T09:12:04.118Zdeleted_at -integrity oksize 8.0 MiBBuild log: [build] node up in 120 ms [build] task VM libraries: 525, read in 120 ms [build] smoke boot on the task image [build] smoke boot by ignitify-guest-supervisor 2026.09.26.2 [build] warm-up: image-resize [build] task: [task] INFO: Task image-resize initialised { "slug": "image-resize", "runtime": "node", "contentHash": "sha256:9891a4918eaea18984ccb0d30a724cf2e5cd1705a54cf168954e0741c981f1e4", "bytes": 4986, "tenantBootstrap": false, "smoke": { "durationMs": 1, "exit": 0, "ok": true, "tasks": [ "image-resize" ], "warmups": 1 }, "stages": { "read": 1, "verify": 1, "prep": 1, "fetch": 1, "plan": 1, "build": 1, "package": 1, "bootstrap": 1, "list": 1, "hash": 1, "fingerprint": 1, "smoke": 1, "refingerprint": 1 }, "fileCount": 3 }
$ ignitify deployment:get dep_Hn4TqXw8Zc2P --json{
"id": "019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2",
"resource_id": "dep_Hn4TqXw8Zc2P",
"tenant_id": "019f2b10-3c55-7a01-b2e4-9d0c61f7a8b3",
"task_id": "019f3c1e-7a42-7d10-9b3e-5c8e2a41f0d7",
"task_slug": "image-resize",
"content_hash": "9891a4918eaea18984ccb0d30a724cf2e5cd1705a54cf168954e0741c981f1e4",
"runtime": "node22",
"status": "READY",
"secrets": null,
"failure_reason": null,
"notify_url": null,
"image_bytes": 8410112,
"image_present": true,
"created_at": "2026-10-14T09:12:03.540Z",
"updated_at": "2026-10-14T09:12:04.118Z",
"deleted_at": null,
"integrity": "ok",
"build_log": "[build] node up in 120 ms\n[build] task VM libraries: 525, read in 120 ms\n[build] smoke boot on the task image\n[build] smoke boot by ignitify-guest-supervisor 2026.09.26.2\n[build] warm-up: image-resize\n[build] task: [task] INFO: Task image-resize initialised\n{\n \"slug\": \"image-resize\",\n \"runtime\": \"node\",\n \"contentHash\": \"sha256:9891a4918eaea18984ccb0d30a724cf2e5cd1705a54cf168954e0741c981f1e4\",\n \"bytes\": 4986,\n \"tenantBootstrap\": false,\n \"smoke\": {\n \"durationMs\": 1,\n \"exit\": 0,\n \"ok\": true,\n \"tasks\": [\n \"image-resize\"\n ],\n \"warmups\": 1\n },\n \"stages\": {\n \"read\": 1,\n \"verify\": 1,\n \"prep\": 1,\n \"fetch\": 1,\n \"plan\": 1,\n \"build\": 1,\n \"package\": 1,\n \"bootstrap\": 1,\n \"list\": 1,\n \"hash\": 1,\n \"fingerprint\": 1,\n \"smoke\": 1,\n \"refingerprint\": 1\n },\n \"fileCount\": 3\n}",
"system_packages": null
}| Flag | Value | Default | Description |
|---|---|---|---|
<deployment-id>required | — | — | The deployment id, from task:deploy or deployment:list. |
deployment:delete
Delete a deployment together with its runs.
- needs API key
- asks to confirm
- deletes data
- --json: full
$ ignitify deployment:delete <deployment-id> [--yes]$ ignitify deployment:delete dep_Hn4TqXw8Zc2PWill soft-delete deployment dep_Hn4TqXw8Zc2P and all its runs (cascade).Proceed? [y/N] y✓ deployment deleted: 019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2 (runs: 1, vms: 0, forfeited pins: 0)
$ ignitify deployment:delete dep_Hn4TqXw8Zc2P --yes --json{
"deleted": {
"deployment_id": "019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2",
"runs": 1,
"vms": 0,
"forfeited_pins": 0
}
}$ ignitify deployment:delete dep_Hn4TqXw8Zc2PWill soft-delete deployment dep_Hn4TqXw8Zc2P and all its runs (cascade).Error: Refusing to proceed: not a TTY. Re-run with --yes to confirm non-interactively.Aborted.
| Flag | Value | Default | Description |
|---|---|---|---|
<deployment-id>required | — | — | The deployment id. |
--yes, -y | — | — | Skip the question. |
What happens
- Prints what it will delete.
- Asks you to confirm, unless you pass
--yes. - Soft-deletes the deployment and all its runs.
- Prints how many runs, VMs and pins went with it.