Zum Hauptinhalt springen
PATCH
curl
Aktualisieren Sie den Namen oder die Beschreibung einer Liste. Alle anderen Felder im Anfragekörper werden ignoriert, sodass list_type und entry_type die Werte behalten, mit denen sie erstellt wurden. Systemlisten können nicht geändert werden und liefern 400 zurück. Die Antwort enthält nur name und description. Rufen Sie Liste abrufen auf, um die vollständige Liste zu erhalten.

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

list_uuid
string<uuid>
erforderlich

UUID der Liste, wie sie von „Listen auflisten“ oder „Liste erstellen“ zurückgegeben wird.

Body

application/json
name
string

Neuer Name. Muss sich vom Namen jeder anderen Liste der Anwendung unterscheiden.

Required string length: 1 - 255
description
string

Neue Beschreibung. Senden Sie eine leere Zeichenkette, um sie zu löschen.

Antwort

Die Liste wurde aktualisiert. Nur die bearbeitbaren Felder werden zurückgegeben.

name
string
erforderlich

Der Name der Liste nach der Aktualisierung.

description
string
erforderlich

Die Beschreibung der Liste nach der Aktualisierung.

Zuletzt geändert am 7. November 2026