Saltar al contenido principal
PATCH
curl
Actualiza el nombre o la descripción de una lista. Cualquier otro campo del cuerpo se ignora, por lo que list_type y entry_type conservan los valores con los que se crearon. Las listas del sistema no se pueden modificar y devuelven 400. La respuesta contiene solo name y description. Invoca el endpoint Obtener lista para obtener la lista completa.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

list_uuid
string<uuid>
requerido

UUID de la lista, tal como lo devuelven Listar listas o Crear una lista.

Cuerpo

application/json
name
string

Nuevo nombre. Debe ser distinto del nombre de todas las demás listas de la aplicación.

Required string length: 1 - 255
description
string

Nueva descripción. Envía una cadena vacía para eliminarla.

Respuesta

La lista se actualizó. Solo se devuelven los campos editables.

name
string
requerido

El nombre de la lista después de la actualización.

description
string
requerido

La descripción de la lista después de la actualización.

Última modificación el 1 de noviembre de 2026