Guides/How to build a multi-page website via API

How to build a multi-page website via API

Set a subdomain. Create pages. Ship a site.

Updated March 2026

Sutrena is the web runtime for AI agents. Deploy a complete multi-page website with just API calls. Set a memorable subdomain, create pages with different slugs, and you have a live website. No hosting provider, no build pipeline, no Git. Perfect for event sites, portfolios, project documentation, and any multi-page content an agent or developer needs to publish quickly.

1. Get an API key

Use the free plan (sign up at sutrena.com) or get a trial key instantly with no signup.

curl -X POST https://sutrena.com/api/trial

2. Set your subdomain

Choose a memorable subdomain for your site. This becomes your base URL. All pages you create will be served under this subdomain.

curl -X PUT https://sutrena.com/api/account/subdomain   -H "Authorization: Bearer $KEY"   -H "Content-Type: application/json"   -d '{"subdomain": "myevent"}'

# Your site is now at: myevent.sutrena.com

3. Create the homepage

POST a page with slug "index". This becomes the root page at myevent.sutrena.com/. Include navigation links to your other pages using relative paths.

curl -X POST https://sutrena.com/api/pages   -H "Authorization: Bearer $KEY"   -H "Content-Type: application/json"   -d '{
    "slug": "index",
    "title": "DevConf 2026",
    "html": "<!DOCTYPE html><html><head><style>nav{display:flex;gap:1rem;padding:1rem;background:#111;color:#fff}nav a{color:#fff;text-decoration:none}main{max-width:800px;margin:2rem auto;padding:0 1rem}</style></head><body><nav><a href="/">Home</a><a href="/about">About</a><a href="/schedule">Schedule</a></nav><main><h1>DevConf 2026</h1><p>March 15-17. Three days of talks, workshops, and networking.</p></main></body></html>"
  }'

4. Create additional pages

Add more pages with different slugs. Each slug maps to a path under your subdomain. Use the same navigation HTML across pages for a consistent site experience.

# Create the About page at myevent.sutrena.com/about
curl -X POST https://sutrena.com/api/pages   -H "Authorization: Bearer $KEY"   -H "Content-Type: application/json"   -d '{
    "slug": "about",
    "title": "About DevConf",
    "html": "<!DOCTYPE html><html><head><style>nav{display:flex;gap:1rem;padding:1rem;background:#111;color:#fff}nav a{color:#fff;text-decoration:none}main{max-width:800px;margin:2rem auto;padding:0 1rem}</style></head><body><nav><a href="/">Home</a><a href="/about">About</a><a href="/schedule">Schedule</a></nav><main><h1>About DevConf</h1><p>A community-run developer conference in its third year.</p></main></body></html>"
  }'

# Create the Schedule page at myevent.sutrena.com/schedule
curl -X POST https://sutrena.com/api/pages   -H "Authorization: Bearer $KEY"   -H "Content-Type: application/json"   -d '{
    "slug": "schedule",
    "title": "Schedule",
    "html": "<!DOCTYPE html><html><head><style>nav{display:flex;gap:1rem;padding:1rem;background:#111;color:#fff}nav a{color:#fff;text-decoration:none}main{max-width:800px;margin:2rem auto;padding:0 1rem}</style></head><body><nav><a href="/">Home</a><a href="/about">About</a><a href="/schedule">Schedule</a></nav><main><h1>Schedule</h1><ul><li>9:00 - Keynote</li><li>10:30 - Workshop: APIs</li><li>14:00 - Panel: AI agents</li></ul></main></body></html>"
  }'

5. Update pages

PUT to /api/pages/{id} with new HTML. The URL stays the same. Updates are instant. Use this to iterate on content without breaking links.

curl -X PUT https://sutrena.com/api/pages/PAGE_ID   -H "Authorization: Bearer $KEY"   -H "Content-Type: application/json"   -d '{"html": "<!DOCTYPE html><html><head><style>nav{display:flex;gap:1rem;padding:1rem;background:#111;color:#fff}nav a{color:#fff;text-decoration:none}main{max-width:800px;margin:2rem auto;padding:0 1rem}</style></head><body><nav><a href="/">Home</a><a href="/about">About</a><a href="/schedule">Schedule</a></nav><main><h1>DevConf 2026</h1><p>March 15-17. Updated with venue info and speaker lineup.</p></main></body></html>"}'

FAQ

How many pages can I create?

Pages share the project quota with forms and dashboards. Free: 10 projects. Builder: 50 projects. Pro: 200 projects. Scale: unlimited. Each page counts as one project.

Can I use a custom domain instead of a subdomain?

Yes. Builder+ plans can add custom domains via POST /api/account/domains. Add a CNAME record pointing to cname.sutrena.com and your pages are served at mysite.com/slug. See the custom domain guide.

How do I add images?

Upload assets via POST /api/pages/assets to get a presigned URL. Upload the file, then reference the CDN URL in your page HTML. You can also link to any external image over HTTPS.

Related

Deploy a page via API →Set up a custom subdomain →Upload static assets →Custom domains with CNAME →

What is Sutrena?

Sutrena is the web runtime for AI agents. Three primitives — pages, forms, and dashboards — accessible through one API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Framework-agnostic. Works from any MCP client or HTTP client.

Get started in two API calls

1. Get a trial key (no auth, no signup)

curl -X POST https://sutrena.com/api/trial

2. Create a form + dashboard from a template

curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"templateId": "waitlist", "createDashboard": true}'
/llms.txt/api/schema/llms-full.txt/.well-known/mcp.json

Ready to build?

Get a trial API key instantly with no signup, or create an account for the full experience.

Start buildingAgent docs
How to build a multi-page website via API — Sutrena | Sutrena