Attach a file to a candidate
POST /v1/candidates/{id}/files
Permission needed: candidates:write
Parameters
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
id | path | integer | Yes | Minimum 1 |
file | formData | file | Yes | |
name | formData | string | No |
Responses
201File stored400Missing or invalid field404The candidate does not exist429Too many requests
Examples
curl -X POST 'https://api.novatalent.com/v1/candidates/123/files' \
-H "X-Api-Key: $NOVA_API_KEY" \
-F 'file=@file.pdf'import { readFile } from 'node:fs/promises';
const form = new FormData();
form.append('file', new Blob([ await readFile('file.pdf') ]), 'file.pdf');
const response = await fetch('https://api.novatalent.com/v1/candidates/123/files', {
method: 'POST',
headers: { 'X-Api-Key': process.env.NOVA_API_KEY },
body: form,
});
console.log(response.status, await response.json());<?php
$curl = curl_init('https://api.novatalent.com/v1/candidates/123/files');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('NOVA_API_KEY')],
CURLOPT_POSTFIELDS => [
'file' => new CURLFile('file.pdf'),
],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
echo $status . " " . $response;