Remove a tag from a candidate
Remove a tag from a candidate.
DELETE https://cotlet.dev/api/v1/homerun/jobs/{job_id}/candidates/{candidate_id}/tag
write
Removes the tag from this profile only; the tag stays in the company list. It reaches nobody and add_candidate_tag undoes it, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id string required | string | Job ID from list_jobs. |
| candidate_id string required | string | Candidate ID from list_candidates. |
| tag string required | string | Tag name on the candidate. |
Request
curl -X DELETE "https://cotlet.dev/api/v1/homerun/jobs/job_8c41d2/candidates/candidate_8c41d2/tag?tag=tag" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("homerun", "remove_candidate_tag", {"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","tag":"tag"})const result = await cotlet.call('homerun', 'remove_candidate_tag', {"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","tag":"tag"});cotlet call homerun remove_candidate_tag --data '{"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","tag":"tag"}'Example response
{
"candidate_id": "ap_K2mP7rS1uW5yA9bC3dE6",
"status": "untagged",
"tags": []
}