> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bestätigung ersetzen

> Erstellt eine neue Bestätigung, die eine bestehende ersetzt. Die ursprüngliche Bestätigung wird als SUPERSEDED markiert.

Erstellt eine neue Bestätigung, die eine bestehende ersetzt. Die ursprüngliche Bestätigung wird als `SUPERSEDED` mit einem Verweis auf die neue Version markiert. Die neue Bestätigung wird mit dem angegebenen Schlüssel signiert, im Transparenzprotokoll aufgezeichnet und zusammen mit der aktualisierten Originalbestätigung zurückgegeben. Beide Bestätigungen bleiben verifizierbar und bilden eine überprüfbare Kette von Anmeldeinformationsversionen. Nur `VALID` Bestätigungen können ersetzt werden – `REVOKED` oder bereits `SUPERSEDED` Bestätigungen geben einen `409 Conflict` zurück.

### Funktionsweise

**1. Supersede mit ursprünglicher Bestätigungs-ID aufrufen**

Geben Sie die UUID der zu ersetzenden Bestätigung als Pfadparameter an, zusammen mit der neuen Nutzlast und dem Signaturschlüssel.

**2. Originalattestierung als ERSETZT markiert**

Der Status der ursprünglichen Attestierung ändert sich zu `SUPERSEDED` mit einem Zeitstempel und einem Verweis auf die neue Attestierungs-ID.

**3. Neue Attestierung mit dem Status GÜLTIG erstellt**

Eine neue Bestätigung wird mit der aktualisierten Nutzlast geprägt, mit dem angegebenen Schlüssel signiert und im Transparenzlog aufgezeichnet.

**4. Beide in der Antwort zurückgegeben**

Die Antwort enthält sowohl das alte (ersetzt) als auch das neue (gültige) Attestierungsobjekt unter den Schlüsseln `old` und `new`.

### Häufige Anwendungsfälle

| Anwendungsfall | Szenario | Beispiel |
| - | - | - |
| Anmeldeinformationen aktualisieren | Mitarbeiter wechselt Rolle oder Abteilung | Alte Beschäftigungsbestätigung durch aktualisierten Titel ersetzen |
| Erneuerung | Zertifikat oder Lizenz läuft ab und wird erneuert | Ersetzt abgelaufene medizinische Lizenz durch neues Ablaufdatum |
| Fehlerkorrektur | Tippfehler oder falsche Daten in den ursprünglichen Anmeldeinformationen | Reisepass-Bestätigung mit korrigiertem Namen ersetzen |
| Versions-Upgrade | Schema- oder Claim-Formatänderungen | Ersetzt v1-Anmeldeinformationen durch v2-Format |
| Schlüsselrotation | Signaturschlüssel kompromittiert oder rotiert | Bescheinigung, die mit altem Schlüssel signiert wurde, mit neuem Schlüssel ersetzen |

### Antworten

> [!NOTE]
>
> Supersede-Operationen sind idempotent, wenn derselbe `Idempotency-Key` verwendet wird. Das Wiederholen einer fehlgeschlagenen Anforderung mit demselben Schlüssel ist sicher und führt nicht zu doppelten Bestätigungen.

> [!WARNING]
>
> Die ursprüngliche Bestätigung bleibt im Transparenzprotokoll und kann weiterhin überprüft werden. Ihr Status ändert sich zu `SUPERSEDED`, aber der kryptografische Beweis bleibt erhalten. Verifizierer können die vollständige Supersession-Kette verfolgen, indem sie dem Feld `superseded_by_attestation_id` folgen.


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/attestations/{id}/supersede
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks ist eine universelle Verifizierungsinfrastruktur für Dokumente,
    Anmeldeinformationen und digitale Assets.

    Diese Spezifikation definiert die kanonische API für die Interaktion mit
    Truthlocks-Diensten.


    ## Basis-URLs

    - **Produktion**: `https://api.truthlocks.com`

    - **Sandbox**: `https://sandbox-api.truthlocks.com`


    ## Authentifizierung

    - **API-Schlüssel**: Verwenden Sie den Header `X-API-Key` für
    Machine-to-Machine-Operationen

    - **Bearer Tokens**: Verwenden Sie `Authorization: Bearer <jwt>` für
    benutzerinitiierte Operationen


    ## Mandantenidentität

    In der Produktion wird die Mandantenidentität aus dem authentifizierten
    Kontext (API-Schlüssel oder JWT) abgeleitet.

    Der Header `X-Tenant-ID` wird in der Produktion ignoriert, um Spoofing zu
    verhindern.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: Produktions-API
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox-Umgebung
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: API-Schlüssel- und Token-Verwaltung
  - name: Issuers
    description: Ausstellerregistrierung und Vertrauensmanagement
  - name: Keys
    description: Kryptographische Schlüsselverwaltung für Aussteller
  - name: Attestations
    description: Bestätigungslebenszyklus (prägen, widerrufen, ersetzen)
  - name: Verification
    description: Bestätigungsverifizierung und Proof-Bundles
  - name: Governance
    description: Aussteller-Governance-Workflows (nur Admin)
  - name: Identity
    description: Organisations-, Benutzer- und Rollenverwaltung
  - name: Audit
    description: Audit-Ereignisabfragen
  - name: Tenant Console
    description: Mandantenprofil- und Lebenszyklus-Endpunkte
  - name: Health
    description: Endpunkte für Dienststatus und Bereitschaft
  - name: Risk
    description: Erfassung von Risikosignalen und Betrugserkennung
  - name: Risk Enforcement
    description: >-
      Risikodurchsetzungsmaßnahmen – Blockieren, Herausfordern, Quarantäne und
      Konfiguration
  - name: Billing
    description: Verwaltung von Abrechnung, Abonnements und Add-ons
  - name: Machine Identity
    description: >-
      Machine Agent Identity Protocol (MAIP) – Agentenregistrierung, Sitzungen,
      Vertrauen, Zeugen, Compliance, Orchestrierung und Beobachtbarkeit
externalDocs:
  description: Transparenz-API nur lesend (separate Dienstspezifikation)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/attestations/{id}/supersede:
    post:
      tags:
        - Attestations
      summary: Bestätigung ersetzen
      description: >-
        Erstellt eine neue Bestätigung, die eine bestehende ersetzt. Die
        ursprüngliche Bestätigung wird als SUPERSEDED markiert.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                alg:
                  type: string
                kid:
                  type: string
                payload_b64url:
                  type: string
              type: object
              required:
                - kid
                - alg
                - payload_b64url
      responses:
        '201':
          description: Neue Attestierung erstellt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Attestation'
      security:
        - APIKey: []
components:
  schemas:
    Attestation:
      type: object
      properties:
        id:
          type: string
          format: uuid
        issuer_id:
          type: string
          format: uuid
        kid:
          type: string
        status:
          type: string
          enum:
            - VALID
            - REVOKED
            - SUPERSEDED
        payload:
          type: object
        signature:
          type: string
        log_index:
          type: integer
        created_at:
          type: string
          format: date-time
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT für benutzerinitiierte Operationen

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.