Versões e deploy

Rascunhos, versões imutáveis, deploys, slugs, desativar, duplicar e excluir decisões — e o que os seus clientes da API veem em cada etapa.

Toda decisão tem um rascunho editável e um histórico de versões imutáveis. A API sempre roda a versão ativa; o rascunho só chega à produção quando você o publica.

Anatomia de uma decisão

PropriedadeRegras
NomeDe 1 a 80 caracteres.
SlugO endpoint: POST /v1/decisions/{slug}. Letras minúsculas, dígitos e hifens simples, até 64 caracteres. Único no workspace.
DescriçãoOpcional, até 500 caracteres.
RascunhoO schema que você está editando.
VersõesSnapshots imutáveis criados a cada deploy: v1, v2, …
StatusDraft, Live ou Disabled.

Ciclo de vida

 Draft ──deploy──▶ Live (v1) ──deploy──▶ Live (v2) ──deploy──▶ …
                      │   ▲
               disable│   │enable
                      ▼   │
                    Disabled
StatusO que POST /v1/decisions/{slug} devolve
Rascunho — nunca publicada409 DECISION_NOT_DEPLOYED
No ar200 com a resposta da versão ativa; version diz qual
Desativada409 DECISION_DISABLED
Excluída (ou slug desconhecido)404 DECISION_NOT_FOUND

Rascunhos e salvamento automático

O editor e o construtor visual editam o mesmo rascunho. As mudanças são salvas automaticamente cerca de 1,5 segundo depois da sua última edição — só quando o rascunho é válido; caso contrário, a barra de salvamento lista os problemas com um link Ir para o erro.

Se um colega (ou outra aba) salvou a decisão depois que você a abriu, o seu salvamento é recusado em vez de sobrescrever o dele: a barra de salvamento mostra Outra pessoa salvou esta decisão e oferece Carregar a versão atual.

Salvar um rascunho nunca muda a produção.

Deploy

Publicar (na aba Publicar da decisão) congela o rascunho atual como a versão n + 1 e a torna ativa imediatamente — os clientes em andamento passam a usá-la na próxima chamada. As edições não salvas são salvas primeiro; um rascunho com problemas de schema não pode ser publicado.

  • As versões são imutáveis: não podem ser editadas nem excluídas.
  • O campo version da resposta e cada execução registram a versão que respondeu.
  • O Histórico de versões lista todas as versões (No ar ou Arquivada) com o schema completo.
  • Uma versão continua rodando como foi publicada. Quando a Dcision endurece uma regra de validação — a v0.3 confere os valores das regras contra as opções, os níveis e os intervalos com que eles são comparados —, a nova regra vale a partir da próxima vez que você salvar ou publicar o rascunho, nunca para uma versão no ar.
  • Publicar, como qualquer mudança numa decisão, exige o papel de Membro ou superior — veja Time, papéis e conta.

Voltando atrás

Ainda não existe rollback com um clique. Para voltar a um comportamento anterior, abra o schema da versão no Histórico de versões, leve o rascunho de volta a ele e publique — isso cria um novo número de versão com a lógica antiga.

Slugs

  • Quando você cria uma decisão, o slug é gerado a partir do nome: acentos removidos, tudo em minúsculas e o resto convertido em hifens — "Lead Qualification!" vira lead-qualification. Se o slug já estiver em uso, um sufixo é adicionado: lead-qualification-2.
  • Você pode mudar o slug até o primeiro deploy. Depois disso ele fica travado: os clientes o chamam, e renomeá-lo os quebraria (409 CONFLICT — "The slug can't change after the first deploy.").
  • Os slugs são únicos por workspace. Dois workspaces podem ter uma decisão lead-qualification cada: a API key decide qual workspace — e, portanto, qual decisão — roda.

Desativar e ativar

Desativar endpoint para uma decisão no ar sem perder nada: as chamadas recebem 409 DECISION_DISABLED até você clicar em Ativar endpoint, que volta a servir a mesma versão ativa. Só uma decisão que já foi publicada pode ser ativada.

Duplicar

Duplicar copia o rascunho (não as versões) para uma nova decisão chamada "nome (copy)", com o próprio slug e sem versões. Ela conta para o limite de decisões do seu plano.

Excluir

Excluir remove a decisão junto com as versões e o histórico de execuções. As chamadas ao slug dela falham imediatamente com 404 DECISION_NOT_FOUND, e o slug fica livre para uma nova decisão. Não dá para desfazer.

Limites do plano

O número de decisões por workspace depende do plano — 2 no Genesis, 10 no Developer, ilimitadas no Growth e no Enterprise. Criar ou duplicar além disso falha com 402 PLAN_LIMIT_REACHED; exclua uma decisão ou faça upgrade. Decisões desativadas e em rascunho também contam.

Nesta página