Sites

Create site

Creates an additional AI site under the current account. Refuses if the proposed subdomain is taken.

post/sites

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/sites
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

promptstring

Build brief describing the storefront to generate — brand, what you're selling, and the look and feel. Kicks off an AI build. Required unless repository is given.

repositorystring

Optional "owner/repo" of an existing GitHub repository (reached through a connected GitHub App installation) to start the site from instead of generating a fresh one. When set, prompt is optional and only tells the agent what to adapt.

namestring
subdomainstring nullable
access_mode'public' | 'members' | 'account' | 'admins_only' | 'me_only'
show_referral_badgeboolean

Response

AI site created. When created with a prompt, an engineering build is started automatically — build_task_id references it; track progress via GET /tasks/{id}. Do not start another build for the site.

idstring required
objectstring required
namestring required
access_mode'public' | 'members' | 'account' | 'admins_only' | 'me_only' required
subdomainstring nullable required
github_repo_full_namestring nullable required
metadataobject required
domainstring nullable required
github_urlstring nullable required
domain_verifiedboolean required
app_urlstring nullable required
is_liveboolean required
show_referral_badgeboolean required
build_task_idstring nullable required
created_atstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.