Convert supports uploading 3 file types: Cover Letter, CV and Attachment. These files can have a maximum size of 5 mb and can be in .pdf and .docx formats.
Files are saved as an Teamtailor Upload entity and a relationship is created with the job and the candidate.
Teamtailor requires a public url of the file in order to upload it. This public urls are generated as a JWT-based short-lived links which respond with the decrypted file. The link is valid only for 20 minutes.
Example request to the Teamtailor API:
curl -X POST https://api.teamtailor.com/v1/uploads \
-H 'Authorization: Token token=apiToken' \
-H 'X-Api-Version: 20210218'
-d '{
"data": {
"type": "uploads",
"attributes": {
"file-name": "cv.pdf"
"url": "public file url"
},
},
"relationships": {
"job": {
"id": "job ID",
"type: "jobs"
},
"candidate": {
"id": "candidate ID",
"type: "candidates"
}
}
}'