Build Site

curl -X POST https://win.oneshotagent.com/v1/tools/build \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{
    "type": "saas",
    "product": {
      "name": "TaskFlow",
      "description": "AI-powered task management for remote teams. Automate workflows, track progress, and collaborate seamlessly.",
      "industry": "Productivity",
      "pricing": "Free tier, Pro $12/mo, Team $29/mo"
    },
    "lead_capture": {
      "enabled": true
    },
    "brand": {
      "primary_color": "#4F46E5",
      "tone": "professional"
    }
  }'

import { OneShot } from "@oneshot-agent/sdk";

const agent = new OneShot({ privateKey: process.env.AGENT_PRIVATE_KEY });

const result = await agent.build({
  type: "saas",
  product: {
    name: "TaskFlow",
    description: "AI-powered task management for remote teams. Automate workflows, track progress, and collaborate seamlessly.",
    industry: "Productivity",
    pricing: "Free tier, Pro $12/mo, Team $29/mo"
  },
  lead_capture: { enabled: true },
  brand: {
    primary_color: "#4F46E5",
    tone: "professional"
  }
});

console.log("Website URL:", result.url);
console.log("Lead capture:", result.lead_capture_email);

{
  "error": "payment_required",
  "message": "Payment required for website build.",
  "payment_request": {
    "chain_id": 8453,
    "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2.50",
    "recipient": "0x..."
  },
  "context": {
    "tool": "build",
    "quote_id": "quote_abc123",
    "type": "saas",
    "product_name": "TaskFlow",
    "analysis": {
      "inferred_type": "saas",
      "estimated_sections": 5,
      "needs_lead_capture": true,
      "complexity_score": 0.7,
      "reasoning": "SaaS product with pricing tiers and team features"
    },
    "pricing": {
      "base_price": "1.00",
      "extra_sections_fee": "1.00",
      "lead_capture_fee": "0.50",
      "source_analysis_fee": "0.00",
      "custom_domain_fee": "0.00",
      "total": "2.50"
    },
    "expires_at": "2024-01-15T12:00:00Z"
  }
}

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "tool": "build",
  "message": "Build initiated. Results available at /v1/requests/{id}.",
  "build": {
    "type": "saas",
    "product_name": "TaskFlow",
    "lead_capture_email": "[email protected]",
    "total_price": "2.50"
  }
}

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "result": {
    "status": "deployed",
    "url": "https://taskflow.oneshotagent.com",
    "preview_url": "https://taskflow-abc123.preview.example.com",
    "lead_capture_email": "[email protected]",
    "design_score": 8.5
  }
}

POST

tools

build

curl -X POST https://win.oneshotagent.com/v1/tools/build \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{
    "type": "saas",
    "product": {
      "name": "TaskFlow",
      "description": "AI-powered task management for remote teams. Automate workflows, track progress, and collaborate seamlessly.",
      "industry": "Productivity",
      "pricing": "Free tier, Pro $12/mo, Team $29/mo"
    },
    "lead_capture": {
      "enabled": true
    },
    "brand": {
      "primary_color": "#4F46E5",
      "tone": "professional"
    }
  }'

import { OneShot } from "@oneshot-agent/sdk";

const agent = new OneShot({ privateKey: process.env.AGENT_PRIVATE_KEY });

const result = await agent.build({
  type: "saas",
  product: {
    name: "TaskFlow",
    description: "AI-powered task management for remote teams. Automate workflows, track progress, and collaborate seamlessly.",
    industry: "Productivity",
    pricing: "Free tier, Pro $12/mo, Team $29/mo"
  },
  lead_capture: { enabled: true },
  brand: {
    primary_color: "#4F46E5",
    tone: "professional"
  }
});

console.log("Website URL:", result.url);
console.log("Lead capture:", result.lead_capture_email);

{
  "error": "payment_required",
  "message": "Payment required for website build.",
  "payment_request": {
    "chain_id": 8453,
    "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2.50",
    "recipient": "0x..."
  },
  "context": {
    "tool": "build",
    "quote_id": "quote_abc123",
    "type": "saas",
    "product_name": "TaskFlow",
    "analysis": {
      "inferred_type": "saas",
      "estimated_sections": 5,
      "needs_lead_capture": true,
      "complexity_score": 0.7,
      "reasoning": "SaaS product with pricing tiers and team features"
    },
    "pricing": {
      "base_price": "1.00",
      "extra_sections_fee": "1.00",
      "lead_capture_fee": "0.50",
      "source_analysis_fee": "0.00",
      "custom_domain_fee": "0.00",
      "total": "2.50"
    },
    "expires_at": "2024-01-15T12:00:00Z"
  }
}

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "tool": "build",
  "message": "Build initiated. Results available at /v1/requests/{id}.",
  "build": {
    "type": "saas",
    "product_name": "TaskFlow",
    "lead_capture_email": "[email protected]",
    "total_price": "2.50"
  }
}

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "result": {
    "status": "deployed",
    "url": "https://taskflow.oneshotagent.com",
    "preview_url": "https://taskflow-abc123.preview.example.com",
    "lead_capture_email": "[email protected]",
    "design_score": 8.5
  }
}

