Update a sector
Updates an existing sector, 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/sectors/{sectorReference}
Headers: Authorization: Bearer {token}, User-Agent: {agent}
Scope: connector-protimeapi-sectors.write
URL parameters
| Parameter | Description |
|---|---|
{sectorReference} |
The internal ID or external reference of the sector. |
Body properties
| Field | Type | Required | Writable | Description |
|---|---|---|---|---|
name.default |
string | Yes | Yes | Default name of the sector. |
name.translations |
object | No | Yes | Translated names, keyed by ISO language code (for example nl, fr). |
External references
The endpoint resolves {sectorReference} through the externalReferences query parameter. See the external references page for details.
| Collection | Predefined | Custom |
|---|---|---|
sectors |
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 |
Sector with the given ID or external reference not found |
Success response
200 OK. The response body is empty.
Examples
Update a sector by internal ID
PUT
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/sectors/41
{
"name": {
"default": "Logistics and warehousing"
}
}Update a sector by custom external reference
PUT
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/sectors/SEC-05?externalReferences=(sectors,customSectorCode)
{
"name": {
"default": "Logistics and warehousing",
"translations": {
"nl": "Logistiek en magazijn"
}
}
}