---
title: "Update commitment"
method: PATCH
path: "/v3/commitments/{commitmentId}"
tags: ["Commitments"]
---

# Update commitment

`PATCH /v3/commitments/{commitmentId}`

## Path parameters

- `commitmentId` string, required

## Request body

- UpdateUsageCommitmentV3RequestDto
  - `commitmentValue` number — The commitment amount value
  - `commitmentStartDate` string — Commitment start date (YYYY-MM-DD)
  - `commitmentEndDate` string — Commitment end date, inclusive (YYYY-MM-DD)
  - `isFullDuration` boolean — Whether commitment lasts the full duration
  - `commitmentInterval` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY' — Commitment period interval
  - `billingTermsToAdd` string[] — 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.

## Response `200`

Commitment updated

- IntegratorsApiResponse
  - `payload` object, required — Response payload, will be empty when success is false
  - `success` boolean, required — Boolean with true=success, false=failure
  - `message` string, required — Plain-text description of the result
  - `error` IntegratorsApiError, required
    - `code` number, required — API response code
    - `message` string, required — API response message
    - `details` object — Additional details about the error

## Other responses

- `400` — Validation error or locked
- `404` — Commitment not found

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/revisions/7e8885517814/schema)