Skip to main content
A “run” is one execution of the collector → reasoner → actor pipeline for one app. Runs are recorded in cofounder_runs.

GET — list runs

Query params: Response:

POST — trigger an ad-hoc run

Body: Response (202):
The actual analysis runs asynchronously in Trigger.dev. Poll the GET endpoint until status: "completed".

Errors

  • 422 NOT_CONFIGURED — you haven’t called PUT /preferences yet
  • 503 NOT_CONFIGURED — Trigger.dev integration isn’t configured server-side (system error)
  • 502 TRIGGER_ERROR — Trigger.dev rejected the request (check the body)