Docs

Build on the AARGON API

Every screen in the app is backed by a plain REST endpoint.

Base URL: http://127.0.0.1:8000. In the snippets below, $API is that URL and $TOKEN is the JWT returned by login. Admin routes use an X-Admin-Token header instead.

Auth

bash

curl -X POST $API/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"company":"Acme","email":"you@acme.com","password":"min-8-chars"}'

curl $API/api/v1/auth/me -H "Authorization: Bearer $TOKEN"

Discovery

Create projects, answer the 18-domain questionnaire, generate the PRD, set the theme and manage the scope lock.

bash

curl $API/api/v1/discovery/domains -H "Authorization: Bearer $TOKEN"

curl -X POST $API/api/v1/discovery/projects \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"Bakery app"}'

curl -X POST "$API/api/v1/discovery/projects/$ID/generate-prd?provider=openai" \
  -H "Authorization: Bearer $TOKEN"

Ingest

Extract business fields from a document and brand colours from a logo.

bash

curl -X POST $API/api/v1/ingest/document \
  -H "Authorization: Bearer $TOKEN" \
  -F project_id=$ID -F file=@brief.pdf

Vault

Semantic search over the local template vault.

bash

curl -X POST $API/api/v1/vector/search \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"query":"stripe checkout","top_k":5}'

Patch

Upload a codebase zip with instructions, then poll the job for a per-file diff.

bash

curl -X POST $API/api/v1/patch/update-codebase \
  -H "Authorization: Bearer $TOKEN" \
  -F project_name=my-app -F edit_instructions="Add rate limiting" \
  -F codebase_zip=@code.zip

curl $API/api/v1/patch/jobs/$JOB_ID -H "Authorization: Bearer $TOKEN"

Builds

Start a build for chosen targets, poll its stages, then download the artifacts.

bash

curl -X POST $API/api/v1/projects/$ID/builds \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"provider":"openai","targets":["web","android"]}'

curl $API/api/v1/builds/$BUILD_ID -H "Authorization: Bearer $TOKEN"
curl -OJ $API/api/v1/builds/$BUILD_ID/download -H "Authorization: Bearer $TOKEN"

Billing

List plans, read your usage and switch plan.

bash

curl $API/api/v1/billing/plans
curl $API/api/v1/billing/me -H "Authorization: Bearer $TOKEN"
curl -X POST $API/api/v1/billing/subscribe \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"plan":"pro"}'

Interactive API reference

The backend serves live OpenAPI docs you can try in the browser.

http://127.0.0.1:8000/docs