Skip to main content
PUT
/
v2
/
integrations
/
contracts
/
{id}
/
detach
curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/contracts/SF-CONTRACT-12345/detach' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "SALESFORCE"
  },
  "users": [
    "OKTA-USER-67890"
  ]
}'

{
  "id": 23,
  "client_id": 58393,
  "company_id": 2336,
  "name": "Prueba contrato",
  "type": "fixed_price",
  "source": "SALESFORCE",
  "status": "active",
  "url": null,
  "start": "2026-01-01 00:00:00",
  "end": "2026-12-31 00:00:00",
  "frequency": null,
  "currency_id": 1,
  "created_at": "2026-05-08 13:58:38",
  "updated_at": "2026-05-08 13:58:38",
  "deleted_at": null,
  "url_name": null,
  "user_positions_header_id": null,
  "users": []
}
Removes one or more users from an existing contract. Validates that users are currently attached to the contract before detaching them. On success (200), the response body is the updated contract resource.

​
Path Parameters

​
id
string
required
External contract ID

​
Request Body Requirements

​
metadata
object
required
​
users
array
required
Array of external user IDs to detach from the contract

​
Known Errors

  • ContractNotFoundError — No contract found with the specified external ID
  • UserNotFoundError — One or more users not found with the specified external IDs
  • ValidationError — Missing required fields or empty users array
  • NotAttachedError — One or more users are not attached to this contract
curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/contracts/SF-CONTRACT-12345/detach' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "SALESFORCE"
  },
  "users": [
    "OKTA-USER-67890"
  ]
}'

{
  "id": 23,
  "client_id": 58393,
  "company_id": 2336,
  "name": "Prueba contrato",
  "type": "fixed_price",
  "source": "SALESFORCE",
  "status": "active",
  "url": null,
  "start": "2026-01-01 00:00:00",
  "end": "2026-12-31 00:00:00",
  "frequency": null,
  "currency_id": 1,
  "created_at": "2026-05-08 13:58:38",
  "updated_at": "2026-05-08 13:58:38",
  "deleted_at": null,
  "url_name": null,
  "user_positions_header_id": null,
  "users": []
}