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.