Create a report

POST 
/api/v1/reports

Create a report and enqueue async PDF generation.

The endpoint validates the target assessment (must be completed and org-scoped), inserts a generating report document, and enqueues the background task queue generate_report_task. Poll GET /reports/{id} for completion (status becomes ready).

• Scope required: reports:generate.
• Rate-limit tier: report_generate (20/hour/user).
• Accepts assessment code/public_id (e.g. AIS-ADB-TLP).
• Not idempotent — each call inserts a new report.

Request

Responses

201

Successful Response

400

Bad request — malformed input or failed validation.

401

Missing, expired, or invalid credentials.

403

Authenticated but not authorized for this resource. Note: cross-organization reads return 404, not 403.

404

Resource not found, or hidden for tenant-enumeration safety (the caller lacks permission to know whether the resource exists).

409

Conflict — the current resource state does not allow this operation (e.g. assessment already started, email already in use).

422

Semantic validation failure — request shape was valid but contents were not.

429

Too many requests — rate limited. Retry after the window resets.

500

Internal server error — unexpected failure.