Deployments

Method	Path	Purpose
POST	`/deploy/check`	Validate a file bundle and return a manifest and diff
PATCH	`/deploy/preview`	Deploy the validated manifest to a preview
POST	`/deploy/publish`	Promote a preview to live
POST	`/deploy/rollback`	Restore previous live
GET	`/deploy/status`	Deployment pointers
GET	`/deploy/manifest?environment=preview`	A deployed manifest
GET	`/deploy/revisions`	Deployment history
GET	`/deploy/revisions/:id`	One deployment

First call POST /deploy/check with the workspace files:

json

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

Each file has a relative path, content, and encoding (utf-8 or base64). The response contains ok, manifest, errors, warnings, and diff. Diagnostics contain message and path. Validation failure is HTTP 200 with ok: false; an unreadable or oversized bundle is 422.

When ok is true, send the returned manifest unchanged to PATCH /deploy/preview with optional git_sha and environment (default preview). Do not construct the normalized manifest yourself. The response includes deployment_id, environment, share_url, and preview_url.

Publish with { "environment": "preview" }, or name another preview. Rollback needs no body. Neither operation uploads your local files.

Deployments ​

Deployments