v1

latestOpenAPI 3.0.02026-07-24102143224.1 KB

Commitments

Update commitment

patch/v3/commitments/{commitmentId}

Path parameters

commitmentIdstring required

Commitment ID

Request body

commitmentValuenumber

The commitment amount value

commitmentStartDatestring

Commitment start date (YYYY-MM-DD)

commitmentEndDatestring

Commitment end date, inclusive (YYYY-MM-DD)

isFullDurationboolean

Whether commitment lasts the full duration

commitmentInterval'DAILY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY'

Commitment period interval

billingTermsToAddstring[]

Billing term IDs to add to the commitment

pricePriority'LOW' | 'HIGH'

Price priority when multiple products are selected

trueUpBehavior'DEFAULT' | 'NEVER'

True-up behavior for the commitment (commitments-v2). DEFAULT trues up unmet commitment; NEVER suppresses it.

Example request

{
  "commitmentValue": 1000,
  "commitmentStartDate": "2025-01-01",
  "commitmentEndDate": "2025-12-31",
  "isFullDuration": true,
  "commitmentInterval": "MONTHLY",
  "pricePriority": "LOW"
}

Response

Commitment updated

payloadobject required

Response payload, will be empty when success is false

successboolean required

Boolean with true=success, false=failure

messagestring required

Plain-text description of the result