Getting Started with AgentBase

Deploy your first website in under 3 minutes with AgentBase's AI-native platform.

Quick Start

POST /v1/website/initialize
{
  "tenant_id": "your-tenant-id",
  "prompt": "Create a bakery website",
  "budget": 50,
  "preferred_tlds": [".com", ".net"]
}

What You Get

  • ✅ AI-generated website code
  • ✅ Domain registration (.com, .io, .net)
  • ✅ Git repository with version control
  • ✅ Cloudflare CDN deployment
  • ✅ DNS configuration
  • ✅ Free SSL certificate
  • ✅ Live HTTPS website

9-Step Workflow

AgentBase automates the entire deployment pipeline:

1

Initialize Workflow

Allocate budget from wallet and create workflow record.

POST /website/initialize
2

Register Domain

Search and register domain via OpenProvider.

POST /website/register-domain
3

Create Repository

Create Git repository in Gitea.

POST /website/create-repo
4

Commit & Deploy (Atomic)

Generate code, commit to Git, and deploy to Cloudflare in one operation.

POST /website/commit-and-deploy Recommended
5

Setup DNS

Create Cloudflare DNS zone and configure records.

POST /website/setup-dns
6

Update Nameservers

Update nameservers at domain registrar.

POST /website/update-nameservers
7

Attach Domain

Attach custom domain to Cloudflare Pages.

POST /website/attach-domain
8

Verify SSL

Verify SSL certificate provisioning.

POST /website/verify-ssl
✓

Website Live!

Your website is now live with HTTPS at your custom domain.

API Reference

Initialize Workflow

POST /v1/website/initialize 
{
  "tenant_id": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "Create a professional bakery website",
  "budget": 50,
  "preferred_tlds": [".com", ".io"]
}

Atomic Commit & Deploy

POST /v1/website/commit-and-deploy 
{
  "tenant_id": "550e8400-e29b-41d4-a716-446655440000",
  "workflow_id": "wf_abc123xyz"
}

Check Status

GET /v1/website/:workflow_id/status

Asset Management

Upload images, videos, fonts, and other static assets to Cloudflare R2.

Upload Asset

POST /v1/cloudflare/r2/upload 
{
  "tenant_id": "550e8400-e29b-41d4-a716-446655440000",
  "project_id": "my-project",
  "file_path": "images/logo.png",
  "content": "iVBORw0KGgoAAAANS...",
  "content_type": "image/png"
}

List Assets

GET /v1/cloudflare/r2/assets

Troubleshooting

SSL Not Active

Symptom: SSL status remains "pending" for >30 minutes

Solution:

  • Verify nameservers propagated (may take 5-60 minutes)
  • Check Cloudflare SSL settings
  • Retry verify-ssl endpoint every 5 minutes

Domain Registration Failed

Symptom: "Domain not available" error

Solution:

  • Try alternative domain name
  • Check if domain is premium (higher cost)
  • Ensure wallet has sufficient balance

Insufficient Budget

Symptom: Workflow status is "paused_insufficient_funds"

Solution:

POST /v1/website/increase-budget
{
  "tenant_id": "...",
  "workflow_id": "wf_xyz",
  "additional_budget": 20
}

POST /v1/website/resume
{
  "tenant_id": "...",
  "workflow_id": "wf_xyz"
}