Contracts

Update contract

Updates an existing contract.<br/><br/>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.<br/><br/>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.<br/><br/>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.<br/><br/>

<p><ul><li>Rate limit: 400 requests per minute</li></ul></p>
put/contracts/{idContract}

Request

  • Base URL
    https://api.toriihq.com/v1.0
  • Auth
    API key in header Authorization

Path parameters

idContractinteger required

Unique contract identifier

Request body

idAppinteger

Unique app identifier

amountinteger
startDatestring date-time

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

endDatestring date-time

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

Example request

{
  "idApp": 1000,
  "startDate": "2022-02-03",
  "endDate": "2022-02-03"
}

Response

Update contract

Example response

{
  "contract": {
    "id": 1000,
    "name": "Salesforce contract",
    "status": "pipeline"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.