Despliegues

Método	Ruta	Propósito
POST	`/deploy/check`	Validar un bundle de archivos y devolver manifiesto y diff
PATCH	`/deploy/preview`	Desplegar el manifiesto validado a un preview
POST	`/deploy/publish`	Promover un preview a live
POST	`/deploy/rollback`	Restaurar el live anterior
GET	`/deploy/status`	Punteros de despliegue
GET	`/deploy/manifest?environment=preview`	Un manifiesto desplegado
GET	`/deploy/revisions`	Historial de despliegues
GET	`/deploy/revisions/:id`	Un despliegue

Primero llama a POST /deploy/check con los archivos del workspace:

json

{
  "environment": "preview",
  "files": [
    {
      "path": "vatio.yml",
      "encoding": "utf-8",
      "content": "workspace: acme\nagent:\n  instructions: Help visitors learn about Acme.\n"
    }
  ]
}

Cada archivo tiene un path relativo, content y encoding (utf-8 o base64). La respuesta contiene ok, manifest, errors, warnings y diff. Los diagnósticos contienen message y path. Una falla de validación es HTTP 200 con ok: false; un bundle ilegible o sobredimensionado es 422.

Cuando ok es true, envía el manifest devuelto sin modificar a PATCH /deploy/preview, con git_sha y environment opcionales (default preview). No construyas tú el manifiesto normalizado. La respuesta incluye deployment_id, environment, share_url y preview_url.

Publica con { "environment": "preview" }, o nombra otro preview. El rollback no necesita cuerpo. Ninguna de las dos operaciones sube tus archivos locales.

Despliegues ​

Despliegues