Saltar al contingut principal
PATCH
curl
Actualitza el nom o la descripció d’una llista. Qualsevol altre camp del cos de la sol·licitud s’ignora, de manera que list_type i entry_type conserven els valors amb què es van crear. Les llistes del sistema no es poden modificar i retornen 400. La resposta només conté name i description. Crida Obtenir llista per obtenir la llista completa.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

list_uuid
string<uuid>
requerit

UUID de la llista, tal com el retorna Llistar llistes o Crear una llista.

Cos

application/json
name
string

Nou nom. Ha de ser diferent del nom de qualsevol altra llista de l'aplicació.

Required string length: 1 - 255
description
string

Nova descripció. Envia una cadena buida per esborrar-la.

Resposta

S'ha actualitzat la llista. Només es retornen els camps editables.

name
string
requerit

El nom de la llista després de l'actualització.

description
string
requerit

La descripció de la llista després de l'actualització.

Darrera modificació el 7 de novembre del 2026