DELETE
/
ats
/
candidates
/
{candidate_id}
/
tags
curl --request DELETE \
  --url https://api.kombo.dev/v1/ats/candidates/{candidate_id}/tags \
  --header 'Authorization: Bearer <token>' \
  --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
headerrequired

Create an API key on the Secrets page in the Kombo dashboard.

Headers

X-Integration-Id
string
required

ID of the integration you want to interact with.

Path Parameters

candidate_id
string
required

The Kombo ID of the candidate you want to remove the tag from.

Body

application/json
tag
object
required
remote_fields
object

Additional fields that we will pass through to specific ATS systems.

Response

200 - application/json
status
enum<string>
required
Available options:
success
data
object
required