Skip to main content
POST
Update a custom report

Authorizations

Authorization
string
header
required

Supabase JWT — Authorization: Bearer <token>.

Body

application/json
id
string<uuid>
required

Report id (from list_reports).

version
integer
required

The version you read (get_report / list_reports). A stale version is refused with 409.

Required range: x >= 1
definition
object
required

The whole new definition (it replaces the old one).

Example:
merchant_id
string<uuid>

Optional merchant to act on. Admins and sub-merchant operators only; other callers always use their token's merchant.

target
enum<string>

published (default) or draft. A private report always publishes. Through the MCP server a shared report always gets a draft that its owner publishes in the admin.

Available options:
published,
draft

Response

Report saved.

id
string<uuid>
required
version
integer
required

Send it back with the next update.

published
boolean
required

false when the change was stored as a draft the owner publishes in the admin.

admin_url
string
required

Open the report in the JobMojito admin.

{key}
unknown