--- title: "Edit the details of a concept employee with fewer fields." method: PUT path: "/v2/providers/employers/conceptemployees/minimized/{conceptEmployeeId}" tags: ["Concept employee"] --- # Edit the details of a concept employee with fewer fields. `PUT /v2/providers/employers/conceptemployees/minimized/{conceptEmployeeId}` ## Request - Base URL: `https://api.loket.nl` - URL: `https://api.loket.nl/v2/providers/employers/conceptemployees/minimized/{conceptEmployeeId}` - Auth: none required __Activity name :__ PutConceptEmployeeMinimizedByConceptEmployeeId Edit the details of a concept employee with fewer fields. * Possible options (metadata) for generic fields of the type "metadata" can be acquired (GET) by adding `/metadata` to the URL. ## Path parameters - `conceptEmployeeId` string, uuid, required ## Headers - `Authorization` string, required - `Accept` string, required ## Request body - ConceptEmployeeMinimized - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `personalDetails` object: The personal details of the employee. e.g. Name, civil status en gender - `firstName` string, nullable: The first name of the employee. - `lastName` string: The last name of the employee. - `prefix` string, nullable: The prefix to the last name of the employee. - `initials` string, nullable: The initials of the employee. - `formattedName` string, nullable: Formatted name of the employee based on the value of `howToFormatLastName` - `lastNamePartner` string, nullable: The last name of the employee`s partner. - `prefixPartner` string, nullable: The prefix to the last name of the employee"s partner. - `dateOfBirth` string, date, nullable: The date of birth of the employee. - `placeOfBirth` string, nullable: Place of birth of the employee - `howToFormatLastName` object, nullable: Indicates how the system will format `formattedName`. - `key` integer - `value` string - `title` object, nullable: The title to be used (if any). - `key` integer - `value` string - `gender` object, nullable: The gender of the employee - `key` integer - `value` string - `nationality` object, nullable: The nationality of the employee - `key` integer - `value` string - `civilStatus` object, nullable: The civil status of the employee - `key` integer - `value` string - `contactInformation` object, nullable: Contact information for the employee - `phoneNumber` string, nullable: The phone number of the employee. - `mobilePhoneNumber` string, nullable: The mobile phone number of the employee. - `faxNumber` string, nullable: The fax number to contact this individual - `emailAddress` string, nullable: The e-mail address of the employee. - `identityDocument` object, nullable: The identification document of the employee - `typeOfDocument` object, nullable - `key` integer: The key for the type of document. Possible values can be acquired via the metadata endpoint - `value` string: Description of the type of document - `documentIdentification` string, nullable: Description of the type of document - `address` object, nullable: The address of the employee - `street` string, nullable: Streetname of the address - `city` string, nullable: City of the address - `houseNumber` integer, nullable: 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: Futher indication of the address for example onboard (a ship) or living in a trailer - `key` integer - `value` string - `postalCode` string, nullable: The postal code of the address - `location` string, nullable: The location like to further specify the address - `country` object, nullable: The country of residence of the employee - `key` integer - `value` string - `isoCode` string - `iban` string, nullable: International Bank Account Number. Only IBAN without spaces are accepted. - `applyPayrollTaxDeduction` boolean: Indicates whether payroll tax deduction is appliclable (loonheffingskorting) ## 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` ConceptEmployeeMinimized - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `personalDetails` object: The personal details of the employee. e.g. Name, civil status en gender - `firstName` string, nullable: The first name of the employee. - `lastName` string: The last name of the employee. - `prefix` string, nullable: The prefix to the last name of the employee. - `initials` string, nullable: The initials of the employee. - `formattedName` string, nullable: Formatted name of the employee based on the value of `howToFormatLastName` - `lastNamePartner` string, nullable: The last name of the employee`s partner. - `prefixPartner` string, nullable: The prefix to the last name of the employee"s partner. - `dateOfBirth` string, date, nullable: The date of birth of the employee. - `placeOfBirth` string, nullable: Place of birth of the employee - `howToFormatLastName` object, nullable: Indicates how the system will format `formattedName`. - `key` integer - `value` string - `title` object, nullable: The title to be used (if any). - `key` integer - `value` string - `gender` object, nullable: The gender of the employee - `key` integer - `value` string - `nationality` object, nullable: The nationality of the employee - `key` integer - `value` string - `civilStatus` object, nullable: The civil status of the employee - `key` integer - `value` string - `contactInformation` object, nullable: Contact information for the employee - `phoneNumber` string, nullable: The phone number of the employee. - `mobilePhoneNumber` string, nullable: The mobile phone number of the employee. - `faxNumber` string, nullable: The fax number to contact this individual - `emailAddress` string, nullable: The e-mail address of the employee. - `identityDocument` object, nullable: The identification document of the employee - `typeOfDocument` object, nullable - `key` integer: The key for the type of document. Possible values can be acquired via the metadata endpoint - `value` string: Description of the type of document - `documentIdentification` string, nullable: Description of the type of document - `address` object, nullable: The address of the employee - `street` string, nullable: Streetname of the address - `city` string, nullable: City of the address - `houseNumber` integer, nullable: 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: Futher indication of the address for example onboard (a ship) or living in a trailer - `key` integer - `value` string - `postalCode` string, nullable: The postal code of the address - `location` string, nullable: The location like to further specify the address - `country` object, nullable: The country of residence of the employee - `key` integer - `value` string - `isoCode` string - `iban` string, nullable: International Bank Account Number. Only IBAN without spaces are accepted. - `applyPayrollTaxDeduction` boolean: Indicates whether payroll tax deduction is appliclable (loonheffingskorting) ## 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)