MOmonta
Revenue Share

Update a revenue-share policy

Changed on

Required scope: revenue-share:write. Updating an active policy creates a new version.

patch/api/v1/revenue-share/policies/{code}

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/revenue-share/policies/{code}
  • Auth
    HTTP bearer

Path parameters

codestring required

Request body

namestring nullable

Human-readable name.

descriptionstring nullable

Optional internal description.

policyValuenumber nullable

The share value.

moneyFlow'wallet_live' | 'wallet_monthly' | 'external'
validFromstring date-time nullable

Start of the validity window.

validTostring date-time nullable

End of the validity window.

Response

The updated revenue-share policy

codestring required

Stable code identifying the policy.

namestring required

Human-readable name.

descriptionstring nullable

Optional internal description.

kind'team_to_team' | 'operator_to_team' required
seller'cpo' | 'site_owner' required
policyType'percentage' | 'per_kwh' required
policyValuenumber required

The share value: a percentage of net, or an amount per kWh.

moneyFlow'wallet_live' | 'wallet_monthly' | 'external' required
status'Draft' | 'Active' required
versioninteger

Policy version.

validFromstring date-time nullable

Start of the validity window.

validTostring date-time nullable

End of the validity window.

createdAtstring date-time nullable

Creation timestamp.

updatedAtstring date-time nullable

Last update timestamp.

deletedAtstring date-time nullable

Soft-delete timestamp, null when the policy is not deleted.

Example response

{
  "code": "P-ACME-3",
  "name": "Fleet 85/15",
  "policyValue": 15,
  "version": 1,
  "validFrom": "2026-01-01T00:00:00Z",
  "validTo": "2026-12-31T23:59:59Z"
}

Changes