Skip to main content
POST
Finalize a report

Description

Finalize report Transitions the report from draft to finalized, stamping finalizedAt/finalizedByUserId. Once finalized, the data snapshot and narrative are immutable — every subsequent mutation (narrative PATCH, refresh-data, a repeat finalize) is rejected with 409 Conflict. Authorization:
  • Required role: admin or higher

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string<uuid>
required

Response

Report finalized — data and narrative are now immutable.

Every /reports JSON response wraps its payload in { status, message, data }.

status
enum<string>
Available options:
success,
error
message
string
data
object