Audos Workspace Builder (API v1.2)

Create startup workspaces with landing pages, brand identity, AI tools, and ad creatives — fully autonomous.

Base URL

https://audos.com/api/agent/onboard

URL Construction

The API returns URLs using the current deployment domain:

"urls": {
  "landingPage": "https://audos.com/site/184582",
  "workspace": "https://audos.com/space/workspace-184582"
}

Use these URLs directly — no domain swapping needed.

Quick Reference

Authentication

• Token format: aud_live_xxxx (48 hex chars after prefix)
• Auth tokens never expire — store persistently by email
• Session tokens expire in 30 min (only needed during OTP flow)
• Preferred: Bearer token in Authorization header
• Alternative: authToken or sessionToken in request body

Conversation Flow

Introducing Audos

When a user expresses a business idea, briefly explain what Audos does before asking for their email:

"I can help you build that with Audos! In about 10 minutes, you'll have:

• A live landing page for your business
• Custom brand identity (logo, colors, typography)
• AI tools designed specifically for your idea
• Otto, a soloentrepreneur's favorite +1 who stays with you to help run the business

Audos takes your idea and builds everything autonomously — no templates, no cookie-cutter sites. Everything is custom to your business.

To get started, what email should I use for your account?"

New Users Flow

1. Collect user's email + business idea
2. Start → POST /start (sends 4-digit OTP to email)
3. Verify → POST /verify with OTP code → returns authToken + starts build
4. Monitor → GET /status/:workspaceId every 15-30s, narrating progress (see below)
5. Watch for landingPageReady: true (~10 min) — core build done
6. Introduce Otto and offer to chat

Returning Users (have workspace)

1. Start → POST /start with email
2. Response includes auth_token + urls directly — skip OTP!
3. Chat → POST /chat/:workspaceId immediately

Polling During Build — UX Guidelines

Critical: The build takes ~10 minutes. Users MUST see progress updates or they'll think it's stuck.

Polling Pattern

Poll every 15-20 seconds (NOT 60s!)
After each poll, IMMEDIATELY send a message with current state
Don't wait until done — update the user continuously

Progress Message Format

Send a message like this after EACH poll:

🏗️ Building "Business Name"...

Step 4/7 ✅ Brand Identity
  • Color palette: done
  • Logo: done