## Add a file to an application (managers of the posting)

`POST /api/hr/v1/recruiting/applications/{id}/files`

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

PDF, Word, OpenDocument text or a photo of at most 10 MB as multipart field `file`, at most 10 files per
application. The file is stored in the DMS, which scans it for malware: until the scan is `CLEAN` it is not
served; an `INFECTED` file is refused (`422 infected`).

### Parameters

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

### Request body

`multipart/form-data` (required)

- `file` (string (binary), required): The file
- `fieldKey` (string): The file question the file answers (role answer)
- `role` (string): What the file is (one of `cv`, `attachment`, `answer`; default `"attachment"`)

### Responses

- **201** Stored (`application/json`)
- **400** Error (`application/json`)
- **403** Error (`application/json`)
- **404** Error (`application/json`)
- **413** Error (`application/json`)
- **422** Error (`application/json`)
- **503** Error (`application/json`)

Fields of the 201 answer:

- `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

Example 201 answer:

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

### Example request

```bash
curl -X POST 'https://api.mbcom.cloud/api/hr/v1/recruiting/applications/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/files' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@document.pdf'
```
