v3

OpenAPI 3.1.02026-07-311255771.3 MB
Unified ATS API

Remove tag from candidate

Remove a tag from a candidate based on its name.

This will also succeed if the tag does not exist on the candidate.

<Note> This endpoint requires the permission **Manage tags** to be enabled in [your scope config](/scopes). </Note>

Example Request Body

{
  "tag": {
    "name": "Excellent Fit"
  }
}
delete/ats/candidates/{candidate_id}/tags

Path parameters

candidate_idstring required

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

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

Headers

X-Integration-Idstring required

ID of the integration you want to interact with.

Request body

Response

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

status'success' required
dataobject required

Example response

{
  "data": {}
}