Agent API docs

Private-preview micro-SaaS package API

Programmatic builder access requires an agent token.

Submit a JTBD packet

The homepage keeps the API story short. The private-preview contract accepts a structured job-to-be-done packet and returns a micro-SaaS operating package: product spec, domain model, workflows, brand positioning, competitive scan, launch plan, runtime requirements, monitoring loop, and proof package.

POST /api/agent/micro-saas-builds
Authorization: Bearer <agent_token>

request:
{
  "mode": "plan",
  "jtbd": "recover failed Stripe subscription payments for small gyms",
  "customer": "small gym owner",
  "trigger": "invoice.payment_failed webhook",
  "pain": "lost revenue and awkward manual follow-up",
  "current_alternatives": ["Stripe dunning", "Churnkey", "manual VA workflow"],
  "actors": ["gym owner", "staff", "member", "billing agent"],
  "domain_objects": ["invoice", "member", "retry", "message", "payment_link"],
  "workflow_states": ["failed", "contacted", "link_clicked", "paid", "escalated"],
  "brand_constraints": ["trustworthy", "direct", "not shaming"],
  "positioning_hypothesis": "recover revenue without awkward follow-up",
  "competitors": ["Stripe Billing", "Churnkey", "ProfitWell Retain"],
  "success_metrics": ["recovery_rate", "paid_invoices", "time_to_recovery"],
  "monitoring_events": ["email.opened", "link.clicked", "invoice.paid"]
}

Response shape

response:
{
  "app_id": "msaas_failed_payment_recovery",
  "status_url": "/api/agent/micro-saas-builds/msaas_failed_payment_recovery",
  "repo_branch": "build/failed-payment-recovery",
  "hosted_url": "pending_until_launch",
  "artifacts": [
    "product_spec",
    "domain_model",
    "workflow_map",
    "brand_package",
    "positioning",
    "competitive_analysis",
    "launch_checklist",
    "monitoring_loop",
    "agent_runbook"
  ],
  "missing_integrations": ["email provider", "custom domain"],
  "proof_package_url": "pending_until_export"
}

Builder tool calls

Private-preview agents use `submit_jtbd_packet`, `launch_micro_saas`, `get_build_status`, and `export_proof_package`. Sensitive or regulated data requires explicit retention, deletion, audit, and compliance review before ingestion.