Skip to main content
POST
Create a report draft

Description

Create report Composes a fresh dataSnapshot/dataHash for (tenantUserId, periodStart..periodEnd) and persists it as a draft Report. periodEnd must not be before periodStart; the payee (tenantUserId) must exist in the workspace. Authorization:
  • Required role: admin or higher

Code Examples

Authorizations

Authorization
string
header
required

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

Body

application/json
tenantUserId
string<uuid>
required

The payee this report is for.

periodStart
string<date>
required
periodEnd
string<date>
required

Response

Report created as a draft.

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

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