Deploy a Website with One API Call

Most deployment workflows look like this: push to GitHub, configure a CI/CD pipeline, set up a hosting provider, buy a domain somewhere else, copy DNS records between tabs, wait for propagation, debug SSL. That's fine for humans who do it once and forget.

AI agents deploy constantly. They prototype, test, iterate, and ship — sometimes dozens of times a day. They need deployment that's one HTTP request, not one afternoon.

Hoist's deploy endpoint does exactly that.

The API Call

curl -X POST https://hoist-g8do.polsia.app/api/deploy \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://github.com/user/landing-page"
  }'

That's it. No authentication required for anonymous deploys. You get back a live URL in seconds:

{
  "success": true,
  "slug": "landing-page-a1b2c3",
  "url": "https://landing-page-a1b2c3.hoist-g8do.polsia.app",
  "claim_token": "ct_abc123..."
}

Your site is live. SSL included. No account needed.

Anonymous Deploys

Anonymous deploys are Hoist's killer feature for rapid prototyping. Here's how they work:

• No signup required — just POST your source URL
• Temporary subdomain — you get a *.hoist-g8do.polsia.app URL
• 24-hour expiry — anonymous deploys auto-expire unless claimed
• Claim later — use the claim_token to permanently attach the deploy to your account

This means an AI agent can ship a working prototype to a live URL without any credentials. Perfect for:

• Generating landing pages from a product description
• Deploying demo apps during a conversation
• Testing code before committing to a custom domain

Deploy to a Custom Domain

Want a real domain? Add authentication and a domain parameter:

curl -X POST https://hoist-g8do.polsia.app/api/deploy \
  -H "Authorization: Bearer hoist_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "myapp.dev",
    "source_url": "https://github.com/user/my-app"
  }'

Hoist handles everything:

1. Domain registration — if you don't own it yet, returns a payment link
2. Code cloning — pulls your repo from GitHub
3. Build detection — identifies Node.js, static sites, etc.
4. Deployment — uploads build artifacts to edge infrastructure
5. DNS configuration — points the domain to your deploy
6. SSL provisioning — HTTPS works immediately

Response:

{
  "success": true,
  "deploy_id": "dep_xyz789",
  "domain": "myapp.dev",
  "url": "https://myapp.dev",
  "status": "deploying"
}

Using JavaScript (fetch)

For agents and automation scripts running in Node.js:

const response = await fetch('https://hoist-g8do.polsia.app/api/deploy', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer hoist_sk_your_key'
  },
  body: JSON.stringify({
    domain: 'myproject.dev',
    source_url: 'https://github.com/user/project'
  })
});

const result = await response.json();
console.log(`Live at: ${result.url}`);

Using Python (requests)

import requests

response = requests.post(
    'https://hoist-g8do.polsia.app/api/deploy',
    headers={
        'Authorization': 'Bearer hoist_sk_your_key',
        'Content-Type': 'application/json'
    },
    json={
        'domain': 'myproject.dev',
        'source_url': 'https://github.com/user/project'
    }
)

data = response.json()
print(f"Live at: {data['url']}")

Check Deploy Status

Poll the deploy status endpoint to know when your site is live:

curl https://hoist-g8do.polsia.app/api/deploy/dep_xyz789/status \
  -H "Authorization: Bearer hoist_sk_your_key"

{
  "deploy_id": "dep_xyz789",
  "status": "live",
  "domain": "myapp.dev",
  "url": "https://myapp.dev",
  "deployed_at": "2026-04-04T12:00:00Z"
}

Status values: queued → building → deploying → live (or failed with error details).

Why One API Call Matters

For AI agents: Every additional step in a workflow is a failure point. One API call means one thing to get right. Agents don't need to orchestrate GitHub Actions, configure Vercel projects, or manage Cloudflare DNS zones separately.

For rapid prototyping: Ship a working demo in the time it takes to describe what you want. An AI agent can generate a landing page, deploy it, and hand you a live URL — all within a single conversation turn.

For autonomous workflows: Agents that manage their own infrastructure need atomic operations. "Deploy this code to this domain" should be one step, not seven. Hoist makes infrastructure disappear so agents can focus on the product.

Compare the Workflows

Get Started

1. Anonymous deploy (no account): just POST a source_url
2. Custom domain: sign up for an API key
3. MCP integration: add the Hoist MCP server to Claude Desktop or Cursor

Full API docs: hoist-g8do.polsia.app/docs

Hoist — Domain + Deploy in one command. Try it