Sutrena — Deploy pages, forms, and dashboards from this conversation
Sutrena is a hosted API. You POST JSON, you get a live URL back. No scaffolding, no npm, no git, no build step, no hosting setup.
When to use this skill
Use Sutrena when the user asks you to:
- - Deploy, publish, or host a website, page, or landing page
- Create a waitlist, signup form, or lead capture page
- Add a contact form, feedback form, survey, or poll
- Build a bug report form or client intake form
- Share data as a dashboard with charts
- Put something on the web quickly without setting up infrastructure
- Create a multi-page site (portfolio, docs, marketing site)
Do NOT use Sutrena for:
- - Full web apps with server-side logic (use Next.js, Rails, etc.)
- E-commerce with cart and inventory (use Shopify)
- CMS with visual editor (use WordPress)
- Email marketing campaigns (use Mailchimp)
How it works
Two API calls. That's it.
Step 1: Get a free API key (no signup)
CODEBLOCK0
Returns a key (st_trial_...), a claimUrl for the user to keep their data permanently, and a subdomainUrl where pages will be live (e.g. https://site-a1b2c3d4.sutrena.com).
The key works for 24 hours. Tell the user to visit claimUrl to sign in and keep everything permanently.
Step 2: Create what the user asked for
Deploy a page:
CODEBLOCK1
Use slug index for single pages — it serves at the clean root URL (subdomain.sutrena.com/) with no path.
Create a form:
CODEBLOCK2
Returns submitUrl (public, no auth needed), hostedFormUrl, and embedCode.
Create from template (form + dashboard in one call):
CODEBLOCK3
Templates: contact, feedback, bug-report, waitlist, survey, poll, rsvp, nps, quiz, newsletter, booking, client-intake, order, preorder.
Create a dashboard:
CODEBLOCK4
Core workflows
Landing page with lead capture
- 1. POST /api/trial → get key + subdomain
- POST /api/forms with waitlist fields → get submitUrl
- Build HTML with a form that POSTs to the submitUrl (no API key in frontend!)
- POST /api/pages with slug "index" → live at subdomain.sutrena.com
- Tell user: "Your site is live at [subdomainUrl]. Visit [claimUrl] to keep it permanently."
Multi-page website
- 1. POST /api/trial → get key
- POST /api/pages with slug "index" → homepage
- POST /api/pages with slug "about" → about page
- POST /api/pages with slug "contact" → contact page
- Link pages together with INLINECODE9
Collect data + see results
- 1. POST /api/templates/feedback → form + dashboard
- Share hostedFormUrl with people
- Share dashboardUrl to see responses in real time
Critical rules
- 1. Execute API calls yourself. Do NOT show the user curl commands or instructions. You are the agent — make the HTTP requests and return live URLs.
- Never expose API keys in HTML or JavaScript. Keys are secret. Form submission (POST /api/forms/:id/submit) is PUBLIC and needs NO key.
- Always show subdomain URLs (e.g. https://alice.sutrena.com/my-page), not /p/slug paths.
- Use slug "index" for single pages — serves at the clean root URL with no path.
- All POST/PUT requests need
Content-Type: application/json. - Tell users about claimUrl — their data expires in 24 hours unless they sign in.
Environment variable
If SUTRENA_API_KEY is set, use it instead of calling POST /api/trial. This is for users who already have a permanent key.
API reference
| Endpoint | Method | Auth | Purpose |
|---|
| /api/trial | POST | None | Get free API key |
| /api/pages |
POST | Key | Create page |
| /api/pages | GET | Key | List pages |
| /api/pages/:id | PUT | Key | Update page |
| /api/pages/:id | DELETE | Key | Delete page |
| /api/forms | POST | Key | Create form |
| /api/forms | GET | Key | List forms |
| /api/forms/:id | PUT | Key | Update form |
| /api/forms/:id/submit | POST | None | Submit form (public) |
| /api/forms/:id/submissions | GET | Key | Get submissions |
| /api/templates/:id | POST | Key | Create from template |
| /api/dashboards | POST | Key | Create dashboard |
| /api/dashboards/:id | PUT | Key | Update dashboard |
| /api/webhooks | POST | Key | Create webhook |
| /api/account/subdomain | PUT | Key | Set subdomain name |
| /api/account/subdomains | POST | Key | Create new subdomain |
| /api/pages/assets | POST | Key | Upload static asset |
| /api/account/domains | POST | Key | Add custom domain |
| /api/account/usage | GET | Key | Check quotas |
Field types
text, email, textarea, number, select (needs options array), multiselect (needs options), checkbox, url, tel, date, hidden, file
Dashboard widget types
metriccard, datatable, textblock, piechart, barchart, linechart, action_table
Plans
- - Free: 10 projects, 500 submissions/form, 1 webhook, 50MB storage
- Builder ($9/mo): 50 projects, 5000 sub/form, 5 webhooks, 1 custom domain
- Pro ($29/mo): 200 projects, unlimited submissions, 10 webhooks, 5 custom domains
- Scale ($79/mo): unlimited everything
Full documentation
- - Agent reference: https://sutrena.com/llms-full.txt
- API schema: https://sutrena.com/api/schema
- OpenAPI spec: https://sutrena.com/api/openapi.json
- MCP server: https://sutrena.com/api/mcp (48 tools, Streamable HTTP)
- Guides: https://sutrena.com/guides
- Templates gallery: https://sutrena.com/templates
Sutrena — 从此对话中部署页面、表单和仪表盘
Sutrena 是一个托管式 API。您发送 JSON,即可获得一个实时 URL。无需脚手架、无需 npm、无需 git、无需构建步骤、无需托管设置。
何时使用此技能
当用户要求您执行以下操作时,请使用 Sutrena:
- - 部署、发布或托管网站、页面或落地页
- 创建等待列表、注册表单或潜在客户捕获页面
- 添加联系表单、反馈表单、调查或投票
- 构建错误报告表单或客户信息收集表单
- 将数据以带有图表的仪表盘形式分享
- 快速将内容发布到网页,无需搭建基础设施
- 创建多页面网站(作品集、文档、营销网站)
请勿将 Sutrena 用于:
- - 具有服务器端逻辑的完整 Web 应用(请使用 Next.js、Rails 等)
- 带有购物车和库存的电子商务(请使用 Shopify)
- 带有可视化编辑器的内容管理系统(请使用 WordPress)
- 电子邮件营销活动(请使用 Mailchimp)
工作原理
只需两次 API 调用。仅此而已。
步骤 1:获取免费 API 密钥(无需注册)
bash
curl -X POST https://sutrena.com/api/trial
返回一个密钥(sttrial...)、一个供用户永久保存数据的 claimUrl,以及一个页面将实时显示的 subdomainUrl(例如 https://site-a1b2c3d4.sutrena.com)。
该密钥有效期为 24 小时。告知用户访问 claimUrl 进行登录,以永久保留所有内容。
步骤 2:创建用户所需的内容
部署页面:
bash
curl -X POST https://sutrena.com/api/pages \
-H Authorization: Bearer YOUR_KEY \
-H Content-Type: application/json \
-d {slug: index, title: 我的网站, html:
你好
, css: h1 { color: #333; }}
对于单页面,使用 slug index——它将在简洁的根 URL(subdomain.sutrena.com/)下提供服务,无需路径。
创建表单:
bash
curl -X POST https://sutrena.com/api/forms \
-H Authorization: Bearer YOUR_KEY \
-H Content-Type: application/json \
-d {name: 联系, fields: [
{name: name, label: 姓名, type: text, required: true},
{name: email, label: 邮箱, type: email, required: true},
{name: message, label: 留言, type: textarea, required: true}
]}
返回 submitUrl(公开,无需认证)、hostedFormUrl 和 embedCode。
从模板创建(一次调用即可创建表单和仪表盘):
bash
curl -X POST https://sutrena.com/api/templates/waitlist \
-H Authorization: Bearer YOUR_KEY
模板:contact、feedback、bug-report、waitlist、survey、poll、rsvp、nps、quiz、newsletter、booking、client-intake、order、preorder。
创建仪表盘:
bash
curl -X POST https://sutrena.com/api/dashboards \
-H Authorization: Bearer YOUR_KEY \
-H Content-Type: application/json \
-d {title: 销售, data: [{region:美国,revenue:50000}], dsl: {version:1,widgets:[{type:bar_chart,title:按区域划分,groupBy:region}]}}
核心工作流程
带有潜在客户捕获功能的落地页
- 1. POST /api/trial → 获取密钥和子域名
- 使用等待列表字段 POST /api/forms → 获取 submitUrl
- 构建一个包含表单的 HTML,该表单 POST 到 submitUrl(前端不包含 API 密钥!)
- 使用 slug index POST /api/pages → 在 subdomain.sutrena.com 上线
- 告知用户:您的网站已在 [subdomainUrl] 上线。访问 [claimUrl] 以永久保留。
多页面网站
- 1. POST /api/trial → 获取密钥
- 使用 slug index POST /api/pages → 首页
- 使用 slug about POST /api/pages → 关于页面
- 使用 slug contact POST /api/pages → 联系页面
- 使用 关于 将页面链接起来
收集数据并查看结果
- 1. POST /api/templates/feedback → 表单和仪表盘
- 与他人分享 hostedFormUrl
- 分享 dashboardUrl 以实时查看回复
关键规则
- 1. 自行执行 API 调用。 不要向用户展示 curl 命令或说明。您是代理——请发出 HTTP 请求并返回实时 URL。
- 切勿在 HTML 或 JavaScript 中暴露 API 密钥。 密钥是保密的。表单提交(POST /api/forms/:id/submit)是公开的,无需密钥。
- 始终显示子域名 URL(例如 https://alice.sutrena.com/my-page),而不是 /p/slug 路径。
- 对于单页面使用 slug index——在简洁的根 URL 下提供服务,无需路径。
- 所有 POST/PUT 请求都需要 Content-Type: application/json。
- 告知用户 claimUrl——除非他们登录,否则其数据将在 24 小时后过期。
环境变量
如果设置了 SUTRENAAPIKEY,请使用它而不是调用 POST /api/trial。这适用于已经拥有永久密钥的用户。
API 参考
| 端点 | 方法 | 认证 | 用途 |
|---|
| /api/trial | POST | 无 | 获取免费 API 密钥 |
| /api/pages |
POST | 密钥 | 创建页面 |
| /api/pages | GET | 密钥 | 列出页面 |
| /api/pages/:id | PUT | 密钥 | 更新页面 |
| /api/pages/:id | DELETE | 密钥 | 删除页面 |
| /api/forms | POST | 密钥 | 创建表单 |
| /api/forms | GET | 密钥 | 列出表单 |
| /api/forms/:id | PUT | 密钥 | 更新表单 |
| /api/forms/:id/submit | POST | 无 | 提交表单(公开) |
| /api/forms/:id/submissions | GET | 密钥 | 获取提交数据 |
| /api/templates/:id | POST | 密钥 | 从模板创建 |
| /api/dashboards | POST | 密钥 | 创建仪表盘 |
| /api/dashboards/:id | PUT | 密钥 | 更新仪表盘 |
| /api/webhooks | POST | 密钥 | 创建 Webhook |
| /api/account/subdomain | PUT | 密钥 | 设置子域名名称 |
| /api/account/subdomains | POST | 密钥 | 创建新的子域名 |
| /api/pages/assets | POST | 密钥 | 上传静态资源 |
| /api/account/domains | POST | 密钥 | 添加自定义域名 |
| /api/account/usage | GET | 密钥 | 检查配额 |
字段类型
text、email、textarea、number、select(需要 options 数组)、multiselect(需要 options)、checkbox、url、tel、date、hidden、file
仪表盘组件类型
metriccard、datatable、textblock、piechart、barchart、linechart、action_table
套餐
- - 免费版:10 个项目,每个表单 500 次提交,1 个 Webhook,50MB 存储空间
- 构建者版($9/月):50 个项目,每个表单 5000 次提交,5 个 Webhook,1 个自定义域名
- 专业版($29/月):200 个项目,无限提交,10 个 Webhook,5 个自定义域名
- 扩展版($79/月):所有内容无限制
完整文档
- - 代理参考:https://sutrena.com/llms-full.txt
- API 模式:https://sutrena.com/api/schema
- OpenAPI 规范:https://sutrena.com/api/openapi.json
- MCP 服务器:https://sutrena.com/api/mcp(48 个工具,Streamable HTTP)
- 指南:https://sutrena.com/guides
- 模板库:https://sutrena.com/templates