Zum Hauptinhalt springen
PATCH
Ändern Sie den Titel, die Priorität, das Fälligkeitsdatum, die Tags oder das zuständige Prüfteam eines Falls. Senden Sie nur die Felder, die Sie ändern möchten. Ausgelassene Felder behalten ihren Wert. tags ersetzt die gesamte Tag-Liste. Senden Sie deshalb jeden Tag, den der Fall behalten soll.

Zuständiges Team ändern

Setzen Sie team auf die UUID eines aktiven Prüfteams dieser Anwendung oder auf null, um das Team zu entfernen. Um die UUID eines Teams zu finden, rufen Sie GET /v3/organization/{organization_id}/application/{application_id}/cases/teams/ auf und lesen results[].uuid aus. Ein Team, das inaktiv oder gelöscht ist oder zu einer anderen Anwendung gehört, führt zu 400 mit {"team": ["Choose an active team of this application."]}. Jede Änderung fügt der Zeitleiste des Falls ein Ereignis TEAM_CHANGED mit dem bisherigen und dem neuen Team hinzu. Das Ändern des Teams ändert nicht, wem der Fall zugewiesen ist.

Zeitleistenereignisse

Eine Änderung der Priorität, des Fälligkeitsdatums, der Tags oder des Teams fügt der Zeitleiste des Falls ein Ereignis PRIORITY_CHANGED, DUE_DATE_CHANGED, TAG_ADDED, TAG_REMOVED oder TEAM_CHANGED hinzu. Eine Titeländerung wird ohne Zeitleistenereignis gespeichert. Wenn Sie ein Feld mit seinem aktuellen Wert senden, wird kein Ereignis hinzugefügt.

Zugriff

Für Fall-Endpoints benötigen Sie einen API-Schlüssel mit Vollzugriff. Ein Schlüssel mit eingeschränktem Zugriff erhält eine 403-Antwort. Ein Console-Mitgliedstoken benötigt write:cases.

Verwandte Themen

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

organization_id
string<uuid>
erforderlich

UUID der Organisation.

application_id
string<uuid>
erforderlich

Anwendungs-UUID.

case_uuid
string<uuid>
erforderlich

Fall-UUID.

Beispiel:

"c1a5e000-0000-4000-8000-000000000001"

Body

application/json
title
string

Neuer Falltitel.

Maximum string length: 255
priority
enum<string>
Verfügbare Optionen:
LOW,
MEDIUM,
HIGH
due_at
string<date-time> | null

Neue Frist. Senden Sie null, um sie zu löschen.

tags
string[]

Die vollständige Tag-Liste. Sie ersetzt die aktuellen Tags.

team
string<uuid> | null

UUID des Prüfungsteams, dem der Fall gehört. Es muss ein aktives Team dieser Anwendung sein. Senden Sie null, um das Team zu entfernen.

Antwort

Aktualisierter Fall.

uuid
string<uuid>
case_number
string | null
title
string
status
enum<string>
Verfügbare Optionen:
OPEN,
AWAITING_USER,
RESOLVED
resolution
enum<string> | null
Verfügbare Optionen:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
resolution_notes
string | null
priority
enum<string>
Verfügbare Optionen:
LOW,
MEDIUM,
HIGH
source
enum<string>
Verfügbare Optionen:
MANUAL,
AML_SCREENING,
TRANSACTION_RULE,
WORKFLOW_BUILDER
tags
string[]
subject
object | null

Der einzelne Benutzer oder das Unternehmen, an den bzw. das der Fall gebunden ist.

assigned_to
object | null
assigned_at
string<date-time> | null
team
object | null

Das Prüfungsteam, das für den Fall zuständig ist, oder null, wenn kein Team zuständig ist. Das Routing legt dies fest, wenn eine Routing-Regel den Fall einem ihrer Teams zuweist. Ändern oder löschen Sie dies mit PATCH .../cases/{case_uuid}/ (team).

due_at
string<date-time> | null
resolved_at
string<date-time> | null
resolved_by_email
string | null
pending_resolution
object | null

Wird nur gesetzt, während eine 4-Augen-Auflösung auf der Checker-Vorlage bereitgestellt ist und auf Genehmigung oder Ablehnung der Genehmigung wartet.

checker
object | null

Das benannte Mitglied zur Genehmigung oder Ablehnung des ausstehenden Beschlusses. Nur gesetzt, während ein Vier-Augen-Beschluss auf einen benannten Prüfer wartet. Null, wenn nichts aussteht, während der ausstehende Beschluss in der Prüfer-Warteschlange wartet und sobald der Beschluss genehmigt, abgelehnt oder aufgrund geänderter Nachweise zur erneuten Prüfung zurückgegeben wurde.

metadata
object
blueprint
object
notes
object[]

Neueste 50 Notizen.

events
object[]

Neueste 100 Ereignisse.

notes_count
integer
checklist_items
object[]
created_at
string<date-time>
updated_at
string<date-time>
Zuletzt geändert am 7. November 2026