ProjectSites

Whoami

Return the org + token identity (scopes) the connected API key resolves to. Use first to confirm the connection.

List Sites

List the websites in your projectsites.dev account (id, slug, name, status, hostname).

Get Site

Get one site by id: status, primary hostname, plan, last build.

Get Build Status

Get the AI build/workflow status + step for a site (poll while a generation runs).

Get Audit Log

Recent audit-log actions for a site (deploys, edits, config changes) — inspect what happened.

Deploy Site

Deploy files to one of your sites from your editor: writes them to R2, points the site at the new version, busts cache, returns the live URL AND a stable version-pinned preview_url. files = [{path, content}] (the built dist of your app).

Create Site

Create a new empty site in your account (draft). Returns site_id + slug + URL; then deploy_site with your built files to publish.

List Snapshots

List saved snapshots for a site (id, name, build version, description, date).

Get Research

Return the AI research data collected for a site (business profile, brand, selling points).

Tail Logs

Return recent build/workflow log entries for a site (newest-first) to debug deploys.

Set Domain

Connect a custom domain (hostname) to one of your sites. Requires a paid plan + a DNS CNAME from the hostname to projectsites.dev set BEFOREHAND. Returns provisioning status + SSL state.