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 filefieldKey(string): The file question the file answers (role answer)role(string): What the file is (one ofcv,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 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
Example 201 answer:
{
"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
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'