> ## 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.

# Kill Switch

> Einen Agenten und delegierte Nachkommen widerrufen, Sitzungen beenden und die Notfallentscheidung aufzeichnen.

Verwenden Sie diesen Endpunkt für Notfälle wie einen kompromittierten Agenten. Geben Sie den Agentenbezeichner und einen nicht leeren Vorfall `reason` (maximal 2000 UTF-8-Bytes) an. Der authentifizierte Arbeitsbereich und die Umgebung bestimmen, welchen Agenten Sie widerrufen können.

Der Vorgang widerruft den Agenten und seine delegierten Nachkommen, beendet ihre aktiven Sitzungen, widerruft ihre aktiven Delegationslinks und speichert die Entscheidung in einer Datenbanktransaktion. Falls diese Transaktion fehlschlägt, werden ihre Statusänderungen zurückgesetzt.

> [!WARNING]
>
> Der Widerruf ist dauerhaft. Registrieren Sie einen neuen Agenten, wenn die Arbeit wieder aufgenommen werden muss. Zuvor ausgestellte Belegnachweise bleiben erhalten; dieser Endpunkt löscht oder überschreibt sie nicht.

### Ergebnis prüfen

Eine erfolgreiche Antwort enthält `status: "killed"`. `agents_changed` enthält den angeforderten Agenten; `cascade_count` zählt neu widerrufene Nachkommen. `sessions_terminated` und `delegations_revoked` melden die betroffenen Sitzungen und Delegationslinks.

Wenn die verwaltete Signierung erfolgreich ist, ist `receipt_status` `signed` und `receipt_id` identifiziert eine signierte Widerrufsempfangsbestätigung. Rufen Sie diese über die Receipts API ab. Die Gültigkeit der Signatur und der Lebenszyklusstatus des widerrufenen Agenten sind separate Prüfungen.

Wenn die Signierung nicht verfügbar ist, ist der Widerruf dennoch erfolgreich: `receipt_status` ist `unavailable` und `receipt_id` ist `null`. Die dauerhafte Widerrufsentscheidung bleibt aufgezeichnet. Eine signierte Quittung oder ein automatischer Signaturwiederholungsversuch ist durch diese Antwort nicht impliziert.

### Audit-Verhalten

Der Dienst zeichnet ein `agent.killed`-Ereignis und ein Widerrufsereignis zusammen mit den Statusänderungen auf. Eine Antwort stellt keine externe Transparenzverankerung, Webhook-Zustellung oder SIEM-Zustellung her. Überprüfen Sie diese Kanäle separat, wenn Ihr Vorfallprozess davon abhängt.

Ein unbekannter Agent in der ausgewählten Arbeitsbereichsumgebung gibt `404` zurück. Ein bereits widerrufener Agent gibt `409` zurück. Überprüfen Sie den bestehenden Status, bevor Sie eine Notfallanfrage erneut versuchen.


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/agents/{agentId}/kill
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/agents/{agentId}/kill:
    post:
      tags:
        - Machine Identity
      summary: Not-Aus-Schalter
      description: >-
        Widerruft atomar den ausgewählten Agenten und seine delegierten
        Nachkommen, beendet deren aktive Sitzungen und zeichnet die Entscheidung
        auf. Bestehende Belegnachweise bleiben erhalten. Signaturausfälle
        blockieren den Widerruf nicht; überprüfen Sie receipt_status, bevor Sie
        versuchen, einen Beleg abzurufen.
      operationId: maip.agents.kill
      parameters:
        - name: agentId
          in: path
          required: true
          schema:
            type: string
          description: Agenten-Identifikator
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                reason:
                  type: string
                  minLength: 1
                  maxLength: 2000
                  description: Nicht leerer Vorfallgrund, maximal 2000 UTF-8 Bytes
              type: object
              required:
                - reason
      responses:
        '200':
          description: Agent getötet
          content:
            application/json:
              schema:
                type: object
                properties:
                  agent_id:
                    type: string
                  tenant_id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - killed
                  agents_changed:
                    type: integer
                  cascade_count:
                    type: integer
                    description: >-
                      Nachfolgende Agenten neu widerrufen, ausgenommen der
                      angeforderte Agent.
                  sessions_terminated:
                    type: integer
                  delegations_revoked:
                    type: integer
                  reason:
                    type: string
                  killed_at:
                    type: string
                    format: date-time
                  receipt_id:
                    type: string
                    nullable: true
                    description: >-
                      ID des signierten Widerrufsbelegs oder null, wenn die
                      Signatur nicht verfügbar war.
                  receipt_status:
                    type: string
                    enum:
                      - signed
                      - unavailable
                    description: >-
                      Nicht verfügbar macht die abgeschlossene
                      Notfallwiderrufung nicht rückgängig.
        '400':
          description: Validierungsfehler
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Authentifizierung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Agent nicht gefunden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '409':
          description: >-
            Agent ist bereits widerrufen oder sein Lebenszyklusstatus verhindert
            diesen Vorgang.
        '429':
          description: Ratenlimit überschritten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Maschinenlesbarer Fehlercode
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Menschenlesbare Fehlermeldung
        http_status:
          type: integer
          description: HTTP-Statuscode
        retry_after_ms:
          type: integer
          description: >-
            Millisekunden, die vor einem erneuten Versuch gewartet werden sollen
            (für Ratenbegrenzungen)
        details:
          type: object
          description: Zusätzlicher Fehlerkontext
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  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.