## 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:

```json
{
  "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:

```json
{
  "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

```bash
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}'
```
