Plans

Update a plan

Update plan details like name, description, features, or billing interval.

patch/api/plans/{id}

Path parameters

idstring required

Plan ID

Request body

namestring

descriptionstring

billingTiming'IN_ADVANCE' | 'IN_ARREARS'

When to charge: IN_ADVANCE or IN_ARREARS

featuresstring[]

isActiveboolean

netPaymentTermsnumber

Net payment terms in days

invoiceGracePeriodDaysnumber

Grace period in days before draft invoices are finalized

progressiveBillingThresholdnumber

Usage cost threshold for progressive billing

Example request

{
  "netPaymentTerms": 30,
  "invoiceGracePeriodDays": 3,
  "progressiveBillingThreshold": 1000
}

Response

Plan updated

idstring required

namestring required

codestring required

descriptionstring

featuresstring[]

isActiveboolean required

billingTiming'IN_ADVANCE' | 'IN_ARREARS' required

minimumCommitmentstring

Minimum commitment amount

createdAtstring required

updatedAtstring required

Example response

{
  "id": "clx1234567890",
  "name": "Premium Monthly",
  "code": "premium_monthly",
  "description": "Premium plan with all features",
  "billingInterval": "MONTHLY",
  "features": [
    "Unlimited users",
    "Priority support"
  ],
  "isActive": true,
  "billingTiming": "IN_ARREARS",
  "minimumCommitment": "100.0000",
  "prices": [
    {
      "id": "clx1234567890",
      "planId": "clxplan123",
      "currency": "USD",
      "amount": "49.9900",
      "isActive": true
    }
  ]
}

Changes

Changed in 1 of the 2 revisions of this API.8

Feb 16, 20260e449a4e0dc88See the full diff
- ○
  added the new optional request property billingTiming
  new-optional-request-property
- ○
  added the new optional request property invoiceGracePeriodDays
  new-optional-request-property
- ○
  added the new optional request property netPaymentTerms
  new-optional-request-property
- ○
  added the new optional request property progressiveBillingThreshold
  new-optional-request-property
- ○
  added the new DAILY enum value to the request property billingInterval
  request-property-enum-value-added
- ○
  added the new HOURLY enum value to the request property billingInterval
  request-property-enum-value-added
- ○
  added the new WEEKLY enum value to the request property billingInterval
  request-property-enum-value-added
- ○
  added the media type application/json for the response with the status 200
  response-media-type-added

Full history