Skip to main content
DELETE
/
ats
/
candidates
/
{candidate_id}
/
tags
Python
from kombo import Kombo


with Kombo(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as k_client:

    res = k_client.ats.remove_candidate_tag(candidate_id="8Xi6iZrwusZqJmDGXs49GBmJ", tag={
        "name": "Excellent Fit",
    })

    # Handle response
    print(res)
{
  "status": "success",
  "data": {},
  "warnings": [
    {
      "message": "This is an example warning!"
    }
  ]
}
This feature is currently available for the following integrations:You’d like to see this feature for another integration? Please reach out! We’re always happy to discuss extending our coverage.
This will also succeed if the tag does not exist on the candidate.
This endpoint requires the permission Manage tags to be enabled in your scope config.

​
Example Request Body

{
  "tag": {
    "name": "Excellent Fit"
  }
}

Authorizations

​
Authorization
string
header
required

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

DELETE /ats/candidates/:candidate_id/tags Request body

​
tag
object
required
​
remote_fields
object

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

Response

DELETE /ats/candidates/:candidate_id/tags Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Example:
{}
​
warnings
object[]
required

These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console.