Akten

Die Cases API ist die zentrale Ressource für die Aktenverwaltung. Jede Akte kann zugewiesene Parteien, Mitarbeiter, Dokumente, Fristen und Notizen haben.

Endpunkte

Method	Path	Beschreibung
GET	/api/v1/cases	Akten auflisten
POST	/api/v1/cases	Akte erstellen
GET	/api/v1/cases/{id}	Akte abrufen
PUT	/api/v1/cases/{id}	Akte aktualisieren
DELETE	/api/v1/cases/{id}	Akte löschen
GET	/api/v1/cases/{id}/parties	Parteien einer Akte auflisten
POST	/api/v1/cases/{id}/parties	Parteien zu einer Akte hinzufügen
PUT	/api/v1/cases/{id}/parties	Parteien einer Akte ersetzen
GET	/api/v1/cases/{id}/staff	Zugewiesenes Personal auflisten
POST	/api/v1/cases/{id}/staff	Personal zu einer Akte hinzufügen
DELETE	/api/v1/cases/{id}/staff	Personal von einer Akte entfernen
GET	/api/v1/cases/{id}/timeline	Zeitachsen-Ereignisse einer Akte abrufen
POST	/api/v1/cases/{id}/links	Zwei Akten verknüpfen
GET	/api/v1/cases/{id}/links	Aktenverknüpfungen auflisten
DELETE	/api/v1/cases/{id}/links/{link_id}	Aktenverknüpfung entfernen

Das Akten-Objekt

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Smith v. Jones -- Employment Dispute",
  "file_number": "AZ-2026-042",
  "status": "active",
  "type": "litigation",
  "description": "Wrongful termination claim filed by former employee.",
  "dezernat": "Employment Law",
  "created_at": "2026-01-15T09:00:00Z",
  "updated_at": "2026-05-20T14:30:00Z",
  "parties": [
    {
      "id": "usr_01ABCDEF",
      "role": "client",
      "name": "Max Mustermann"
    }
  ],
  "staff": [
    {
      "id": "usr_01GHIJKL",
      "name": "Erika Mustermann",
      "role": "lead_attorney"
    }
  ]
}

Akten auflisten

GET /api/v1/cases

Query-Parameter

Parameter	Type	Beschreibung
cursor	string	Pagination-Cursor aus vorheriger Antwort
limit	integer	Anzahl der Ergebnisse (1-100, Standard 50)
status	string	Filter nach Status: active, closed, archived
search	string	Suche nach Aktenname oder Aktenzeichen

Antwort

{
  "data": [
    { "id": "...", "name": "...", "file_number": "...", "status": "..." }
  ],
  "pagination": {
    "cursor": "eyJpZCI6IjU1MGU4NDAwIn0=",
    "has_more": true
  }
}

Akte erstellen

POST /api/v1/cases

Request Body

{
  "name": "Smith v. Jones",
  "file_number": "AZ-2026-042",
  "type": "litigation",
  "description": "Wrongful termination claim",
  "dezernat": "Employment Law"
}

Antwort

Liefert 201 Created mit dem vollständigen Akten-Objekt.

Akte aktualisieren

PUT /api/v1/cases/{id}

Request Body

{
  "status": "closed",
  "description": "Case settled out of court."
}

Nur übermittelte Felder werden aktualisiert (partielle Update-Semantik).

Fehlerantworten

Status	Code	Bedeutung
400	VALIDATION_ERROR	Ungültiger Request Body
401	AUTH_INVALID_KEY	Fehlender oder ungültiger API-Schlüssel
403	AUTH_INSUFFICIENT_SCOPE	Fehlender Scope cases:read oder cases:write
404	CASE_NOT_FOUND	Akten-ID existiert nicht

Nächste Schritte

• Parteien -- Mit Akten verknüpfte Kontakte verwalten
• Dokumente -- Akten-Dokumente hochladen und verwalten
• Fristen -- Rechtliche Fristen verwalten