Remove a tag from a candidate; repeating it changes nothing

DELETE /v1/candidates/{id}/tags/{name}

Permission needed: candidates:write

Parameters

NameInTypeRequiredNotes
idpathintegerYesMinimum 1
namepathstringYes

Responses

  • 200 Candidate
  • 400 Missing or invalid field
  • 404 The candidate does not exist
  • 429 Too many requests

Examples

curl
curl -X DELETE 'https://api.novatalent.com/v1/candidates/123/tags/value' \
  -H "X-Api-Key: $NOVA_API_KEY"
Node
const response = await fetch('https://api.novatalent.com/v1/candidates/123/tags/value', {
  method: 'DELETE',
  headers: { 'X-Api-Key': process.env.NOVA_API_KEY },
});
console.log(response.status, await response.json());
PHP
<?php
$curl = curl_init('https://api.novatalent.com/v1/candidates/123/tags/value');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('NOVA_API_KEY')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
echo $status . " " . $response;