Update contract

Updates an existing contract.

Fields an admin marked as required in Torii cannot be cleared: sending one empty fails with 400 and lists it in data.missingMandatoryFields. Fields you leave out are not checked.

Currency fields (e.g., amount) can be numbers ("amount": 1500, uses org default currency) or objects to set a different currency: "amount": { "value": 23000000, "currency": "EUR" }. Cannot set currency as a top-level field.

Optional lineItems are appended to the contract's existing line items (each needs a description; the same optional value fields as on create). Items cannot carry an id (400), existing items are never modified or removed here, and omitting lineItems leaves them unchanged. Removing a line item is done in the Torii web app. Read them back with GET /contracts/{idContract}?fields=lineItems.

  • Rate limit: 400 requests per minute

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
≥ 1

Unique contract identifier

Body Params

Update contract

integer
1 to 2147483647

Unique app identifier

integer | CurrencyValue

Contract value. A plain integer uses the org default currency (e.g. 1500); pass { "value": 23000000, "currency": "EUR" } to set a different one

date-time | null

Contract start date, in ISO 8601 format (e.g. "2022-02-03")

date-time | null

Contract end date, in ISO 8601 format (e.g. "2022-02-03")

lineItems
array of objects
length ≤ 100

Products / SKUs to append to the contract's line items; existing items are untouched

lineItems
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json