--- title: "Edit the details of an Absence" method: PUT path: "/v2/providers/employers/employees/absences/{absenceId}" tags: ["Absence"] --- # Edit the details of an Absence `PUT /v2/providers/employers/employees/absences/{absenceId}` ## Request - Base URL: `https://api.loket.nl` - URL: `https://api.loket.nl/v2/providers/employers/employees/absences/{absenceId}` - Auth: none required __Activity name :__ PutAbsenceByAbsenceId __Metadata :__ Possible options for fields of the type 'metadata' can be acquired (GET) by adding `/metadata` to the PUT URL. Edit the details of an Absence ## Path parameters - `absenceId` string, uuid, required ## Headers - `Authorization` string, required - `Accept` string, required ## Request body - AbsencePutGetObject - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `causeOfAbsence` CauseOfAbsence: The cause of the absence. This endpoint is intended for the registration of two types of absence: 1) Illness/sickness 2) "Vangnet" such as maternity leave, organ donation or adoption leave Other absences such as Vacation days, unpayed leave and Personal leave are registerd using the leave endpoint - `key` integer: The key of the cause of the absence. Possible values can be acquired via the metadata endpoint - `value` string: Description of the cause of the absence. - `hoursWorkedOnFirstDayOfAbsence` integer, nullable: The number of hours worked on the first day of the absence. - `actionToBeTakenByOccupationalHealthAndSafetyService` ActionToBeTakenByOccupationalHealthAndSafetyService: The desired action to be taken regarding the absence by the occupational health and safety service (arbodienst). - `key` integer: The key of the desired action to be taken by the occupational health and safety service. Possible values can be aquired via the metadata endpoint. - `value` string: Description of the desired action to be taken by the occupational health and safety service. - `expectedDuration` ExpectedDuration, nullable: The expected duration of the absence. If the expected duration is unknown, this field will be NULL. - `key` integer: The key of the expected duration of the absence. Possible values can be acquired via the metadata endpoint. - `value` string: Description of the expected duration of the absence. - `isDisruptedEmploymentRelationship` boolean: Indicates whether the employement relationship between employee and employer is disrupted. - `isThirdPartyLiability` boolean, nullable: This field is related to `accidentType`. When `accidentType` is specified, this field indicates whether a third party is liable for the accident. - `accidentType` AccidentType, nullable: The type of accident that led to the absence. This field will be NULL if the absence is not related to an accident. - `key` integer: The key of the accident type. Possible values can be aquired via the metadata endpoint. - `value` string: Description of the accident type. - `isWorkRelatedIllness` boolean: Beroepsziekte - `expectedDateOfChildbirth` string, date, nullable: Bevallingsdatum - `expectedEndDateOfMaternityLeave` string, date, nullable: verwachte datum einde zwangerschapsverlof - `hasMobilityIssue` boolean, nullable: This field indicates whether the Employee has an issue limiting its mobility. - `isRecoveredWithinTwoWeeks` boolean: This field indicates whether the Employee is (expected) recoverd within two weeks, relating to a full recovery. - `comments` string, nullable: Free text field to register any relevant information. - `isHospitalised` boolean, nullable: Betreft het een ziekenhuisopnamen - `contactInformation` ContactInformation, nullable - `startDate` string, date, required: start date of the contact information - `endDate` string, date, nullable: end date of the contact information - `locationType` object, nullable: soort verpleegadres - `key` integer: The key of the location type. Possible values can be aquired via the metadata endpoint - `value` string: Description of location type - `name` string, nullable: name of the institute for the contact information. - `street` string, required: Streetname of the address - `city` string, required: City of the address - `houseNumber` integer, required: House number of the address - `houseNumberAddition` string, nullable: An addition to further specify the house/door/postbox. For example used to specifty a room of floor number in addition to the house number. - `furtherIndication` object, nullable - `key` integer: The key of the further indication. Possible values can be aquired via the metadata endpoint - `value` string: The description of the further indication, the possible values are "WW" and "AB" - `postalCode` string, required: The postal code of the address - `country` object, required - `key` integer: The key for the country. Possible values can be aquired via the metadata endpoint - `value` string: The name of the country - `isoCode` string: The ISO 3166-1 alpha-2 value for the country - `phoneNumber` string, nullable: The phone number to contact the employee on. - `caseManager` CaseManager, nullable - `name` string: Name of the case manager for reintegration. - `function` string, nullable: Function of the case manager. - `organization` string, nullable: Function of the case manager. - `phoneNumber` string, nullable: The phone number of the employee. - `reintegration` Reintegration, nullable - `reintegrationGoal` object - `key` integer: The key for the reintegration goal. Related to the Wet Verbetering Poortwachter. - `value` string: The name of the country - `dateOfFinalizingPlanOfAction` string, date: The day on which a plan of action (for return to normal work) was finalized. - `progress` object - `startDate` string, date: start dat of the incapacityPercentage - `endOfAbsence` object, nullable: date and reason for the closing/end of the absence - `date` string, date, nullable: The last day of the absence. - `reason` object: redenhersteld - `key` integer: The key of the reason why the absence is ended. Possible values can be aquired via the metadata endpoint. - `value` string: Description of the reason why the absence ended. - `currentIncapacityPercentage` integer: percentage of not being able to work ## Response `200` OK - object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour. - `version` Version - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available - `resourceVersion` string, date: The resource version of the object in the response - `messages` object[] - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages) - `description` string: Describes the message - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity - `code` integer: Identifying code for the message - `properties` string[]: An array that can contain additional information - `content` AbsencePutGetObject - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `causeOfAbsence` CauseOfAbsence: The cause of the absence. This endpoint is intended for the registration of two types of absence: 1) Illness/sickness 2) "Vangnet" such as maternity leave, organ donation or adoption leave Other absences such as Vacation days, unpayed leave and Personal leave are registerd using the leave endpoint - `key` integer: The key of the cause of the absence. Possible values can be acquired via the metadata endpoint - `value` string: Description of the cause of the absence. - `hoursWorkedOnFirstDayOfAbsence` integer, nullable: The number of hours worked on the first day of the absence. - `actionToBeTakenByOccupationalHealthAndSafetyService` ActionToBeTakenByOccupationalHealthAndSafetyService: The desired action to be taken regarding the absence by the occupational health and safety service (arbodienst). - `key` integer: The key of the desired action to be taken by the occupational health and safety service. Possible values can be aquired via the metadata endpoint. - `value` string: Description of the desired action to be taken by the occupational health and safety service. - `expectedDuration` ExpectedDuration, nullable: The expected duration of the absence. If the expected duration is unknown, this field will be NULL. - `key` integer: The key of the expected duration of the absence. Possible values can be acquired via the metadata endpoint. - `value` string: Description of the expected duration of the absence. - `isDisruptedEmploymentRelationship` boolean: Indicates whether the employement relationship between employee and employer is disrupted. - `isThirdPartyLiability` boolean, nullable: This field is related to `accidentType`. When `accidentType` is specified, this field indicates whether a third party is liable for the accident. - `accidentType` AccidentType, nullable: The type of accident that led to the absence. This field will be NULL if the absence is not related to an accident. - `key` integer: The key of the accident type. Possible values can be aquired via the metadata endpoint. - `value` string: Description of the accident type. - `isWorkRelatedIllness` boolean: Beroepsziekte - `expectedDateOfChildbirth` string, date, nullable: Bevallingsdatum - `expectedEndDateOfMaternityLeave` string, date, nullable: verwachte datum einde zwangerschapsverlof - `hasMobilityIssue` boolean, nullable: This field indicates whether the Employee has an issue limiting its mobility. - `isRecoveredWithinTwoWeeks` boolean: This field indicates whether the Employee is (expected) recoverd within two weeks, relating to a full recovery. - `comments` string, nullable: Free text field to register any relevant information. - `isHospitalised` boolean, nullable: Betreft het een ziekenhuisopnamen - `contactInformation` ContactInformation, nullable - `startDate` string, date, required: start date of the contact information - `endDate` string, date, nullable: end date of the contact information - `locationType` object, nullable: soort verpleegadres - `key` integer: The key of the location type. Possible values can be aquired via the metadata endpoint - `value` string: Description of location type - `name` string, nullable: name of the institute for the contact information. - `street` string, required: Streetname of the address - `city` string, required: City of the address - `houseNumber` integer, required: House number of the address - `houseNumberAddition` string, nullable: An addition to further specify the house/door/postbox. For example used to specifty a room of floor number in addition to the house number. - `furtherIndication` object, nullable - `key` integer: The key of the further indication. Possible values can be aquired via the metadata endpoint - `value` string: The description of the further indication, the possible values are "WW" and "AB" - `postalCode` string, required: The postal code of the address - `country` object, required - `key` integer: The key for the country. Possible values can be aquired via the metadata endpoint - `value` string: The name of the country - `isoCode` string: The ISO 3166-1 alpha-2 value for the country - `phoneNumber` string, nullable: The phone number to contact the employee on. - `caseManager` CaseManager, nullable - `name` string: Name of the case manager for reintegration. - `function` string, nullable: Function of the case manager. - `organization` string, nullable: Function of the case manager. - `phoneNumber` string, nullable: The phone number of the employee. - `reintegration` Reintegration, nullable - `reintegrationGoal` object - `key` integer: The key for the reintegration goal. Related to the Wet Verbetering Poortwachter. - `value` string: The name of the country - `dateOfFinalizingPlanOfAction` string, date: The day on which a plan of action (for return to normal work) was finalized. - `progress` object - `startDate` string, date: start dat of the incapacityPercentage - `endOfAbsence` object, nullable: date and reason for the closing/end of the absence - `date` string, date, nullable: The last day of the absence. - `reason` object: redenhersteld - `key` integer: The key of the reason why the absence is ended. Possible values can be aquired via the metadata endpoint. - `value` string: Description of the reason why the absence ended. - `currentIncapacityPercentage` integer: percentage of not being able to work ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `409`: Conflict - `500`: Internal Server Error --- [API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)