Change the applicant's data (managers of the posting)
PATCH /api/hr/v1/recruiting/applications/{id}
Module: HR · operationId: updateApplication · Tag: Recruiting · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Request body
application/json (required)
answers(object): Answers to the form questions by question key (omitted: unchanged)coverLetter(string): New cover letter (omitted: unchanged)email(string (email)): New e-mail address (omitted: unchanged)firstName(string): New first name (omitted: unchanged)lastName(string): New last name (omitted: unchanged)phone(string): New phone number (omitted: unchanged)version(integer): Version of the application the change is based on
Example:
{
"answers": {
"gehaltsvorstellung": 54000
},
"phone": "+49 170 55501033",
"version": 5
}
Responses
- 200 Saved (
application/json) - 400 Error (
application/json) - 403 Error (
application/json) - 404 Error (
application/json) - 409 Error (
application/json)
Fields of the 200 answer:
answers(object): Answers to the form questions by question keycloseReason(string): Reason given when it was closedclosedAt(string (date-time)): When it was rejected, withdrawn or hiredconsentAt(string (date-time)): When the applicant gave the consentconsentVersion(integer): Version of the consent text the applicant accepted (0: none)coverLetter(string): Cover letter textcreatedAt(string (date-time)): When the application was createddeleteAfter(string (date-time)): When the application is deletedemail(string): Applicant's e-mail addressemployeeId(string (uuid)): The employee created from it (hired)files(array of ApplicationFile): Files of the application (single reads)contentType(string): Media type of the filecreatedAt(string (date-time)): When the file was addeddocumentId(string): Id of the document in DMSfieldKey(string): Key of the form question the file answers (role answer)fileName(string): File nameid(string (uuid)): Id of the filerole(string): What the file is (CV, attachment, answer to a file question, mail attachment) (one ofcv,attachment,answer,mail)scanStatus(string): Result of the malware scan; content is served only when CLEAN (one ofPENDING,CLEAN,INFECTED,SKIPPED,FAILED)sizeBytes(integer (int64)): Size in bytes
firstName(string): Applicant's first nameid(string (uuid)): Id of the applicationlastName(string): Applicant's last namenextInterview(string (date-time)): Start of the next interview, if anynumber(integer): Number of the application, unique in the tenantphase(string): Phase of the current stage (one ofnew,active,hired,rejected,withdrawn)phone(string): Applicant's phone numberpostingId(string (uuid)): Id of the posting applied topostingTitle(string): Title of the postingrating(object): Summary of the reviewers' ratingsaverage(number): Average score (1–5)count(integer): Number of ratingsmine(integer): The caller's score (0 not rated)
role(string): The caller's role on the posting (one ofviewer,reviewer,manager)source(string): How the application arrived (one ofmanual,portal,api)stageChangedAt(string (date-time)): When the application entered its current stagestageId(string (uuid)): Id of the current pipeline stagetalentPoolUntil(string (date-time)): Kept in the talent pool until then (applicant agreed)updatedAt(string (date-time)): When the application was last changedversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
Example 200 answer:
{
"answers": {
"fruehester_start": "2027-01-01",
"gehaltsvorstellung": 52000,
"powershell": "grundlagen"
},
"consentAt": "2026-11-02T18:43:00Z",
"consentVersion": 2,
"coverLetter": "Ich bin Fachinformatiker für Systemintegration und möchte mich nach vier Jahren im Rechenzentrum stärker auf Cloud-Arbeitsplätze spezialisieren.",
"createdAt": "2026-11-02T18:43:00Z",
"deleteAfter": "2027-11-02T18:43:00Z",
"email": "stefan.lindner@mail.example",
"files": [
{
"contentType": "application/pdf",
"createdAt": "2026-11-02T18:41:00Z",
"documentId": "5c7e9a1c-3e5a-4c7e-9a9c-3e5a7c9e1a95",
"fileName": "lebenslauf-stefan-lindner.pdf",
"id": "3a5c7e9a-1c3e-4a5c-8e7a-1c3e5a7c9e94",
"role": "cv",
"scanStatus": "CLEAN",
"sizeBytes": 248311
}
],
"firstName": "Stefan",
"id": "1c3e5a7c-9e1a-4c3e-9a5c-9e1a3c5e7a89",
"lastName": "Lindner",
"nextInterview": "2026-11-24T09:00:00Z",
"number": 3,
"phase": "active",
"phone": "+49 170 55501003",
"postingId": "4a6c8e0a-2c4e-4a6c-9e0a-2c4e6a8c0e81",
"postingTitle": "Systemadministrator:in (m/w/d) Microsoft 365",
"rating": {
"average": 3.5,
"count": 2,
"mine": 3
},
"role": "manager",
"source": "portal",
"stageChangedAt": "2026-11-12T10:30:00Z",
"stageId": "0a2c4e6a-8c0e-4a2c-8e6a-8c0e2a4c6e84",
"updatedAt": "2026-11-12T10:30:00Z",
"version": 5
}
Example request
curl -X PATCH 'https://api.mbcom.cloud/api/hr/v1/recruiting/applications/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"answers":{"gehaltsvorstellung":54000},"phone":"+49 170 55501033","version":5}'