Pular para o conteúdo principal
PATCH
curl
Atualize o nome ou a descrição de uma lista. Qualquer outro campo no corpo é ignorado, portanto list_type e entry_type mantêm os valores com que foram criados. Listas do sistema não podem ser modificadas e retornam 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

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, 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á errada, 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 a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. 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 ser diferente do nome de todas as outras listas da aplicação.

Required string length: 1 - 255
description
string

Nova descrição. Envie uma string vazia para removê-la.

Resposta

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

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 1 de novembro de 2026