Sites

Create, list, get, and delete websites. Each site gets a private GitHub repo, a vibesites.link subdomain, and CDN hosting.

POST/api/v1/sites

Create a new site. Generates a GitHub repo, commits the template, builds, and deploys.

Auth: Bearer token

Field	Type	Description
name	string	Site name (e.g., "Bean & Brew")
template	string (optional)	"blank" or "landing" (default: "landing")

200 OK

{ "data": { "id": "uuid", "slug": "bean-and-brew-k4x9", "url": "https://bean-and-brew-k4x9.vibesites.link" } }

GET/api/v1/sites

List all sites for the authenticated user.

Auth: Bearer token

200 OK

{ "data": [{ "id": "uuid", "name": "...", "slug": "...", "build_status": "success" }] }

GET/api/v1/sites/:id

Get a single site with full details — settings, structure map, build status, custom domain.

Auth: Bearer token

id	Site ID (UUID)

200 OK

{ "data": { "id": "uuid", "name": "...", "slug": "...", "custom_domain": "...", "build_status": "success", "settings": {...} } }

DELETE/api/v1/sites/:id

Delete a site permanently. Removes the site, GitHub repo, and CDN assets.

Auth: Bearer token

Site ID

200 OK

{ "data": { "deleted": true } }