Skip to main content
PUT
Replace a saved report definition

Authorizations

X-Auth-Token
string
header
required

FlowPayroll JWT (raw token, no Bearer prefix)

X-Org-Id
string
header
required

Organisation to scope the request to. Required when the principal can access more than one organisation; optional for single-organisation principals (the authorizer resolves it automatically).

Path Parameters

id
string
required

Report definition id (ULID)

Body

application/json
name
string
required

Unique per organisation

definition
object
required

The report-definition document — one contract drives sync runs, exports, saved definitions and schedules. See docs/API.md for the full rules.

description
string | null

Response

Updated

definitionId
string
required
name
string
required
definition
object
required

The report-definition document — one contract drives sync runs, exports, saved definitions and schedules. See docs/API.md for the full rules.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
description
string | null