Skip to content
  1. Docs
  2. Reference
  3. Endpoints
Reference

Endpoints

The API is organised in families, one per part of the product. All paths below are relative to https://api.autoflowly.com/api and need a bearer token unless noted. This page lists the calls you are most likely to need; the live API carries more.

Building apps#

Prefix /conversational-mvp.

POST/conversational-mvp/quickGenerate an app from a description with smart defaults. Returns the app id and its address.
POST/conversational-mvp/chatConversational generation and editing; the same endpoint the builder's chat uses.
GET/conversational-mvp/session/{session_id}Session state, messages and generated files.
GET/conversational-mvp/{mvp_id}/rebuild-statusProgress of a build or edit in flight.
Shell
curl -X POST https://api.autoflowly.com/api/conversational-mvp/quick \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "app_name": "Puppy Parlour",
    "description": "Booking site for a dog-grooming salon in Leeds with deposits and email confirmations"
  }'

Branches, versions and locked pages#

GET/conversational-mvp/{mvp_id}/branchesList branches.
POST/conversational-mvp/{mvp_id}/branchesCreate a branch from the app's current files.
POST/conversational-mvp/{mvp_id}/branches/{branch_id}/activateStart the branch's live preview.
DELETE/conversational-mvp/{mvp_id}/branches/{branch_id}Discard a branch.
GET/conversational-mvp/{mvp_id}/versionsSnapshots taken before each edit.
POST/conversational-mvp/{mvp_id}/rollbackRestore a version.
GET/conversational-mvp/{mvp_id}/locked-filesPages the AI must not modify.
PUT/conversational-mvp/{mvp_id}/locked-filesReplace the locked list (up to 500 paths).

Diagnose and repair#

POST/conversational-mvp/editor/doctor/diagnoseRun the checks and return a report with a health score and findings.
POST/conversational-mvp/editor/doctor/fixApply automatic repairs; snapshots first, optionally redeploys.

App dashboard#

Prefix /mvp-dashboard.

GET/mvp-dashboard/{mvp_id}/publishDraft or published, and the owner preview link.
POST/mvp-dashboard/{mvp_id}/publishPublish or unpublish. Instant; no rebuild.
GET/mvp-dashboard/{mvp_id}/security-checkThe latest pre-publish security check.
POST/mvp-dashboard/{mvp_id}/security-checkRun the check now.
GET/mvp-dashboard/{mvp_id}/paymentsTransactions and revenue across providers.
GET/mvp-dashboard/{mvp_id}/audit-logsAgent actions in this app, with approver and surface.
GET/mvp-dashboard/{mvp_id}/audit-logs/exportThe same as a downloadable file.

Custom domains#

Prefix /mvp-redeploy.

GET/mvp-redeploy/{mvp_id}/custom-domainCurrent domain, DNS instructions for the detected registrar, and the three readiness flags.
POST/mvp-redeploy/{mvp_id}/custom-domainSet the domain.
POST/mvp-redeploy/{mvp_id}/custom-domain/verify-dnsCheck the record against the domain's own nameservers.
DELETE/mvp-redeploy/{mvp_id}/custom-domainRemove the domain.

Operating a business#

Prefix /ai-os.

GET/ai-os/appsYour apps with status, team size, pending approvals and the 7-day activity series.
GET/ai-os/apps/{app_id}/staffing-previewThe starter team suggested for this app.
POST/ai-os/apps/{app_id}/team-pausePause or resume the AI team.
GET/ai-os/money-summaryMoney received, from recorded payment events.

Approvals#

GET/ai-os/approvalsProposals waiting for a decision, newest first.
GET/ai-os/approvals/{approval_id}One proposal with its evidence and draft.
POST/ai-os/approvals/{approval_id}/decisionApprove or reject. Include the surface you decided on; high-risk proposals require the phone.
JSON
{ "approved": true, "notes": "Confirmed with the customer", "decision_surface": "web" }

Permissions and audit#

GET/ai-os/apps/{app_id}/permissionsPer-kind settings: ask, auto or off, with limits.
PUT/ai-os/apps/{app_id}/permissionsChange them. A money kind set to auto must carry a limit.
GET/ai-os/apps/{app_id}/auditThe governance audit trail for the app.

Goal loops#

POST/ai-os/apps/{app_id}/loops/previewHow the agent would read a goal and what it would do first.
POST/ai-os/apps/{app_id}/loopsStart a loop: goal, cadence, step limit.
GET/ai-os/loopsYour loops.
GET/ai-os/loops/{loop_id}/runsEvery run of a loop with what it read and proposed.
POST/ai-os/loops/{loop_id}/pausePause; resume, stop and run-now are siblings.

Incidents#

GET/incidents/mineOpen incidents on your apps, with severity and a workshop link.

Growth#

Prefix /growth.

GET/growth/apps/{app_id}The app's goal, plan, creatives, accounts and scorecard in one call.
POST/growth/apps/{app_id}/goalSet the goal. Returns the goal and its first plan.
PATCH/growth/goals/{goal_id}Change the target, deadline or budget.
POST/growth/goals/{goal_id}/replanAsk for a new plan.
POST/growth/goals/{goal_id}/measureRefresh the baseline and today's number from the app.
GET/growth/goals/{goal_id}/metricsThe daily scorecard.
PATCH/growth/creatives/{creative_id}Approve or reject a creative, or edit its copy.
POST/growth/plans/{plan_id}/renderRender the creatives. 402 when the plan's free render is used.
POST/growth/plans/{plan_id}/request-approvalStage campaigns and create the budget approval. 409 while ad launch has not reached the account.
GET/growth/ad-accountsConnected ad accounts.
GET/growth/ad-accounts/{provider_id}/connectBegin the consent flow for google or meta.
GET/growth/walletManaged-ads credit balance.
POST/growth/wallet/topupCreate a Stripe Checkout session for credit (web only).

Custom agents#

Prefix /agent-builder.

GET/agent-builder/agentsYour agents.
POST/agent-builder/agentsCreate one.
PUT/agent-builder/agents/{agent_id}Update persona, prompt, model, tools.
POST/agent-builder/agents/{agent_id}/chatChat; streams when the client accepts an event stream, otherwise returns JSON.
POST/agent-builder/agents/{agent_id}/filesUpload a knowledge-base file.
POST/agent-builder/agents/{agent_id}/tasksAdd a scheduled task.
POST/agent-builder/agents/{agent_id}/publishPublish; unpublish is the sibling. Each publish creates a version.

Brain#

Prefix /workspace-memory.

GET/workspace-memoryFacts, optionally filtered by app.
POST/workspace-memoryAdd a fact. Title and scope are derived if omitted.
PATCH/workspace-memory/{memory_id}Edit.
DELETE/workspace-memory/{memory_id}Remove; takes effect for every agent immediately.

Public, unauthenticated#

GET/growth/tracking/for-hostConsent-first tracking configuration for an app's hostname, used by the loader.
GET/growth/tracker.jsThe tracking loader itself.
GET/healthService health.
Last reviewed 21 October 2026Something wrong or missing? Tell us