Publishing

Publish sites, check live status, submit forms, and manage builds. Sites auto-publish on file writes, but you can trigger manual publishes too.

POST/api/v1/sites/:id/publish

Publish a site to CDN. Syncs all files from GitHub to Cloudflare R2 and purges cache.

Auth: Bearer token

Site ID

200 OK

{ "data": { "build_id": "uuid", "status": "success", "duration_ms": 4200, "url": "https://slug.vibesites.link" } }

POST/api/v1/sites/:id/submit

Public form submission endpoint. No authentication required. Accepts JSON or FormData.

Auth: None

Site ID

Field	Type	Description
form_name	string (optional)	Form identifier (default: "contact")
...fields	object	Form field values (name, email, message, etc.)

200 OK

{ "data": { "id": "uuid", "created_at": "..." } }

POST/api/v1/sites/:id/domain

Set a custom domain. Returns DNS instructions and provisions the domain on Cloudflare.

Auth: Bearer token

Site ID

Field	Type	Description
domain	string	Domain name (e.g., "mybusiness.com")

200 OK

{ "data": { "domain": "mybusiness.com", "cname_target": "sites.vibesites.link", "ssl": true } }