ConnectCloud Developers

Reject an application, optionally with a mail to the applicant (managers of the posting)

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

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

The rejection mail goes out with the change (409 no_mailbox without a recruiting mailbox). The application is deleted after the retention period (or the end of the talent pool).

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:

{
  "mail": {
    "body": "Guten Tag Herr Lindner,\n\nvielen Dank für Ihr Interesse und das offene Gespräch. Wir haben uns für eine andere Bewerberin entschieden.\n\nMit freundlichen Grüßen\nMuster IT-Systemhaus GmbH – Personal",
    "subject": "Ihre Bewerbung als Systemadministrator:in Microsoft 365"
  },
  "reason": "Wenig Erfahrung mit Kundenprojekten; Angebot ging an eine andere Bewerberin.",
  "stageId": "6a8c0e2a-4c6e-4a8c-9e2a-4c6e8a0c2e87",
  "version": 6
}

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/reject' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"mail":{"body":"Guten Tag Herr Lindner,\n\nvielen Dank für Ihr Interesse und das offene Gespräch. Wir haben uns für eine andere Bewerberin entschieden.\n\nMit freundlichen Grüßen\nMuster IT-Systemhaus GmbH – Personal","subject":"Ihre Bewerbung als Systemadministrator:in Microsoft 365"},"reason":"Wenig Erfahrung mit Kundenprojekten; Angebot ging an eine andere Bewerberin.","stageId":"6a8c0e2a-4c6e-4a8c-9e2a-4c6e8a0c2e87","version":6}'

View as Markdown · Interactive reference · OpenAPI