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

# Orchestrierungs-Ausführungsdatensatz erstellen

> Erstellt einen Tracking-Datensatz für eine Multi-Agenten-Orchestrierung.

Erstellt einen Tracking-Datensatz für eine Multi-Agenten-Orchestrierung.

Geben Sie `pattern`, `orchestrator_id` und `agent_ids` an, optional mit `input_payload` und `metadata`. Der aktuelle Handler zeichnet eine Ausführung auf und gibt HTTP 201 zurück. Er führt Ihre Agenten nicht selbst aus und garantiert nicht, dass die Arbeit abgeschlossen ist. Ein Ausführungsdatensatz oder ein anfänglicher Status ist kein Beweis für abgeschlossene Tool-Aufrufe. Neue automatisch generierte Belege verwenden den verwalteten Signierer. Überprüfen Sie jeden Beleg; die Unterzeichnung der Tracking-Anweisung belegt nicht, dass die Agenten ausgeführt wurden. Historische Platzhalter-Signaturen können nicht überprüfbar bleiben.

Verwenden Sie die oben generierten Parameterfelder für den Anforderungsvertrag. Authentifizieren Sie sich mit einem Anmeldeinformation für den Zielarbeitsbereich und die Umgebung; geben Sie keinen Mandantenauswahl-Header an.


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/orchestrate/execute
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/orchestrate/execute:
    post:
      tags:
        - Machine Identity
      summary: Orchestrierung ausführen
      description: >-
        Startet eine Orchestrierung, die mehrere Agenten koordiniert, um einen
        Workflow auszuführen. Jeder Schritt erzeugt eine Quittung für die
        vollständige Prüfbarkeit.
      operationId: maip.orchestrations.execute
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                agent_ids:
                  type: array
                  items:
                    type: string
                input_payload: {}
                metadata: {}
                orchestrator_id:
                  type: string
                pattern:
                  type: string
              type: object
              required:
                - pattern
                - orchestrator_id
                - agent_ids
      responses:
        '201':
          description: Orchestrierung gestartet
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaipOrchestration'
        '400':
          description: Validierungsfehler
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Authentifizierung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Ratenlimit überschritten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    MaipOrchestration:
      type: object
      properties:
        orchestration_id:
          type: string
          format: uuid
        workflow_id:
          type: string
          format: uuid
        agents:
          type: array
          items:
            type: string
            format: uuid
        parameters:
          type: object
          additionalProperties: true
        status:
          type: string
          enum:
            - pending
            - running
            - completed
            - failed
            - cancelled
        steps:
          type: array
          items:
            type: object
            properties:
              step_id:
                type: string
              agent_id:
                type: string
                format: uuid
              action:
                type: string
              status:
                type: string
              result:
                type: object
                additionalProperties: true
              started_at:
                type: string
                format: date-time
              completed_at:
                type: string
                format: date-time
        results:
          type: object
          additionalProperties: true
        receipts:
          type: array
          items:
            type: string
            format: uuid
        created_at:
          type: string
          format: date-time
    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.