Send a product description; get back a deployed website at a live, hosted URL. You get a quote first, then pay, then poll for the URL. It builds landing pages, portfolios, restaurant sites, event pages and the like. Not supported: full-stack applications with databases, authentication, or backend logic.

Authentication

Requires x402 payment. The first call returns a quote (402); the second, with payment, runs the build.

Request Body

object

required

Product details for the site.

Show product properties

string

required

Product or business name

string

required

Product or service description (minimum 10 characters)

string

Industry category (e.g., “SaaS”, “E-commerce”, “Consulting”)

string

Pricing information to display on the site

string

default:"saas"

One of saas, portfolio, agency, personal, product, funnel, restaurant, event, app, social.

string

URL to analyze for content or inspiration. Adds a fee to the quote (see Pricing).

string[]

Sections to include (e.g., ["hero", "features", "pricing", "testimonials"])

object

Lead capture form settings.

Show lead_capture properties

boolean

Enables the lead capture form. Adds a fee to the quote (see Pricing).

string

Email that receives leads (defaults to the agent inbox)

object

Brand settings.

Show brand properties

string

Primary brand color as hex (e.g., #4F46E5)

string

Preferred font family

string

professional, playful, bold, or minimal

object

Image URLs to use.

Show images properties

string

Hero image URL

string

Logo image URL

string

Custom domain (e.g., mysite.com). Adds the domain registration price to the quote.

string

Existing build ID to update. Prefer the /update endpoint.

Quote Response (402)

The first request returns pricing and an analysis:

string

Quote ID to include in the payment request

string

Inferred website type

string

Product name from the request

object

AI analysis of the build request

object

Pricing breakdown

string

Quote expiry timestamp (1 hour)

Execution Response (202)

After payment, the build starts:

string

Job ID for tracking build status

string

processing while the build runs

string

Lead capture email (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 that receives lead submissions

number

AI-evaluated quality score (1-10)

curl -X POST https://win.oneshotagent.com/v1/tools/build \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{
    "type": "saas",
    "product": {
      "name": "TaskFlow",
      "description": "AI-powered task management for remote teams. Automate workflows, track progress, and collaborate seamlessly.",
      "industry": "Productivity",
      "pricing": "Free tier, Pro $12/mo, Team $29/mo"
    },
    "lead_capture": {
      "enabled": true
    },
    "brand": {
      "primary_color": "#4F46E5",
      "tone": "professional"
    }
  }'

import { OneShot } from "@oneshot-agent/sdk";

const agent = new OneShot({ privateKey: process.env.AGENT_PRIVATE_KEY });

const result = await agent.build({
  type: "saas",
  product: {
    name: "TaskFlow",
    description: "AI-powered task management for remote teams. Automate workflows, track progress, and collaborate seamlessly.",
    industry: "Productivity",
    pricing: "Free tier, Pro $12/mo, Team $29/mo"
  },
  lead_capture: { enabled: true },
  brand: {
    primary_color: "#4F46E5",
    tone: "professional"
  }
});

console.log("Website URL:", result.url);
console.log("Lead capture:", result.lead_capture_email);

{
  "error": "payment_required",
  "message": "Payment required for website build.",
  "payment_request": {
    "chain_id": 8453,
    "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2.50",
    "recipient": "0x..."
  },
  "context": {
    "tool": "build",
    "quote_id": "quote_abc123",
    "type": "saas",
    "product_name": "TaskFlow",
    "analysis": {
      "inferred_type": "saas",
      "estimated_sections": 5,
      "needs_lead_capture": true,
      "complexity_score": 0.7,
      "reasoning": "SaaS product with pricing tiers and team features"
    },
    "pricing": {
      "base_price": "1.00",
      "extra_sections_fee": "1.00",
      "lead_capture_fee": "0.50",
      "source_analysis_fee": "0.00",
      "custom_domain_fee": "0.00",
      "total": "2.50"
    },
    "expires_at": "2024-01-15T12:00:00Z"
  }
}

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "tool": "build",
  "message": "Build initiated. Results available at /v1/requests/{id}.",
  "build": {
    "type": "saas",
    "product_name": "TaskFlow",
    "lead_capture_email": "[email protected]",
    "total_price": "2.50"
  }
}

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "result": {
    "status": "deployed",
    "url": "https://taskflow.oneshotagent.com",
    "preview_url": "https://taskflow-abc123.preview.example.com",
    "lead_capture_email": "[email protected]",
    "design_score": 8.5
  }
}

See Pricing for build costs. Builds include stock images at no extra cost. Updates to existing builds are discounted; use the Update Build endpoint with your build_id.

Overview

Compute

Data

Monitoring

Research & Enrich

Messaging

Web & Browser

Build

Commerce

Account & billing

Other

Authentication

Request Body

Quote Response (402)

Execution Response (202)

Completed Job Result

​Authentication

​Request Body

​Quote Response (402)

​Execution Response (202)

​Completed Job Result

Authentication

Request Body

Quote Response (402)

Execution Response (202)

Completed Job Result