Update a contract
Updates an existing contract, identified by its internal ID or an external reference.
Tip
Check the Swagger page for more technical information on the endpoints.
Endpoint details
PUT
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/contracts/{contractReference}
Headers: Authorization: Bearer {token}, User-Agent: {agent}
Scope: connector-protimeapi-contracts.write
URL parameters
| Parameter | Description |
|---|---|
{contractReference} |
The internal ID or external reference of the contract. |
Body properties
| Field | Type | Required | Writable | Description |
|---|---|---|---|---|
from |
string | Yes | Yes | Start date of the contract (YYYY-MM-DD). Must be on or after 1900-01-01. |
until |
string | No | Yes | End date of the contract (YYYY-MM-DD). Must be on or after from. |
contractHoursInMinutes |
integer | Yes | Yes | Contracted hours in minutes. Between 1 and 5999. |
fullTimeEquivalentInMinutes |
integer | Yes | Yes | The equivalent in minutes for a full-time contract. Between 1 and 5999. |
The person, code, contract kind, parent contract, number of working days per week and number of days in the contract period are set when the contract is created and cannot be changed through this endpoint.
External references
The endpoint resolves {contractReference} through the externalReferences query parameter. See the external references page for details.
| Collection | Predefined | Custom |
|---|---|---|
contracts |
Not available | Supported |
Error responses
| Status | Condition |
|---|---|
400 |
Invalid external reference specification, or validation failed (missing required fields, value out of range, until before from) |
401 |
Missing or invalid access token, or insufficient scope |
404 |
Contract with the given ID or external reference does not exist |
Success response
200 OK. The response body is empty.
Examples
Update a contract by internal ID
PUT
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/contracts/186
{
"from": "2025-01-01",
"until": "2025-06-30",
"contractHoursInMinutes": 2400,
"fullTimeEquivalentInMinutes": 2400
}Update a contract by custom external reference
PUT
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/contracts/CONTRACT-2025?externalReferences=(contracts,customContractCode)
{
"from": "2025-01-01",
"contractHoursInMinutes": 2280,
"fullTimeEquivalentInMinutes": 2400
}