Tags
Remove tag from candidate
Remove a tag from a candidate based on its name.
DELETE
/
ats
/
candidates
/
{candidate_id}
/
tags
Authorization
Header
Path
Body
curl --request DELETE \
--url https://api.kombo.dev/v1/ats/candidates/{candidate_id}/tags \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'X-Integration-Id: <x-integration-id>' \
--data '{
"tag": {
"name": "Excellent Fit"
}
}'
{
"status": "success",
"data": {}
}
This will also succeed if the tag does not exist on the candidate.
This endpoint requires the permission Create and manage candidates and applications to be enabled in your scope config.
Example Request Body
{
"tag": {
"name": "Excellent Fit"
}
}
Authorizations
Authorization
string
headerrequiredCreate an API key on the Secrets page in the Kombo dashboard.
Headers
X-Integration-Id
string
requiredID of the integration you want to interact with.
Path Parameters
candidate_id
string
requiredKombo ID of the candidate you want to remove the tag from.
Body
application/json
tag
object
requiredremote_fields
object
Additional fields that we will pass through to specific ATS systems.
Response
200 - application/json
status
enum<string>
requiredAvailable options:
success
data
object
requiredcurl --request DELETE \
--url https://api.kombo.dev/v1/ats/candidates/{candidate_id}/tags \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'X-Integration-Id: <x-integration-id>' \
--data '{
"tag": {
"name": "Excellent Fit"
}
}'
{
"status": "success",
"data": {}
}