Saltar para o conteúdo principal
PATCH
curl
Atualize o nome ou a descrição de uma lista. Qualquer outro campo do corpo é ignorado, pelo que list_type e entry_type mantêm os valores com que foram criados. As listas do sistema não podem ser modificadas e devolvem 400. A resposta contém apenas name e description. Chame Obter lista para obter a lista completa.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

list_uuid
string<uuid>
obrigatório

UUID da lista, conforme retornado por Listar listas ou Criar uma lista.

Corpo

application/json
name
string

Novo nome. Deve diferir do nome de qualquer outra lista da aplicação.

Required string length: 1 - 255
description
string

Nova descrição. Envie uma string vazia para a limpar.

Resposta

A lista foi atualizada. Apenas os campos editáveis são devolvidos.

name
string
obrigatório

O nome da lista após a atualização.

description
string
obrigatório

A descrição da lista após a atualização.

Última modificação em 7 de novembro de 2026