Excluindo tags

Este endpoint permite excluir uma tag existente do sistema ou substituí-la por outra, de forma automática em todos os candidatos que a possuam.

Headers necessários:

NomeValorDescrição
AuthorizationBearer [SEU_TOKEN]Bearer Token para autenticação. Saiba mais aqui.

Uma vez que os Headers estejam devidamente configurados, podemos ir ao próximo passo.


Endpoint utilizado para excluir uma tag:

EndpointMétodoLink para Teste
/api/v2/tags/by-valueDELETELoading

Payload

Definição campo a campo para a exclusão/substituição de uma tag na API:

CampoObrigatórioTipoDescrição
replaceNãostringCampo para inserção da tag que substituirá a que está sendo excluída, ao definir esse campo, todos os candidatos com a tag excluida terão essa nova no lugar, caso não seja definido, essa tag sairá de seus perfis.
valueSimstringIdentifica qual será a tag a ser excluída/substituída.

Exemplo de resposta:

{
    "message": "Valor '12345' substitu\u00eddo por 'abcde' em 1 tag(s).",
    "data": {
        "success": true,
        "message": "Valor '12345' substitu\u00eddo por 'abcde' em 1 tag(s).",
        "affected_count": 1,
        "action": "replaced",
        "old_value": "aaaaa",
        "new_value": "abcde"
    }
}