Versiones y deploy

Borradores, versiones inmutables, deploys, slugs, desactivar, duplicar y eliminar decisiones — y qué ven tus clientes de la API en cada paso.

Cada decisión tiene un borrador editable y un historial de versiones inmutables. La API siempre ejecuta la versión activa; el borrador solo llega a producción cuando lo despliegas.

Anatomía de una decisión

PropiedadReglas
NombreDe 1 a 80 caracteres.
SlugEl endpoint: POST /v1/decisions/{slug}. Letras minúsculas, dígitos y guiones simples, hasta 64 caracteres. Único en el workspace.
DescripciónOpcional, hasta 500 caracteres.
BorradorEl esquema que estás editando.
VersionesSnapshots inmutables creados en cada deploy: v1, v2, …
EstadoDraft, Live o Disabled.

Ciclo de vida

 Draft ──deploy──▶ Live (v1) ──deploy──▶ Live (v2) ──deploy──▶ …
                      │   ▲
               disable│   │enable
                      ▼   │
                    Disabled
EstadoQué devuelve POST /v1/decisions/{slug}
Borrador — nunca desplegada409 DECISION_NOT_DEPLOYED
En vivo200 con la respuesta de la versión activa; version indica cuál
Desactivada409 DECISION_DISABLED
Eliminada (o slug desconocido)404 DECISION_NOT_FOUND

Borradores y guardado automático

El editor y el constructor visual editan el mismo borrador. Los cambios se guardan automáticamente unos 1.5 segundos después de tu última edición — solo cuando el borrador es válido; si no, la barra de guardado lista los problemas con un enlace Ir al error.

Si un compañero (u otra pestaña) guardó la decisión después de que la abriste, tu guardado se rechaza en lugar de sobrescribir el suyo: la barra de guardado muestra Otra persona guardó esta decisión y ofrece Cargar la versión actual.

Guardar un borrador nunca cambia producción.

Deploy

Publicar (en la pestaña Publicar de la decisión) toma un snapshot del borrador actual como versión n + 1 y la activa de inmediato — los clientes en curso pasan a ella en su siguiente llamada. Los cambios sin guardar se guardan primero; un borrador con problemas en el esquema no se puede desplegar.

  • Las versiones son inmutables: no se pueden editar ni eliminar.
  • El campo version de la respuesta y cada ejecución registran la versión que respondió.
  • El Historial de versiones lista todas las versiones (En vivo o Archivada) con su esquema completo.
  • Una versión sigue ejecutándose tal como se desplegó. Cuando Dcision endurece una regla de validación — la v0.3 comprueba los valores de las reglas contra las opciones, los niveles y los rangos con los que se comparan —, la nueva regla se aplica la próxima vez que guardes o despliegues el borrador, nunca a una versión en vivo.
  • Desplegar, como cualquier cambio en una decisión, requiere el rol Miembro o superior — consulta Equipo, roles y cuenta.

Volver atrás

Todavía no hay un rollback de un solo clic. Para volver a un comportamiento anterior, abre el esquema de la versión en Historial de versiones, lleva el borrador de vuelta a él y despliega — esto crea un nuevo número de versión con la lógica anterior.

Slugs

  • Cuando creas una decisión, el slug se genera a partir de su nombre: sin acentos, en minúsculas y con todo lo demás convertido en guiones — "Lead Qualification!" pasa a ser lead-qualification. Si el slug ya está en uso, se agrega un sufijo: lead-qualification-2.
  • Puedes cambiar el slug hasta el primer deploy. Después queda bloqueado: los clientes lo llaman, y renombrarlo los rompería (409 CONFLICT — "The slug can't change after the first deploy.").
  • Los slugs son únicos por workspace. Dos workspaces pueden tener cada uno una decisión lead-qualification: la clave de API decide qué workspace — y por lo tanto qué decisión — se ejecuta.

Desactivar y activar

Desactivar endpoint detiene una decisión en vivo sin perder nada: las llamadas reciben 409 DECISION_DISABLED hasta que hagas clic en Activar endpoint, que vuelve a servir la misma versión activa. Solo se puede activar una decisión que ya se haya desplegado.

Duplicar

Duplicar copia el borrador (no las versiones) en una nueva decisión llamada "name (copy)", con su propio slug y sin versiones. Cuenta para el límite de decisiones de tu plan.

Eliminar

Eliminar quita la decisión junto con sus versiones y su historial de ejecuciones. Las llamadas a su slug fallan de inmediato con 404 DECISION_NOT_FOUND, y el slug queda libre para una nueva decisión. No se puede deshacer.

Límites del plan

El número de decisiones por workspace depende del plan — 2 en Genesis, 10 en Developer, ilimitadas en Growth y Enterprise. Crear o duplicar por encima del límite falla con 402 PLAN_LIMIT_REACHED; elimina una decisión o mejora tu plan. Las decisiones desactivadas y en borrador también cuentan.

En esta página