Vai al contenuto principale
PATCH
curl
Aggiorna il nome o la descrizione di una lista. Qualsiasi altro campo nel corpo della richiesta viene ignorato, quindi list_type e entry_type mantengono i valori con cui la lista è stata creata. Le liste di sistema non possono essere modificate e restituiscono 400. La risposta contiene solo name e description. Chiama Recupera la lista per ottenere la lista completa.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

list_uuid
string<uuid>
obbligatorio

UUID della lista, come restituito da List lists o Create a list.

Corpo

application/json
name
string

Nuovo nome. Deve essere diverso dal nome di qualsiasi altra lista dell'applicazione.

Required string length: 1 - 255
description
string

Nuova descrizione. Invia una stringa vuota per rimuoverla.

Risposta

La lista è stata aggiornata. Vengono restituiti solo i campi modificabili.

name
string
obbligatorio

Il nome della lista dopo l'aggiornamento.

description
string
obbligatorio

La descrizione della lista dopo l'aggiornamento.

Ultima modifica il 7 novembre 2026