API

Build apps from your own code

The web app uses the same API. Errors follow RFC 9457. Machine-readable spec: /v1/openapi.json.

POST	/v1/builds	Queue a build from a prompt (Idempotency-Key supported)
GET	/v1/builds/{id}	Status, metrics, artefact links, repository URL and documentation
GET	/v1/builds/{id}/events	Live trace as Server-Sent Events
POST	/v1/builds/{id}/deliver	Push to your GitHub (browser session)
POST	/v1/builds/{id}/improve	Fix the remaining security alerts and deliver a new verified version
GET	/v1/components	Search the catalog
GET	/v1/components/{id}	Component manifest

curl -X POST https://software.turbineh.com/v1/builds \
  -H "Authorization: Bearer $TURBINEH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"An internal tool to track inventory with CSV import and export"}'

# → 202 {"build_id":"…","events_url":"/v1/builds/…/events"}

curl -N https://software.turbineh.com/v1/builds/$BUILD_ID/events \
  -H "Authorization: Bearer $TURBINEH_API_KEY"