Update a work location
Updates an existing work location, 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/work-locations/{workLocationReference}
Headers: Authorization: Bearer {token}, User-Agent: {agent}
Scope: connector-protimeapi-work-locations.write
URL parameters
| Parameter | Description |
|---|---|
{workLocationReference} |
The internal ID or external reference of the work location. |
Body properties
| Field | Type | Required | Writable | Description |
|---|---|---|---|---|
name.default |
string | Yes | Yes | Default name of the work location. |
name.translations |
object | No | Yes | Translated names, keyed by ISO language code (for example nl, fr). |
description |
string | No | Yes | Free-text description of the work location. |
External references
The endpoint resolves {workLocationReference} through the externalReferences query parameter. See the external references page for details.
| Collection | Predefined | Custom |
|---|---|---|
work-locations |
Not available | Supported |
Error responses
| Status | Condition |
|---|---|
400 |
Invalid external reference specification, or validation failed (missing name.default, invalid translation key) |
401 |
Missing or invalid access token, or insufficient scope |
404 |
Work location with the given ID or external reference not found |
Success response
200 OK. The response body is empty.
Examples
Update a work location by internal ID
PUT
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/work-locations/12
{
"name": {
"default": "Home office"
},
"description": "Work performed from the employee's registered home address."
}Update a work location by custom external reference
PUT
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/work-locations/WL-HOME?externalReferences=(work-locations,customWorkLocationCode)
{
"name": {
"default": "Home office",
"translations": {
"nl": "Thuiswerk"
}
}
}