Skip to main content
PUT
/
v2
/
integrations
/
contracts
/
{id}
curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/contracts/SF-CONTRACT-12345' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "SALESFORCE"
  },
  "status": "completed",
  "end_date": "2025-06-30",
  "value": 60000
}'

{
  "id": 30001,
  "name": "Annual Service Agreement",
  "client_id": 25855,
  "type": "retainer",
  "status": "completed",
  "start_date": "2025-01-01",
  "end_date": "2025-06-30",
  "value": 60000,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}
Updates an existing contract in your COR instance using its external ID. Performs the same validations as creation, including date validation in YYYY-MM-DD format, and updates only the provided fields. The currency ISO sent in the request must have a previously configured currency exchange in COR. If no exchange rate exists from the contract currency to the company base currency, contract update is rejected with status: 400, name: CORCustomError, and code: CTR006.

​
Path Parameters

​
id
string
required
External contract ID that was used when creating the contract

​
Request Body Requirements

​
metadata
object
required
​
name
string
Updated contract name
​
type
string
Updated contract type
​
status
string
Updated contract status
​
start_date
string
Updated start date in YYYY-MM-DD format
​
end_date
string
Updated end date in YYYY-MM-DD format
​
value
number
Updated contract value
​
description
string
Updated description

​
Known Errors

  • ZC001 — Entity is not associated (contract with the specified external ID not found)
  • ContractNotFoundError — No contract found with the specified external ID
  • ValidationError — Missing required metadata.source field
  • ValidationError — Invalid start date format: <value> when start_date is not a valid YYYY-MM-DD date
  • ValidationError — Invalid end date format: <value> when end_date is not a valid YYYY-MM-DD date
  • CTR006 (CORCustomError, 400) — Cannot save contract. Exchange rate not found for ${currency} to ${baseCurrency}. Please sync exchange rates first.
curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/contracts/SF-CONTRACT-12345' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "SALESFORCE"
  },
  "status": "completed",
  "end_date": "2025-06-30",
  "value": 60000
}'

{
  "id": 30001,
  "name": "Annual Service Agreement",
  "client_id": 25855,
  "type": "retainer",
  "status": "completed",
  "start_date": "2025-01-01",
  "end_date": "2025-06-30",
  "value": 60000,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}