> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Liste aktualisieren API: Compliance-Liste bearbeiten > Über PATCH /v3/lists/{list_uuid}/ Didit-Allowlist oder Custom-Liste umbenennen oder Beschreibung ändern. Systemlisten sind nicht änderbar. Prompt für die API zum Aktualisieren einer Liste Prompt in die Zwischenablage kopieren \

\`Rename a Didit list or update its description through the Management API.

Endpoint:
PATCH https://verification.didit.me/v3/lists/{list_uuid}/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs workflows: write.

Goal:
\- Update the editable metadata of an allowlist or custom list: name and description.
\- list_type and entry_type cannot change: any other field in the body is ignored. To change them, create a new list.
\- System lists (is_system: true) cannot be modified.

Path parameter:
\- list_uuid: the list UUID returned by GET /v3/lists/ or POST /v3/lists/.

Request body (application/json), send either field or both:
\{
"name": "Trusted office and VPN IPs",  // at most 255 characters, unique among the application's lists
"description": "Office egress ranges and the corporate VPN"
}

Example call:
curl -X PATCH "https://verification.didit.me/v3/lists/{list_uuid}/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Trusted office and VPN IPs"}'

Example response (200), only the editable fields:
\{
"name": "Trusted office and VPN IPs",
"description": "Office egress ranges"
}

Call GET /v3/lists/{list_uuid}/ when you need the full list after the update.

Failure modes:
\- 400: the list is a system list ({ "non_field_errors": ["System lists cannot be modified."] }), or the new name is empty, longer than 255 characters, or already used by another list of the application ({ "name": ["A list with this name already exists for this application."] }).
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows: write.
\- 404: no list with this UUID in this application, or it was deleted.
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- The new name and description are visible in the console and on subsequent GET calls immediately.

For the full integration shape, see /integration/integration-prompt.`

\
Einfügen in 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](https://docs.didit.me/de/management-api/lists/get.md) auf, um die vollständige Liste zu erhalten. ## OpenAPI ````yaml de/openapi-25.json PATCH /v3/lists/{list_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/{list_uuid}/: patch: tags: - Lists summary: Liste aktualisieren description: >- Benennt eine Liste um oder ändert deren Beschreibung. Es werden nur `name` und `description` gelesen; jedes andere Feld wird ignoriert, sodass `list_type` und `entry_type` die Werte behalten, mit denen sie erstellt wurden. Systemlisten können nicht geändert werden und geben `400` zurück. Die Antwort enthält nur `name` und `description`: Rufen Sie [Liste abrufen](https://docs.didit.me/de/management-api/lists/get) auf, um die vollständige Liste zu erhalten. Ein API-Schlüssel mit Scopes benötigt `workflows: write`. operationId: update_list parameters: - name: list_uuid in: path required: true description: >- UUID der Liste, wie sie von „Listen auflisten“ oder „Liste erstellen“ zurückgegeben wird. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 requestBody: required: true content: application/json: schema: type: object properties: name: type: string minLength: 1 maxLength: 255 description: >- Neuer Name. Muss sich vom Namen jeder anderen Liste der Anwendung unterscheiden. description: type: string description: >- Neue Beschreibung. Senden Sie eine leere Zeichenkette, um sie zu löschen. examples: Rename: value: name: Trusted office and VPN IPs Rename and describe: value: name: Trusted office and VPN IPs description: Office egress ranges and the corporate VPN responses: '200': description: >- Die Liste wurde aktualisiert. Nur die bearbeitbaren Felder werden zurückgegeben. content: application/json: schema: type: object required: - name - description properties: name: type: string description: Der Name der Liste nach der Aktualisierung. description: type: string description: Die Beschreibung der Liste nach der Aktualisierung. examples: Renamed: value: name: Trusted office and VPN IPs description: Office egress ranges '400': description: Die Liste ist eine Systemliste oder der Anfragetext ist ungültig. content: application/json: examples: System list: value: non_field_errors: - System lists cannot be modified. Duplicate name: value: name: - >- A list with this name already exists for this application. Blank name: value: name: - This field may not be blank. '401': description: >- Der API-Schlüssel mit eingeschränktem Geltungsbereich ist abgelaufen. Andere Authentifizierungsfehler geben `403` zurück. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- Der `x-api-key`-Header fehlt (ein falscher, widerrufener oder abgelaufener Schlüssel erhält `401`), oder ein API-Schlüssel mit Berechtigungseinschränkungen verfügt nicht über `workflows: write` oder wird von einer IP-Adresse außerhalb seiner Zulassungsliste verwendet. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without workflows access: value: detail: This API key has no write access to workflows. '404': description: >- In der Anwendung des API-Schlüssels existiert keine Liste mit dieser UUID, oder sie wurde gelöscht. content: application/json: examples: Not found: value: detail: No List matches the given query. '429': $ref: '#/components/responses/RateLimitedWrite' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X PATCH 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"name": "Trusted office and VPN IPs"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.lists.update( "11111111-2222-3333-4444-555555555555", name="Trusted office and VPN IPs", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.lists.update("11111111-2222-3333-4444-555555555555", { name: "Trusted office and VPN IPs", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Lists.Update(ctx, \"11111111-2222-3333-4444-555555555555\", didit.ListsUpdateParams{\n\tName: didit.String(\"Trusted office and VPN IPs\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.ListsUpdateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.lists().update("11111111-2222-3333-4444-555555555555", ListsUpdateParams.builder() .name("Trusted office and VPN IPs") .build()); System.out.println(result); - lang: php label: PHP source: >- lists->update('11111111-2222-3333-4444-555555555555', [ 'name' => 'Trusted office and VPN IPs', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.lists.update( "11111111-2222-3333-4444-555555555555", name: "Trusted office and VPN IPs" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Lists.UpdateAsync("11111111-2222-3333-4444-555555555555", new ListsUpdateParams { Name = "Trusted office and VPN IPs", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: responses: RateLimitedWrite: description: >- Das geteilte Schreiblimit von 300 Anfragen pro Minute pro API-Schlüssel wurde überschritten. Beachten Sie `Retry-After`, bevor Sie es erneut versuchen. content: application/json: schema: type: object required: - detail properties: detail: type: string example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.