> 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/editar-lista.md).

# Editar lista

## Editar lista

> Atualiza campos de uma lista existente. Omitir um campo = manter atual\
> (PATCH-like, apesar de ser PUT).\
> \
> Idempotente.\
> \
> \### Quando usar\
> \- \*\*Rename pós-aprovação\*\* — equipe define o nome final da campanha após\
>   aprovação interna, atualiza via CRM externo.\
> \- \*\*Mudar visibilidade\*\* — depois da campanha rodar, torna a lista pública\
>   pra outras pessoas terem acesso ao histórico.\
> \- \*\*Recolorir\*\* — equipe quer destacar listas prioritárias com cor de fundo\
>   específica na tela do OutboundPro.\
> \
> \### Casos de uso reais\
> \- \*\*Workflow de approval no Salesforce\*\*: gestor aprova "Campanha Q1" → trigger\
>   chama \`/list/edit\` no OutboundPro pra mudar nome de "Rascunho - X" pra "Q1 - X".\
> \- \*\*Bot Slack\*\*: SDR roda \`/painel rename minha-lista NovoNome\` → bot do Slack\
> &#x20; chama \`/list/edit\` no OutboundPro.<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"}},"schemas":{"Lista":{"type":"object","properties":{"id":{"type":"integer"},"codigo_ficticio":{"type":"integer","description":"Código curto para exibição (não use em joins; use `id`)."},"nome":{"type":"string"},"publica":{"type":"string","enum":["S","N"],"description":"S = compartilhada com todo o cliente, N = privada."},"cor_fundo":{"type":"string"},"cor_texto":{"type":"string"},"tipo":{"type":"string"},"prevendedor_id":{"type":"integer","nullable":true,"description":"Usuário responsável pela prospecção da lista."},"seguidores":{"type":"array","description":"Usuários que recebem notificação quando lead é movido na lista.","items":{"type":"object","properties":{"id":{"type":"integer"},"nome":{"type":"string"},"email":{"type":"string","format":"email"}}}},"data_cadastro":{"type":"string","format":"date-time"}}},"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."}}}},"responses":{"BadRequest":{"description":"Parâmetro obrigatório ausente ou em formato inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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"}}}}}},"paths":{"/list/edit":{"put":{"tags":["List"],"summary":"Editar lista","operationId":"listEdit","description":"Atualiza campos de uma lista existente. Omitir um campo = manter atual\n(PATCH-like, apesar de ser PUT).\n\nIdempotente.\n\n### Quando usar\n- **Rename pós-aprovação** — equipe define o nome final da campanha após\n  aprovação interna, atualiza via CRM externo.\n- **Mudar visibilidade** — depois da campanha rodar, torna a lista pública\n  pra outras pessoas terem acesso ao histórico.\n- **Recolorir** — equipe quer destacar listas prioritárias com cor de fundo\n  específica na tela do OutboundPro.\n\n### Casos de uso reais\n- **Workflow de approval no Salesforce**: gestor aprova \"Campanha Q1\" → trigger\n  chama `/list/edit` no OutboundPro pra mudar nome de \"Rascunho - X\" pra \"Q1 - X\".\n- **Bot Slack**: SDR roda `/painel rename minha-lista NovoNome` → bot do Slack\n  chama `/list/edit` no OutboundPro.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"integer"},"nome":{"type":"string"},"publica":{"type":"boolean"},"cor_fundo":{"type":"string"},"cor_texto":{"type":"string"},"tipo":{"type":"string"},"prevendedor_id":{"type":"integer"},"exactsales_prevendedor_email":{"type":"string","format":"email"},"seguidores":{"type":"array","items":{"type":"integer"}}}}}}},"responses":{"200":{"description":"Lista atualizada.","content":{"application/json":{"schema":{"type":"object","properties":{"response":{"type":"string","enum":["success"]},"mensagem":{"type":"string"},"lista":{"$ref":"#/components/schemas/Lista"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```