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"
}

Documentation Index

Fetch the complete documentation index at: https://developers.projectcor.com/llms.txt

Use this file to discover all available pages before exploring further.

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"
}