Skip to content

Deployment

View as Markdown

Immutable record of one rollout. Its image, settings snapshot and secret versions never change; only status fields move.

Field Type Description
id * string
project_id * string
environment_id * string
service_id * string
service_name string
environment_name string
status * DeploymentStatus
status_text string
trigger * object
source object
build_id string or null
image object or null
config ServiceConfig
rollback_of string or null The earlier deployment whose image this deployment re-promotes.
operation_id string or null
url string (uri) or null
failure object or null Short failure summary; the full explanation is at /explanation.
created_at * string (date-time)
started_at string (date-time) or null
active_at string (date-time) or null
finished_at string (date-time) or null
duration_ms integer or null

* always present

{
"id": "dep_01jbx2m9k7q4r8t5v6w3y0z1dp",
"project_id": "prj_01jbx2m9k7q4r8t5v6w3y0z1pr",
"environment_id": "env_01jbx2m9k7q4r8t5v6w3y0z1en",
"service_id": "svc_01jbx2m9k7q4r8t5v6w3y0z1sv",
"service_name": "web",
"environment_name": "production",
"status": "active",
"status_text": "Live since 14:05",
"trigger": {
"kind": "git_push",
"actor": {
"type": "github",
"id": "stewartwebb",
"display": "stewartwebb pushed to main"
}
},
"source": {
"kind": "git",
"commit": {
"sha": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
"branch": "main",
"message": "Fix rota export",
"author": "Stewart Webb"
}
},
"build_id": "bld_01jbx2m9k7q4r8t5v6w3y0z1bd",
"image": {
"digest": "sha256:4b1f0e9d8c7b6a5948372615f4e3d2c1b0a9f8e7d6c5b4a3928170f6e5d4c3b2",
"signed": true
},
"rollback_of": null,
"operation_id": "op_01jbx2m9k7q4r8t5v6w3y0z1op",
"url": "https://www.primecarers.co.uk",
"failure": null,
"created_at": "2026-10-23T14:02:00Z",
"started_at": "2026-10-23T14:02:01Z",
"active_at": "2026-10-23T14:05:12Z",
"finished_at": "2026-10-23T14:05:12Z",
"duration_ms": 191000
}