Deployments é o sistema integrado do Zoen para colocar o estado de rascunho de um fluxo de trabalho em produção para execução via API e gerenciar seu histórico de versões. Cada deploy cria uma nova versão, e as versões anteriores permanecem disponíveis para revisão ou rollback.
- Deploy e undeploy: Publique o rascunho atual como uma nova versão, ou tire um fluxo de trabalho ativo do ar e remova seus triggers, webhooks e schedules
- Promover ou reverter: Torne qualquer versão anterior a versão ativa sem criar uma nova, incluindo o re-deploy de um fluxo de trabalho despublicado em uma versão conhecida como estável
- Inspecionar histórico de versões: Liste todas as versões de deployment com seus metadados, ou obtenha o snapshot completo do estado do fluxo de trabalho de uma versão específica
No Zoen, o bloco Deployments permite que seus agentes façam deploy e undeploy de fluxos de trabalho, promovam uma versão específica para produção em rollbacks, listem todas as versões de deployment de um fluxo de trabalho e recuperem o snapshot do estado implantado de qualquer versão anterior — tudo de forma programática como parte de outro fluxo de trabalho.
Deploy, undeploy, and roll back workflows in the current workspace. Promote a previous deployment version to live, list every version, or fetch the deployed workflow state for a specific version.
Deploy a workflow’s current draft state, creating a new deployment version and making it live for API execution. Requires admin permission on the workflow’s workspace.
| Parameter | Type | Required | Description |
|---|
workflowId | string | Yes | ID of the workflow to deploy |
name | string | No | Optional label for the new deployment version |
description | string | No | Optional summary of what changed in this version |
| Parameter | Type | Description |
|---|
workflowId | string | ID of the deployed workflow |
isDeployed | boolean | Whether the workflow is now deployed |
deployedAt | string | ISO 8601 timestamp of the deployment (null if unavailable) |
version | number | The deployment version that is now active |
warnings | array | Non-fatal warnings (e.g. trigger or schedule sync still in progress) |
Take a deployed workflow offline. API execution stops and schedules, webhooks, and other deployment side effects are removed. Requires admin permission on the workflow’s workspace.
| Parameter | Type | Required | Description |
|---|
workflowId | string | Yes | ID of the workflow to undeploy |
| Parameter | Type | Description |
|---|
workflowId | string | ID of the undeployed workflow |
isDeployed | boolean | Whether the workflow is still deployed (false) |
deployedAt | string | Always null after an undeploy |
warnings | array | Non-fatal warnings (e.g. trigger or schedule cleanup still in progress) |
Make a specific deployment version the live one without creating a new version — the same operation as Promote to live in the deploy modal. Useful for rolling back to a known-good version. Also works on an undeployed workflow: it re-deploys the workflow live at that version. Requires admin permission on the workflow’s workspace.
| Parameter | Type | Required | Description |
|---|
workflowId | string | Yes | ID of the workflow |
version | number | Yes | The deployment version number to promote to live |
| Parameter | Type | Description |
|---|
workflowId | string | ID of the workflow |
isDeployed | boolean | Whether the workflow is now deployed |
deployedAt | string | ISO 8601 timestamp of the active deployment (null if unavailable) |
version | number | The deployment version that is now live |
warnings | array | Non-fatal warnings (e.g. trigger or schedule sync still in progress) |
List every deployment version of a workflow, newest first, including which version is currently live.
| Parameter | Type | Required | Description |
|---|
workflowId | string | Yes | ID of the workflow |
| Parameter | Type | Description |
|---|
workflowId | string | ID of the workflow |
versions | array | Deployment versions, newest first (id, version, name, description, isActive, createdAt, createdBy, deployedByName) |
Fetch a single deployment version of a workflow, including its metadata and the full workflow state snapshot that was deployed.
| Parameter | Type | Required | Description |
|---|
workflowId | string | Yes | ID of the workflow |
version | number | Yes | The deployment version number to fetch |
| Parameter | Type | Description |
|---|
workflowId | string | ID of the workflow |
version | number | The deployment version number |
name | string | Version label |
description | string | Version description |
isActive | boolean | Whether this version is currently live |
createdAt | string | When this version was deployed (ISO 8601) |
deployedState | json | The full workflow state snapshot (blocks, edges, loops, parallels, variables) |