Quickstart

OpenWeb AI is a free, open-source AI app builder. Use the public REST API to create projects, send prompts, and poll for results. All endpoints live under /api/v1.

1. Get an API key

Sign up, then go to /settings. Click New key, copy it once, and store it somewhere safe. Keys start with owai_.

2. Create a project + send a prompt

bash
curl -X POST https://your-app.com/api/v1/projects \
  -H "Authorization: Bearer owai_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-first-app",
    "prompt": "A counter app with two buttons and a number in the middle",
    "modelId": "claude-opus-4-7"
  }'

You'll get back a project id and a run id:

json
{ "project": { "id": "...", "name": "my-first-app" }, "runId": "..." }

3. Poll the run for completion

bash
curl https://your-app.com/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer owai_xxxxxxxxxxxx"

When status becomes DONE, the response includes a result object with the live sandboxUrl and the generated files.