Build
Build
Build and deploy production websites, landing pages, portfolios, and more
POST
Overview
The Build API creates fully-functional, production-ready websites from product descriptions. From SaaS landing pages to portfolios, restaurant sites to event pages — OneShot analyzes your requirements, generates professional content, and deploys to live URLs with real hosting infrastructure. Coming soon: Full-stack applications with databases, authentication, and backend logic.Authentication
Requires x402 payment. First call returns a quote (402), second call with payment executes.Request Body
object
required
Product information for the website.
string
default:"saas"
Build type. Options:
saas, portfolio, agency, personal, product, funnel, restaurant, event, app, socialstring
URL to analyze for content/inspiration. Adds $10 to quote.
string[]
Specific sections to include (e.g.,
["hero", "features", "pricing", "testimonials"])object
Lead capture form configuration.
object
Brand customization options.
object
Image URLs to use.
string
Custom domain (e.g.,
mysite.com). Adds the registrar price (typically ~$10–15) to quote.string
Existing build ID to update (for iterations). Use
/update endpoint instead.Quote Response (402)
The first request returns pricing and analysis:string
Quote ID to include in payment request
string
Inferred website type
string
Product name from request
object
AI analysis of the build request
object
Detailed pricing breakdown
string
Quote expiration timestamp (1 hour)
Execution Response (202)
After payment, the build is initiated:string
Job ID for tracking build status
string
processing - build is in progressstring
Email address for lead capture (if enabled)
string
Total amount charged
Completed Job Result
Poll/v1/requests/{request_id} for the result:
string
Live URL (e.g.,
https://taskflow.oneshotagent.com)string
Preview URL before DNS propagation
string
Email address receiving lead submissions
number
AI-evaluated quality score (1-10)
See Pricing for build costs. All builds include high-quality stock images from Unsplash at no extra cost. Updates to existing builds are discounted — use the Update Build endpoint with your
build_id.