> For the complete documentation index, see [llms.txt](https://outboundpro.gitbook.io/api-v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://outboundpro.gitbook.io/api-v1/list/excluir-lista.md).

# Excluir lista

## Excluir lista (soft delete)

> Soft delete (\`lis\_excluida = 'S'\`). Leads vinculados \*\*não são afetados\*\* —\
> apenas a associação some.\
> \
> Idempotente — deletar 2x é no-op.\
> \
> \### Quando usar\
> \- \*\*Limpeza pós-campanha\*\* — campanha terminou, leads bons já foram movidos\
>   pra status definitivos. Deleta a lista pra não poluir o UI.\
> \- \*\*Erro do usuário\*\* — criou lista com nome errado, deleta e cria de novo.\
> \- \*\*GDPR/LGPD\*\* — cliente final do seu cliente pediu remoção, processo\
>   de cleanup inclui apagar a lista que continha o registro.\
> \
> \### Quando NÃO usar\
> \- \*\*Pra remover os LEADS\*\* — \`/list/delete\` só apaga a lista (container).\
>   Os leads continuam na base, só perdem a vinculação. Pra remover lead use\
>   fluxo separado.\
> \
> \### Cuidados\
> \- \*\*Não desfaz via API\*\* — recuperação só por restore manual no banco.\
> \- \*\*Lista pública apagada\*\* — todos os usuários do cliente deixam de ver. Confirme\
>   intent antes de deletar listas compartilhadas.\
> \
> \### Casos de uso reais\
> \- \*\*Cron de housekeeping\*\*: roda mensalmente, deleta listas com >180 dias sem\
>   atividade e nome contendo "temp", "rascunho" ou "teste".\
> \- \*\*Workflow de finalização\*\*: ao fechar campanha no CRM externo, chama\
> &#x20; \`/list/delete\` no OutboundPro pra limpar o histórico de planejamento.<br>

```json
{"openapi":"3.0.3","info":{"title":"OutboundPro API","version":"2.0.0"},"tags":[{"name":"List","description":"**Listas de leads** — agrupamentos arbitrários que você cria para\norganizar prospecção (ex.: \"E-commerces SP\", \"Tecnologia ENT\", \"Black Friday 2026\").\n\nListas podem ser **públicas** (compartilhadas com todo o cliente) ou\n**privadas** (só você), ter **prevendedor** designado, cor customizada,\ne **seguidores** (usuários que recebem notificação de movimento).\n\n### Operações suportadas\n- CRUD completo (list, search, create, edit, delete).\n- Exclusão é **lógica** (soft delete; `lis_excluida = 'S'`).\n- Buscar com filtros: nome, tipo, público/privado, dono, prevendedor, período.\n"}],"servers":[{"url":"https://app.outboundpro.com.br/api","description":"Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Token","description":"Chave privada do cliente (`cli_chave_privada`). Formato UUID v4\n(36 caracteres com hífens). Aceita header em qualquer case\n(`Token`, `token`, `TOKEN`).\n"}},"responses":{"Unauthorized":{"description":"Token ausente, inválido ou cliente inativo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Recurso não encontrado. Pode ser por:\n- ID inexistente.\n- ID existe **em outro cliente** (isolamento de tenant retorna 404, não 403).\n- Recurso foi deletado/soft-deleted.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"ErrorResponse":{"type":"object","required":["response"],"properties":{"response":{"type":"string","enum":["error"]},"mensagem":{"type":"string","description":"Descrição do erro em pt-BR. Família Contact usa `message` (legado)."},"message":{"type":"string","description":"Equivalente inglês de `mensagem`, usado pela família Contact."}}}}},"paths":{"/list/delete":{"delete":{"tags":["List"],"summary":"Excluir lista (soft delete)","operationId":"listDelete","description":"Soft delete (`lis_excluida = 'S'`). Leads vinculados **não são afetados** —\napenas a associação some.\n\nIdempotente — deletar 2x é no-op.\n\n### Quando usar\n- **Limpeza pós-campanha** — campanha terminou, leads bons já foram movidos\n  pra status definitivos. Deleta a lista pra não poluir o UI.\n- **Erro do usuário** — criou lista com nome errado, deleta e cria de novo.\n- **GDPR/LGPD** — cliente final do seu cliente pediu remoção, processo\n  de cleanup inclui apagar a lista que continha o registro.\n\n### Quando NÃO usar\n- **Pra remover os LEADS** — `/list/delete` só apaga a lista (container).\n  Os leads continuam na base, só perdem a vinculação. Pra remover lead use\n  fluxo separado.\n\n### Cuidados\n- **Não desfaz via API** — recuperação só por restore manual no banco.\n- **Lista pública apagada** — todos os usuários do cliente deixam de ver. Confirme\n  intent antes de deletar listas compartilhadas.\n\n### Casos de uso reais\n- **Cron de housekeeping**: roda mensalmente, deleta listas com >180 dias sem\n  atividade e nome contendo \"temp\", \"rascunho\" ou \"teste\".\n- **Workflow de finalização**: ao fechar campanha no CRM externo, chama\n  `/list/delete` no OutboundPro pra limpar o histórico de planejamento.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"integer"},"usuario_id":{"type":"integer","description":"Para audit log (quem deletou)."}}}}}},"responses":{"200":{"description":"Lista excluída.","content":{"application/json":{"schema":{"type":"object","properties":{"response":{"type":"string","enum":["success"]},"mensagem":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```