Skip to main content

Create Report For Run

POST 
/reports/:run_id

Validate answers, persist a report, and enqueue its generation job.

run_id is the completed source evaluation run; the body carries the answers (typed + extra="forbid", so unknown or missing required keys are rejected with 422 before this handler runs) and the sections to include. Returns 404 if the run does not exist and 409 if it has not yet completed.

report_config_id names the report config to generate against, resolved against the workspaces the caller can see — an id they may not read 404s rather than silently generating the platform's own format. Omitting it is that format. selected_indicators narrows that config's catalogue; an indicator the config does not describe, or one the run cannot measure, is a 422.

The response carries content_url — a presigned URL to the report's content.json. Generation is async, so the object is not there yet: the URL 404s until status flips to completed, then serves the content.

Request​

Responses​

Successful Response