Actions24
- Candidatura Actions
- Candidato Actions
- Observação Actions
- Referência Actions
- Tag Actions
- Vaga Actions
Tag → Deletar
AI-generatedSummary
Deletes a tag by its ID.
Inputs
- tagId (required) — ID da tag a ser deletada (aceita número ou caminho; será extraído via expressâo
/id/ou convertido para número). Obrigatório; não há substituto padrão eficaz. Opcionalmente, pode ser omitido se o workflow tratar da remoção em lote ou via outro mecanismo, mas a operação exigirá o parâmetro para cada chamada individual.
Output shape
object
Se a API retornar
success !== false, o resultado é{ success: true, id: tagId }. Em qualquer outro caso (ex.:success: false, erro de validação, ou resposta não conforma), o node devolve o objeto bruto da resposta da API Recrutei. O parâmetropairedItempermanece vinculado ao item de entrada, permitindo encadeamento com outros nodes.
Examples
Example 1: Remover uma tag específica de um candidato.
Define o parâmetro 'ID da Tag' com o valor numérico ou caminho de referência da tag desejada. O node executa um DELETE para /api/v2/tags/talent com payload { id: tagId }. Se a operação tiver sucesso, o item de saída carrega { success: true, id: '<id_da_tag>' }. Caso contrário, recebe a resposta completa da API para tratamento de erro downstream.