> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leavo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags do Lead

> Adicionar e remover tags de um lead

## Adicionar Tag ao Lead

<Card>
  <strong>POST</strong> `/backend/leads/{id}/tags/{tag_id}`
</Card>

Adiciona uma tag existente a um lead.

### Path Parameters

<ParamField path="id" type="string" required>
  UUID do lead
</ParamField>

<ParamField path="tag_id" type="string" required>
  UUID da tag a ser adicionada
</ParamField>

### Response

Retorna `204 No Content` em caso de sucesso.

<RequestExample>
  ```bash cURL - Adicionar Tag theme={null}
  curl -X POST "https://api.leavo.ai/backend/leads/550e8400-e29b-41d4-a716-446655440000/tags/880e8400-e29b-41d4-a716-446655440000" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```

  ```javascript JavaScript - Adicionar Tag theme={null}
  const leadId = '550e8400-e29b-41d4-a716-446655440000';
  const tagId = '880e8400-e29b-41d4-a716-446655440000';

  await fetch(`https://api.leavo.ai/backend/leads/${leadId}/tags/${tagId}`, {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sua_chave_aqui'
    }
  });
  ```
</RequestExample>

***

## Remover Tag do Lead

<Card>
  <strong>DELETE</strong> `/backend/leads/{id}/tags/{tag_id}`
</Card>

Remove uma tag de um lead.

### Path Parameters

<ParamField path="id" type="string" required>
  UUID do lead
</ParamField>

<ParamField path="tag_id" type="string" required>
  UUID da tag a ser removida
</ParamField>

### Response

Retorna `204 No Content` em caso de sucesso.

<RequestExample>
  ```bash cURL - Remover Tag theme={null}
  curl -X DELETE "https://api.leavo.ai/backend/leads/550e8400-e29b-41d4-a716-446655440000/tags/880e8400-e29b-41d4-a716-446655440000" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```

  ```javascript JavaScript - Remover Tag theme={null}
  const leadId = '550e8400-e29b-41d4-a716-446655440000';
  const tagId = '880e8400-e29b-41d4-a716-446655440000';

  await fetch(`https://api.leavo.ai/backend/leads/${leadId}/tags/${tagId}`, {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer sua_chave_aqui'
    }
  });
  ```
</RequestExample>

***

## Exemplo Completo

Veja como gerenciar tags de um lead:

```javascript theme={null}
// Buscar lead com suas tags
const leadResponse = await fetch(`${API_URL}/backend/leads/${leadId}`, {
  headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const lead = await leadResponse.json();

console.log('Tags atuais:', lead.tags);

// Adicionar nova tag
await fetch(`${API_URL}/backend/leads/${leadId}/tags/${newTagId}`, {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${API_KEY}` }
});

// Remover tag antiga
await fetch(`${API_URL}/backend/leads/${leadId}/tags/${oldTagId}`, {
  method: 'DELETE',
  headers: { 'Authorization': `Bearer ${API_KEY}` }
});

// Verificar resultado
const updatedLead = await fetch(`${API_URL}/backend/leads/${leadId}`, {
  headers: { 'Authorization': `Bearer ${API_KEY}` }
}).then(r => r.json());

console.log('Tags atualizadas:', updatedLead.tags);
```