ConnectCloud Developers

Record that the applicant withdrew (managers of the posting)

POST /api/hr/v1/recruiting/applications/{id}/withdraw

Module: HR · operationId: withdrawApplication · Tag: Recruiting · Auth: access token (Authorization: Bearer <accessToken>)

Parameters

Name In Type Required Description
id path string (uuid) yes

Request body

application/json (required)

  • mail (ApplicantMail)
    • body (string, required): Markdown (max length 50000)
    • subject (string, required): Subject of the mail (max length 300)
  • reason (string): Internal reason (max length 2000)
  • stageId (string (uuid)): A stage of the phase (default the first)
  • version (integer): Version of the application the change is based on

Example:

{
  "reason": "Hat telefonisch abgesagt – Stelle beim bisherigen Arbeitgeber angenommen.",
  "stageId": "8c0e2a4c-6e8a-4c0e-8a4c-6e8a0c2e4a88",
  "version": 4
}

Responses

  • 200 The application (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 key
  • closeReason (string): Reason given when it was closed
  • closedAt (string (date-time)): When it was rejected, withdrawn or hired
  • consentAt (string (date-time)): When the applicant gave the consent
  • consentVersion (integer): Version of the consent text the applicant accepted (0: none)
  • coverLetter (string): Cover letter text
  • createdAt (string (date-time)): When the application was created
  • deleteAfter (string (date-time)): When the application is deleted
  • email (string): Applicant's e-mail address
  • employeeId (string (uuid)): The employee created from it (hired)
  • files (array of ApplicationFile): Files of the application (single reads)
    • contentType (string): Media type of the file
    • createdAt (string (date-time)): When the file was added
    • documentId (string): Id of the document in DMS
    • fieldKey (string): Key of the form question the file answers (role answer)
    • fileName (string): File name
    • id (string (uuid)): Id of the file
    • role (string): What the file is (CV, attachment, answer to a file question, mail attachment) (one of cv, attachment, answer, mail)
    • scanStatus (string): Result of the malware scan; content is served only when CLEAN (one of PENDING, CLEAN, INFECTED, SKIPPED, FAILED)
    • sizeBytes (integer (int64)): Size in bytes
  • firstName (string): Applicant's first name
  • id (string (uuid)): Id of the application
  • lastName (string): Applicant's last name
  • nextInterview (string (date-time)): Start of the next interview, if any
  • number (integer): Number of the application, unique in the tenant
  • phase (string): Phase of the current stage (one of new, active, hired, rejected, withdrawn)
  • phone (string): Applicant's phone number
  • postingId (string (uuid)): Id of the posting applied to
  • postingTitle (string): Title of the posting
  • rating (object): Summary of the reviewers' ratings
    • average (number): Average score (1–5)
    • count (integer): Number of ratings
    • mine (integer): The caller's score (0 not rated)
  • role (string): The caller's role on the posting (one of viewer, reviewer, manager)
  • source (string): How the application arrived (one of manual, portal, api)
  • stageChangedAt (string (date-time)): When the application entered its current stage
  • stageId (string (uuid)): Id of the current pipeline stage
  • talentPoolUntil (string (date-time)): Kept in the talent pool until then (applicant agreed)
  • updatedAt (string (date-time)): When the application was last changed
  • version (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 POST 'https://api.mbcom.cloud/api/hr/v1/recruiting/applications/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/withdraw' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"reason":"Hat telefonisch abgesagt – Stelle beim bisherigen Arbeitgeber angenommen.","stageId":"8c0e2a4c-6e8a-4c0e-8a4c-6e8a0c2e4a88","version":4}'

View as Markdown · Interactive reference · OpenAPI