List an app's runs, newest first.

GET 
/ai-builder-api/projects/:projectId/runs

Returns the project's runs ordered newest-first by createdAt. The FE calls this when a user reopens a project to rebuild the chat history; pair with listAgentRunEvents per run to replay each prompt's full event log.

Production-backed by Mongo (ai_builder_runs_records). Persists across pod restarts and is shared across pods.

Request

Version stringrequired

The API version.

Available optionsv3

projectId stringrequired

The project's id.

Possible values: Value must match regular expression ^prj_[A-Za-z0-9_-]+$

limit integer

Cap on the number of runs returned. Default 50. Pass 0 to request every run (use sparingly — long-lived projects can accumulate hundreds of follow-up runs).

Possible values: >= 0

Default value:50

application/json

Project runs, newest first.

application/json

Schema

Schema

runsobject[]required

The project's runs, newest first.

Example (auto)

{
  "runs": [
    {
      "runId": "run_7b2c9e41",
      "projectId": "prj_5f0c2a3e",
      "prompt": "Add a class schedule page",
      "status": "ready",
      "createdAt": "2026-10-15T09:40:02.000Z",
      "updatedAt": "2026-10-15T09:41:12.000Z"
    }
  ]
}