{
  "openapi": "3.1.0",
  "info": {
    "title": "Speakki API",
    "version": "1.0.0",
    "description": "Mit der Speakki API starten Sie ausgehende Anrufe und Kampagnen Ihrer Assistenten aus eigenen Programmen und lesen Gespräche, Kontakte und Termine.\n\n**Anmeldung:** Jede Anfrage trägt einen API-Schlüssel als `Authorization: Bearer spk_live_…`. Schlüssel legen Sie im Dashboard unter Verbindungen an. Der API-Zugang ist ab dem Tarif Professional enthalten.\n\n**Berechtigungen:** Jeder Schlüssel hat feste Berechtigungen.\n- `calls:read`: Anrufe lesen. Ausgehende und eingehende Anrufe, Assistenten und Rufnummern abrufen.\n- `calls:write`: Anrufe starten. Ausgehende Anrufe starten und geplante Anrufe abbrechen.\n- `campaigns:read`: Kampagnen lesen. Kampagnen mit Empfängern und Fortschritt abrufen.\n- `campaigns:write`: Kampagnen verwalten. Kampagnen anlegen, starten, pausieren und abbrechen.\n- `contacts:read`: Kontakte lesen. Kontakte der Organisation abrufen.\n- `appointments:read`: Termine lesen. Termine der Organisation abrufen.\n- `suppressions:write`: Sperrliste pflegen. Nummern auf die Sperrliste für ausgehende Anrufe setzen und entfernen.\n\n**Fehler:** Jede Antwort, die kein Erfolg ist, hat die Form `{ \"error\": { \"code\", \"message\", \"details\" } }`. Der `code` ist fest und für Programme gedacht.\n\n**Grenzen:** `POST /v1/calls` hat einen eigenen Zähler mit 30 Anfragen je Minute und Schlüssel. Alle übrigen Routen teilen sich zusammen 120 Anfragen je Minute und Schlüssel; Anfragen an `POST /v1/calls` zählen dort nicht mit. Jede Antwort trägt `x-ratelimit-limit` (erlaubte Anfragen im Zeitfenster), `x-ratelimit-remaining` (davon noch übrig) und `x-ratelimit-reset` (Sekunden, bis das Zeitfenster neu beginnt). Ist die Grenze erreicht, antwortet die API mit 429 und dem Code `rate_limited`, dazu `retry-after` (Sekunden bis zur nächsten möglichen Anfrage).\n\n**Zeiten:** ISO 8601 in UTC, zum Beispiel `2026-11-16T09:00:00.000Z`.\n\n**Blättern:** Listen liefern `next_cursor`. Senden Sie ihn als `cursor`, um die nächste Seite zu lesen. `null` heißt, es gibt keine weitere Seite.\n\n**Webhooks:** Am Assistenten lässt sich ein Webhook hinterlegen. Er meldet `call.ended`, `outbound_call.finished` und `outbound_campaign.finished`. Die Objekte in `outbound_call.finished` und `outbound_campaign.finished` sind dieselben wie `Call` und `Campaign` in dieser API."
  },
  "servers": [
    {
      "url": "https://api.speakki.de"
    }
  ],
  "tags": [
    {
      "name": "Anrufe",
      "description": "Ausgehende Anrufe starten, abfragen und abbrechen."
    },
    {
      "name": "Kampagnen",
      "description": "Kampagnen: eine Empfängerliste, die der Assistent nacheinander anruft."
    },
    {
      "name": "Sperrliste",
      "description": "Sperrliste: Nummern, die nie ausgehend angerufen werden."
    },
    {
      "name": "Assistenten",
      "description": "Assistenten, die für ausgehende Anrufe bereit sind."
    },
    {
      "name": "Rufnummern",
      "description": "Eigene Rufnummern für den Absender."
    },
    {
      "name": "Gespräche",
      "description": "Geführte Telefongespräche, eingehend und ausgehend, mit Zusammenfassung und erfassten Daten."
    },
    {
      "name": "Kontakte",
      "description": "Kontakte aus dem Telefonbuch der Organisation."
    },
    {
      "name": "Termine",
      "description": "Termine aus dem Kalender der Organisation."
    },
    {
      "name": "Webhooks",
      "description": "Ereignisse, die Speakki an die am Assistenten hinterlegte URL sendet."
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/calls": {
      "post": {
        "operationId": "createCall",
        "tags": [
          "Anrufe"
        ],
        "summary": "Anruf starten",
        "description": "Legt einen ausgehenden Anruf an. Der Assistent ruft sofort an oder zum geplanten Zeitpunkt. Abgelehnte Anfragen legen keinen Anruf an, der Fehlercode nennt den Grund.\n\n**Geprüft wird:** Tarif und Freischaltung, Abrechnung, Assistent und Absender, Zielnummer (nur Deutschland, Österreich, Schweiz, keine Sonder- und Mehrwertnummern), Sperrliste und gesperrte Kontakte, Werte für alle Platzhalter, Anrufzeiten (Montag bis Samstag, 8 bis 20 Uhr, in deutscher Zeit), Tageslimit und höchstens ein Anruf je Nummer und Tag.\n\n**Ein Anruf je Nummer und Tag** (`number_called_today`): Gezählt werden andere Anrufe an dieselbe Nummer am selben Kalendertag, die nicht abgebrochen oder abgelehnt wurden. Wiederholversuche desselben Anrufs zählen nicht.\n\n**Tageslimit** (`daily_limit_reached`): Gezählt werden die Wählversuche der Organisation am Kalendertag, also auch jede Wiederholung. Ist das Limit beim Anlegen erreicht, wird die Anfrage abgelehnt. Ist es erst beim Wählen erreicht, wird der Anruf auf den nächsten Tag verschoben.\n\n**Variablen:** Alle `variables` gehen als Angaben an den Assistenten, auch solche ohne Platzhalter in Begrüßung oder Auftrag. Senden Sie nur, was der Assistent wissen darf.\n\n**Idempotency-Key:** Mit dem Header `Idempotency-Key` legt eine wiederholte Anfrage keinen zweiten Anruf an. Der Schlüssel gilt je Organisation (über alle API-Schlüssel hinweg) und ohne zeitliche Grenze. Kommt derselbe Schlüssel mit derselben Anfrage erneut, liefert die API den schon angelegten Anruf mit Status 200 zurück. Kommt er mit einer anderen Anfrage (anderes Ziel, anderer Assistent, andere Variablen, Metadaten, Zeiten oder Versuche), antwortet die API mit 409 und dem Code `conflict` und legt nichts an. Verglichen wird der Inhalt, nicht die Schreibweise: die Reihenfolge der Felder und die Schreibweise der Nummer spielen keine Rolle. Eine abgelehnte Anfrage belegt den Schlüssel nicht.\n\nBerechtigung: `calls:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Frei gewählter Schlüssel je Auftrag, gilt je Organisation und ohne zeitliche Grenze. Dieselbe Anfrage mit demselben Schlüssel legt keinen zweiten Anruf an, sondern liefert den vorhandenen (Status 200). Eine andere Anfrage mit demselben Schlüssel wird mit 409 `conflict` abgelehnt.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCallRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Es gab schon einen Anruf mit diesem Idempotency-Key. Er wird unverändert zurückgegeben.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Call"
                }
              }
            }
          },
          "201": {
            "description": "Anruf angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Call"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  },
                  "access_not_approved": {
                    "value": {
                      "error": {
                        "code": "access_not_approved",
                        "message": "Ausgehende Anrufe sind für diese Organisation noch nicht freigeschaltet."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "assistant_not_found": {
                    "value": {
                      "error": {
                        "code": "assistant_not_found",
                        "message": "Dieser Assistent wurde nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Passt nicht zum aktuellen Zustand.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "value": {
                      "error": {
                        "code": "conflict",
                        "message": "Die Anfrage passt nicht zum aktuellen Zustand."
                      }
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Die Anfrage ist zu groß (Body über 1 MB). Code `invalid_request`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "415": {
            "description": "Falscher Content-Type. Senden Sie JSON als `application/json`. Code `invalid_request`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Fachlich abgelehnt. Der Code nennt den Grund.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "billing_blocked": {
                    "value": {
                      "error": {
                        "code": "billing_blocked",
                        "message": "Anrufe sind gerade nicht möglich. Bitte prüfen Sie Tarif und Zahlung."
                      }
                    }
                  },
                  "assistant_outbound_disabled": {
                    "value": {
                      "error": {
                        "code": "assistant_outbound_disabled",
                        "message": "Für diesen Assistenten sind ausgehende Anrufe nicht eingeschaltet."
                      }
                    }
                  },
                  "from_number_missing": {
                    "value": {
                      "error": {
                        "code": "from_number_missing",
                        "message": "Für diesen Assistenten ist keine Absendernummer hinterlegt."
                      }
                    }
                  },
                  "from_number_not_allowed": {
                    "value": {
                      "error": {
                        "code": "from_number_not_allowed",
                        "message": "Als Absender sind nur eigene, aktive Rufnummern möglich."
                      }
                    }
                  },
                  "invalid_number": {
                    "value": {
                      "error": {
                        "code": "invalid_number",
                        "message": "Bitte geben Sie eine gültige Telefonnummer an, zum Beispiel +49 171 2345678."
                      }
                    }
                  },
                  "country_not_allowed": {
                    "value": {
                      "error": {
                        "code": "country_not_allowed",
                        "message": "Ausgehende Anrufe sind nur nach Deutschland, Österreich und in die Schweiz möglich."
                      }
                    }
                  },
                  "special_number": {
                    "value": {
                      "error": {
                        "code": "special_number",
                        "message": "Sonder- und Mehrwertnummern können nicht angerufen werden."
                      }
                    }
                  },
                  "own_number": {
                    "value": {
                      "error": {
                        "code": "own_number",
                        "message": "Eigene Rufnummern können nicht angerufen werden."
                      }
                    }
                  },
                  "suppressed": {
                    "value": {
                      "error": {
                        "code": "suppressed",
                        "message": "Diese Nummer steht auf der Sperrliste und wird nicht mehr angerufen."
                      }
                    }
                  },
                  "contact_blocked": {
                    "value": {
                      "error": {
                        "code": "contact_blocked",
                        "message": "Dieser Kontakt ist gesperrt."
                      }
                    }
                  },
                  "outside_call_hours": {
                    "value": {
                      "error": {
                        "code": "outside_call_hours",
                        "message": "Außerhalb der Anrufzeiten sind keine Anrufe möglich."
                      }
                    }
                  },
                  "daily_limit_reached": {
                    "value": {
                      "error": {
                        "code": "daily_limit_reached",
                        "message": "Das Tageslimit für ausgehende Anrufe ist erreicht."
                      }
                    }
                  },
                  "number_called_today": {
                    "value": {
                      "error": {
                        "code": "number_called_today",
                        "message": "Diese Nummer wurde heute bereits angerufen."
                      }
                    }
                  },
                  "missing_variables": {
                    "value": {
                      "error": {
                        "code": "missing_variables",
                        "message": "Es fehlen Werte für Variablen in Begrüßung oder Auftrag."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCalls",
        "tags": [
          "Anrufe"
        ],
        "summary": "Anrufe auflisten",
        "description": "Ausgehende Anrufe der Organisation, neueste zuerst. Blättern über `cursor`.\n\nBerechtigung: `calls:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Nur Anrufe in diesem Status.",
            "schema": {
              "type": "string",
              "enum": [
                "queued",
                "dialing",
                "in_progress",
                "completed",
                "not_reached",
                "canceled",
                "blocked"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Anrufe je Seite, 1 bis 100, Standard 25.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "campaign_id",
            "in": "query",
            "required": false,
            "description": "Nur Anrufe dieser Kampagne.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next_cursor` der vorigen Seite.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Eine Seite Anrufe.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CallList"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/calls/{id}": {
      "get": {
        "operationId": "getCall",
        "tags": [
          "Anrufe"
        ],
        "summary": "Anruf abrufen",
        "description": "Ein Anruf mit Status und allen Versuchen.\n\nBerechtigung: `calls:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID des Anrufs.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Der Anruf.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Call"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/calls/{id}/cancel": {
      "post": {
        "operationId": "cancelCall",
        "tags": [
          "Anrufe"
        ],
        "summary": "Anruf abbrechen",
        "description": "Bricht einen wartenden Anruf ab (Status `queued`). Läuft der Anruf schon oder ist er abgeschlossen, antwortet die API mit 409.\n\nBerechtigung: `calls:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID des Anrufs.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Der abgebrochene Anruf.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Call"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Passt nicht zum aktuellen Zustand.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "value": {
                      "error": {
                        "code": "conflict",
                        "message": "Die Anfrage passt nicht zum aktuellen Zustand."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/campaigns": {
      "post": {
        "operationId": "createCampaign",
        "tags": [
          "Kampagnen"
        ],
        "summary": "Kampagne anlegen",
        "description": "Legt eine Kampagne mit einer festen Empfängerliste an: entweder `recipients` oder eine Kontaktliste aus dem Dashboard. Ungültige Empfänger werden nicht übernommen und in `rejected_recipients` gemeldet, doppelte Nummern nur einmal. Mit `start: true` läuft die Kampagne sofort los, sonst bleibt sie ein Entwurf. Der Assistent ruft die Empfänger nacheinander an, mit der eingestellten Pause dazwischen. Für jeden Empfänger gelten dieselben Grenzen wie für einen einzelnen Anruf. Höchstens 5 Kampagnen laufen gleichzeitig.\n\nBerechtigung: `campaigns:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCampaignRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Kampagne angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CampaignCreated"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  },
                  "access_not_approved": {
                    "value": {
                      "error": {
                        "code": "access_not_approved",
                        "message": "Ausgehende Anrufe sind für diese Organisation noch nicht freigeschaltet."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "assistant_not_found": {
                    "value": {
                      "error": {
                        "code": "assistant_not_found",
                        "message": "Dieser Assistent wurde nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Passt nicht zum aktuellen Zustand.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "value": {
                      "error": {
                        "code": "conflict",
                        "message": "Die Anfrage passt nicht zum aktuellen Zustand."
                      }
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Die Anfrage ist zu groß (Body über 1 MB). Code `invalid_request`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "415": {
            "description": "Falscher Content-Type. Senden Sie JSON als `application/json`. Code `invalid_request`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Fachlich abgelehnt. Der Code nennt den Grund.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "from_number_not_allowed": {
                    "value": {
                      "error": {
                        "code": "from_number_not_allowed",
                        "message": "Als Absender sind nur eigene, aktive Rufnummern möglich."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCampaigns",
        "tags": [
          "Kampagnen"
        ],
        "summary": "Kampagnen auflisten",
        "description": "Kampagnen der Organisation mit Zählern, neueste zuerst.\n\nBerechtigung: `campaigns:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Nur Kampagnen in diesem Status.",
            "schema": {
              "type": "string",
              "enum": [
                "draft",
                "scheduled",
                "running",
                "paused",
                "completed",
                "canceled"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Kampagnen je Seite, 1 bis 100, Standard 25.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next_cursor` der vorigen Seite.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Eine Seite Kampagnen.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CampaignList"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/campaigns/{id}": {
      "get": {
        "operationId": "getCampaign",
        "tags": [
          "Kampagnen"
        ],
        "summary": "Kampagne abrufen",
        "description": "Eine Kampagne mit Stand und Zählern.\n\nBerechtigung: `campaigns:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID der Kampagne.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Kampagne.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Campaign"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/campaigns/{id}/recipients": {
      "get": {
        "operationId": "listCampaignRecipients",
        "tags": [
          "Kampagnen"
        ],
        "summary": "Empfänger einer Kampagne auflisten",
        "description": "Empfänger in Listenreihenfolge mit Stand, Ergebnis und dem zugehörigen Anruf.\n\nBerechtigung: `campaigns:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID der Kampagne.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Nur Empfänger in diesem Status.",
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "queued",
                "done",
                "skipped"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Empfänger je Seite, 1 bis 100, Standard 25.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next_cursor` der vorigen Seite.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Eine Seite Empfänger.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CampaignRecipientList"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/campaigns/{id}/start": {
      "post": {
        "operationId": "startCampaign",
        "tags": [
          "Kampagnen"
        ],
        "summary": "Kampagne starten",
        "description": "Startet einen Entwurf: sofort oder zum geplanten Zeitpunkt (`start_at`). Die Einwilligung der Empfänger haben Sie beim Anlegen bestätigt.\n\nBerechtigung: `campaigns:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID der Kampagne.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Kampagne.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Campaign"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  },
                  "access_not_approved": {
                    "value": {
                      "error": {
                        "code": "access_not_approved",
                        "message": "Ausgehende Anrufe sind für diese Organisation noch nicht freigeschaltet."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Passt nicht zum aktuellen Zustand.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "value": {
                      "error": {
                        "code": "conflict",
                        "message": "Die Anfrage passt nicht zum aktuellen Zustand."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/campaigns/{id}/pause": {
      "post": {
        "operationId": "pauseCampaign",
        "tags": [
          "Kampagnen"
        ],
        "summary": "Kampagne pausieren",
        "description": "Pausiert eine laufende oder geplante Kampagne. Es wird kein weiterer Empfänger angerufen, ein laufendes Gespräch läuft zu Ende.\n\nBerechtigung: `campaigns:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID der Kampagne.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Kampagne.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Campaign"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Passt nicht zum aktuellen Zustand.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "value": {
                      "error": {
                        "code": "conflict",
                        "message": "Die Anfrage passt nicht zum aktuellen Zustand."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/campaigns/{id}/resume": {
      "post": {
        "operationId": "resumeCampaign",
        "tags": [
          "Kampagnen"
        ],
        "summary": "Kampagne fortsetzen",
        "description": "Setzt eine pausierte Kampagne beim nächsten Empfänger fort.\n\nBerechtigung: `campaigns:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID der Kampagne.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Kampagne.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Campaign"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  },
                  "access_not_approved": {
                    "value": {
                      "error": {
                        "code": "access_not_approved",
                        "message": "Ausgehende Anrufe sind für diese Organisation noch nicht freigeschaltet."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Passt nicht zum aktuellen Zustand.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "value": {
                      "error": {
                        "code": "conflict",
                        "message": "Die Anfrage passt nicht zum aktuellen Zustand."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/campaigns/{id}/cancel": {
      "post": {
        "operationId": "cancelCampaign",
        "tags": [
          "Kampagnen"
        ],
        "summary": "Kampagne abbrechen",
        "description": "Bricht eine Kampagne endgültig ab. Offene Empfänger werden übersprungen, wartende Anrufe abgebrochen. Ein laufendes Gespräch läuft zu Ende.\n\nBerechtigung: `campaigns:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID der Kampagne.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Kampagne.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Campaign"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Passt nicht zum aktuellen Zustand.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "value": {
                      "error": {
                        "code": "conflict",
                        "message": "Die Anfrage passt nicht zum aktuellen Zustand."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/suppressions": {
      "get": {
        "operationId": "listSuppressions",
        "tags": [
          "Sperrliste"
        ],
        "summary": "Sperrliste abrufen",
        "description": "Nummern, die Ihre Organisation nie ausgehend anruft, neueste zuerst. Blättern über `cursor` wie bei den anderen Listen.\n\nBerechtigung: `calls:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Einträge je Seite, 1 bis 100, Standard 25.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next_cursor` der vorigen Seite.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Die Sperrliste.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SuppressionList"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createSuppression",
        "tags": [
          "Sperrliste"
        ],
        "summary": "Nummer sperren",
        "description": "Setzt eine Nummer auf die Sperrliste. Steht sie schon dort, bleibt der vorhandene Eintrag und kommt unverändert zurück.\n\nBerechtigung: `suppressions:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSuppressionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Der Eintrag.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Suppression"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Die Anfrage ist zu groß (Body über 1 MB). Code `invalid_request`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "415": {
            "description": "Falscher Content-Type. Senden Sie JSON als `application/json`. Code `invalid_request`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Fachlich abgelehnt. Der Code nennt den Grund.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_number": {
                    "value": {
                      "error": {
                        "code": "invalid_number",
                        "message": "Bitte geben Sie eine gültige Telefonnummer an, zum Beispiel +49 171 2345678."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/suppressions/{id}": {
      "delete": {
        "operationId": "deleteSuppression",
        "tags": [
          "Sperrliste"
        ],
        "summary": "Sperre aufheben",
        "description": "Entfernt einen Eintrag von der Sperrliste.\n\nBerechtigung: `suppressions:write`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID des Eintrags der Sperrliste.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Entfernt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deleted"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/assistants": {
      "get": {
        "operationId": "listAssistants",
        "tags": [
          "Assistenten"
        ],
        "summary": "Assistenten auflisten",
        "description": "Assistenten, bei denen ausgehende Anrufe eingeschaltet sind und eine Absendernummer hinterlegt ist.\n\nBerechtigung: `calls:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Die Assistenten.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssistantList"
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/phone-numbers": {
      "get": {
        "operationId": "listPhoneNumbers",
        "tags": [
          "Rufnummern"
        ],
        "summary": "Rufnummern auflisten",
        "description": "Eigene, aktive Rufnummern, die als Absender möglich sind.\n\nBerechtigung: `calls:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Die Rufnummern.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PhoneNumberList"
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/conversations": {
      "get": {
        "operationId": "listConversations",
        "tags": [
          "Gespräche"
        ],
        "summary": "Gespräche auflisten",
        "description": "Geführte Telefongespräche Ihrer Assistenten, eingehend und ausgehend, neueste zuerst. Mit Zusammenfassung, Einordnung und erfassten Daten, ohne Transkript. `GET /v1/calls` zeigt dagegen die Aufträge für ausgehende Anrufe, auch solche ohne Gespräch.\n\nBerechtigung: `calls:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "direction",
            "in": "query",
            "required": false,
            "description": "Nur eingehende oder nur ausgehende Gespräche.",
            "schema": {
              "type": "string",
              "enum": [
                "inbound",
                "outbound"
              ]
            }
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Beginn ab diesem Zeitpunkt (einschließlich).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Beginn vor diesem Zeitpunkt (ausschließlich).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Gespräche je Seite, 1 bis 100, Standard 25.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next_cursor` der vorigen Seite.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Eine Seite Gespräche.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationList"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/conversations/{id}": {
      "get": {
        "operationId": "getConversation",
        "tags": [
          "Gespräche"
        ],
        "summary": "Gespräch abrufen",
        "description": "Ein Gespräch mit Transkript. Das Transkript ist nur enthalten, wenn für das Gespräch die Aufzeichnung aktiv war und die Löschfrist nicht abgelaufen ist, sonst `null`.\n\nBerechtigung: `calls:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID des Gesprächs.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Das Gespräch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationDetail"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/contacts": {
      "get": {
        "operationId": "listContacts",
        "tags": [
          "Kontakte"
        ],
        "summary": "Kontakte auflisten",
        "description": "Kontakte der Organisation, neueste zuerst. Mit `phone` finden Sie den Kontakt zu einer Rufnummer, mit `q` suchen Sie in Name, Firma, Rufnummer und E-Mail. Verworfene Kontakte und Teammitglieder sind nicht enthalten.\n\nBerechtigung: `contacts:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "phone",
            "in": "query",
            "required": false,
            "description": "Genau diese Rufnummer. Deutsche Schreibweisen werden umgerechnet (0170… wird +49170…).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 32
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Suche in Name, Firma, Rufnummer und E-Mail.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Kontakte je Seite, 1 bis 100, Standard 25.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next_cursor` der vorigen Seite.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Eine Seite Kontakte.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContactList"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/contacts/{id}": {
      "get": {
        "operationId": "getContact",
        "tags": [
          "Kontakte"
        ],
        "summary": "Kontakt abrufen",
        "description": "Ein Kontakt mit seinen Stammdaten.\n\nBerechtigung: `contacts:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID des Kontakts.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Der Kontakt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Contact"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/appointments": {
      "get": {
        "operationId": "listAppointments",
        "tags": [
          "Termine"
        ],
        "summary": "Termine auflisten",
        "description": "Termine aus dem Kalender der Organisation, nach Beginn aufsteigend. Mit `from` und `to` grenzen Sie den Zeitraum ein.\n\nBerechtigung: `appointments:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Beginn ab diesem Zeitpunkt (einschließlich).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Beginn vor diesem Zeitpunkt (ausschließlich).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Nur Termine in diesem Status.",
            "schema": {
              "type": "string",
              "enum": [
                "planned",
                "done",
                "canceled"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Termine je Seite, 1 bis 100, Standard 25.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next_cursor` der vorigen Seite.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Eine Seite Termine.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppointmentList"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/appointments/{id}": {
      "get": {
        "operationId": "getAppointment",
        "tags": [
          "Termine"
        ],
        "summary": "Termin abrufen",
        "description": "Ein Termin mit Leistung und Bezug zu Kontakt und Gespräch.\n\nBerechtigung: `appointments:read`.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID des Termins.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Der Termin.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Appointment"
                }
              }
            }
          },
          "400": {
            "description": "Ungültige Anfrage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "invalid_request": {
                    "value": {
                      "error": {
                        "code": "invalid_request",
                        "message": "Die Anfrage ist ungültig."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "API-Schlüssel fehlt oder ist ungültig.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": {
                        "code": "unauthorized",
                        "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“."
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "insufficient_scope": {
                    "value": {
                      "error": {
                        "code": "insufficient_scope",
                        "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage."
                      }
                    }
                  },
                  "plan_required": {
                    "value": {
                      "error": {
                        "code": "plan_required",
                        "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten."
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Nicht gefunden.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "value": {
                      "error": {
                        "code": "not_found",
                        "message": "Nicht gefunden."
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `retry-after` und `x-ratelimit-reset` nennen die Sekunden, bis wieder Anfragen möglich sind.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "rate_limited": {
                    "value": {
                      "error": {
                        "code": "rate_limited",
                        "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal."
                      }
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Interner Fehler.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "value": {
                      "error": {
                        "code": "internal_error",
                        "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "webhooks": {
    "call.ended": {
      "post": {
        "operationId": "webhook_call_ended",
        "tags": [
          "Webhooks"
        ],
        "summary": "Gespräch beendet",
        "description": "Nach jedem geführten Gespräch eines veröffentlichten Assistenten, eingehend und ausgehend, mit Zusammenfassung, erfassten Daten und Transkript (soweit die Aufzeichnung aktiv war).\n\nSpeakki sendet das Ereignis als POST mit JSON an die URL, die am Assistenten hinterlegt ist. Nur für veröffentlichte Assistenten mit eingeschaltetem Webhook. Antwortet Ihr Server nicht mit 2xx, wird die Zustellung mit wachsendem Abstand wiederholt. Prüfen Sie die Signatur im Header `Speakki-Signature` (HMAC-SHA256 mit dem Secret des Webhooks über `<t>.<roher Body>`), und nutzen Sie `Speakki-Delivery-Id`, um doppelte Zustellungen zu erkennen.",
        "security": [],
        "parameters": [
          {
            "name": "Speakki-Event",
            "in": "header",
            "required": true,
            "description": "Name des Ereignisses.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Speakki-Delivery-Id",
            "in": "header",
            "required": true,
            "description": "ID der Zustellung. Bleibt bei Wiederholungen gleich und eignet sich zum Erkennen doppelter Zustellungen.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Speakki-Signature",
            "in": "header",
            "required": true,
            "description": "`t=<Unix-Zeit>,v1=<Hex>`: HMAC-SHA256 mit dem Secret des Webhooks über `<t>.<roher Body>`.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CallEndedEvent"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Jede Antwort mit Status 2xx gilt als zugestellt. Der Inhalt der Antwort wird nicht gelesen."
          }
        }
      }
    },
    "outbound_call.finished": {
      "post": {
        "operationId": "webhook_outbound_call_finished",
        "tags": [
          "Webhooks"
        ],
        "summary": "Ausgehender Anruf abgeschlossen",
        "description": "Genau einmal je ausgehendem Anruf, sobald er abgeschlossen ist: `completed`, `not_reached`, `blocked` oder `canceled`. Kommt auch ohne Gespräch. Zwischen zwei Versuchen feuert es nicht.\n\nSpeakki sendet das Ereignis als POST mit JSON an die URL, die am Assistenten hinterlegt ist. Nur für veröffentlichte Assistenten mit eingeschaltetem Webhook. Antwortet Ihr Server nicht mit 2xx, wird die Zustellung mit wachsendem Abstand wiederholt. Prüfen Sie die Signatur im Header `Speakki-Signature` (HMAC-SHA256 mit dem Secret des Webhooks über `<t>.<roher Body>`), und nutzen Sie `Speakki-Delivery-Id`, um doppelte Zustellungen zu erkennen.",
        "security": [],
        "parameters": [
          {
            "name": "Speakki-Event",
            "in": "header",
            "required": true,
            "description": "Name des Ereignisses.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Speakki-Delivery-Id",
            "in": "header",
            "required": true,
            "description": "ID der Zustellung. Bleibt bei Wiederholungen gleich und eignet sich zum Erkennen doppelter Zustellungen.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Speakki-Signature",
            "in": "header",
            "required": true,
            "description": "`t=<Unix-Zeit>,v1=<Hex>`: HMAC-SHA256 mit dem Secret des Webhooks über `<t>.<roher Body>`.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OutboundCallFinishedEvent"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Jede Antwort mit Status 2xx gilt als zugestellt. Der Inhalt der Antwort wird nicht gelesen."
          }
        }
      }
    },
    "outbound_campaign.finished": {
      "post": {
        "operationId": "webhook_outbound_campaign_finished",
        "tags": [
          "Webhooks"
        ],
        "summary": "Kampagne abgeschlossen",
        "description": "Genau einmal je Kampagne, sobald sie abgeschlossen (`completed`) oder abgebrochen (`canceled`) ist, mit den Zählern der Empfänger.\n\nSpeakki sendet das Ereignis als POST mit JSON an die URL, die am Assistenten hinterlegt ist. Nur für veröffentlichte Assistenten mit eingeschaltetem Webhook. Antwortet Ihr Server nicht mit 2xx, wird die Zustellung mit wachsendem Abstand wiederholt. Prüfen Sie die Signatur im Header `Speakki-Signature` (HMAC-SHA256 mit dem Secret des Webhooks über `<t>.<roher Body>`), und nutzen Sie `Speakki-Delivery-Id`, um doppelte Zustellungen zu erkennen.",
        "security": [],
        "parameters": [
          {
            "name": "Speakki-Event",
            "in": "header",
            "required": true,
            "description": "Name des Ereignisses.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Speakki-Delivery-Id",
            "in": "header",
            "required": true,
            "description": "ID der Zustellung. Bleibt bei Wiederholungen gleich und eignet sich zum Erkennen doppelter Zustellungen.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Speakki-Signature",
            "in": "header",
            "required": true,
            "description": "`t=<Unix-Zeit>,v1=<Hex>`: HMAC-SHA256 mit dem Secret des Webhooks über `<t>.<roher Body>`.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OutboundCampaignFinishedEvent"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Jede Antwort mit Status 2xx gilt als zugestellt. Der Inhalt der Antwort wird nicht gelesen."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "API-Schlüssel der Organisation, beginnt mit `spk_live_`."
      }
    },
    "schemas": {
      "Appointment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID des Termins."
          },
          "type": {
            "type": "string",
            "enum": [
              "appointment",
              "callback_deadline",
              "other"
            ],
            "description": "`appointment` Termin, `callback_deadline` Frist für einen Rückruf, `other` sonstiger Eintrag."
          },
          "status": {
            "type": "string",
            "enum": [
              "planned",
              "done",
              "canceled"
            ],
            "description": "`planned` geplant, `done` erledigt, `canceled` abgesagt."
          },
          "title": {
            "type": "string",
            "description": "Titel des Termins."
          },
          "customer_name": {
            "type": "string",
            "description": "Name, auf den der Termin läuft."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Notiz zum Termin."
          },
          "starts_at": {
            "type": "string",
            "format": "date-time",
            "description": "Beginn des Termins."
          },
          "ends_at": {
            "type": "string",
            "format": "date-time",
            "description": "Ende des Termins."
          },
          "service": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "ID der Leistung."
                  },
                  "name": {
                    "type": "string",
                    "description": "Name der Leistung."
                  }
                },
                "required": [
                  "id",
                  "name"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "Gebuchte Leistung, falls vorhanden."
          },
          "party_size": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Personenzahl bei Reservierungen."
          },
          "contact_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kontakt des Termins (`GET /v1/contacts/{id}`)."
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Gespräch, in dem der Termin entstand (`GET /v1/conversations/{id}`)."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Angelegt am."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Zuletzt geändert am."
          }
        },
        "required": [
          "id",
          "type",
          "status",
          "title",
          "customer_name",
          "description",
          "starts_at",
          "ends_at",
          "service",
          "party_size",
          "contact_id",
          "conversation_id",
          "created_at",
          "updated_at"
        ],
        "additionalProperties": false,
        "description": "Ein Termin aus dem Kalender der Organisation.",
        "examples": [
          {
            "id": "e5b1d7a3-8c2f-4e6a-9d0b-3f7c1a5e8b42",
            "type": "appointment",
            "status": "planned",
            "title": "Heizungswartung",
            "customer_name": "Max Mustermann",
            "description": null,
            "starts_at": "2026-11-20T09:00:00.000Z",
            "ends_at": "2026-11-20T10:00:00.000Z",
            "service": {
              "id": "f2c4a6e8-1b3d-4f5a-8c7e-0a9b2d4f6e83",
              "name": "Wartung"
            },
            "party_size": null,
            "contact_id": "a4d2c8e6-5f1b-4a3d-8c7e-9b0f2d4a6c81",
            "conversation_id": "c1a7e3f9-2b4d-4c6e-9f8a-0d3b5e7a9c21",
            "created_at": "2026-11-16T09:02:50.000Z",
            "updated_at": "2026-11-16T09:02:50.000Z"
          }
        ]
      },
      "AppointmentList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Appointment"
            },
            "description": "Die Einträge dieser Seite."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Für die nächste Seite als `cursor` senden. `null` = keine weitere Seite."
          }
        },
        "required": [
          "data",
          "next_cursor"
        ],
        "additionalProperties": false,
        "description": "Eine Seite Termine, nach Beginn aufsteigend."
      },
      "Assistant": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID des Assistenten, für `assistant_id`."
          },
          "name": {
            "type": "string",
            "description": "Name, wie er im Dashboard steht. Tragen mehrere Assistenten denselben Namen, steht die Rolle dahinter (zum Beispiel „Mia · Empfang“)."
          },
          "from_number": {
            "type": "string",
            "description": "Absendernummer des Assistenten in E.164."
          },
          "variables": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Namen der Platzhalter in Begrüßung und Auftrag. Für jeden ist beim Anlegen ein Wert nötig."
          }
        },
        "required": [
          "id",
          "name",
          "from_number",
          "variables"
        ],
        "additionalProperties": false,
        "description": "Assistent, der für ausgehende Anrufe bereit ist.",
        "examples": [
          {
            "id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44",
            "name": "Mia · Terminerinnerung",
            "from_number": "+493023125010",
            "variables": [
              "name"
            ]
          }
        ]
      },
      "AssistantList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Assistant"
            },
            "description": "Die Einträge dieser Seite."
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false,
        "description": "Alle Assistenten, die für ausgehende Anrufe bereit sind."
      },
      "Call": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID des Anrufs."
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "dialing",
              "in_progress",
              "completed",
              "not_reached",
              "canceled",
              "blocked"
            ],
            "description": "`queued` wartet (auch zwischen zwei Versuchen), `dialing` klingelt, `in_progress` Gespräch läuft, `completed` Gespräch geführt, `not_reached` alle Versuche ohne Gespräch, `canceled` abgebrochen, `blocked` vor dem Wählen abgelehnt."
          },
          "block_reason": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "plan_required",
                  "access_not_approved",
                  "billing_blocked",
                  "assistant_not_found",
                  "assistant_outbound_disabled",
                  "from_number_missing",
                  "from_number_not_allowed",
                  "invalid_number",
                  "country_not_allowed",
                  "special_number",
                  "own_number",
                  "suppressed",
                  "contact_blocked",
                  "outside_call_hours",
                  "daily_limit_reached",
                  "number_called_today",
                  "missing_variables"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Grund der Ablehnung, nur bei `blocked`."
          },
          "to": {
            "type": "string",
            "description": "Zielnummer in E.164."
          },
          "from": {
            "type": "string",
            "description": "Absendernummer in E.164."
          },
          "assistant_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Assistent, der das Gespräch führt (`GET /v1/assistants`)."
          },
          "campaign_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kampagne, zu der der Anruf gehört, sonst `null`."
          },
          "variables": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Werte für die Platzhalter in Begrüßung und Auftrag."
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {},
            "description": "Ihre freien Daten, unverändert zurückgegeben."
          },
          "scheduled_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Geplanter Start, `null` bei sofortigem Anruf."
          },
          "next_attempt_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Frühester Zeitpunkt des nächsten Versuchs."
          },
          "max_attempts": {
            "type": "integer",
            "description": "Versuche insgesamt, die für diesen Anruf erlaubt sind."
          },
          "attempt_count": {
            "type": "integer",
            "description": "Bisherige Wählversuche."
          },
          "last_result": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "answered",
                  "no_answer",
                  "busy",
                  "voicemail",
                  "failed"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Ergebnis des letzten Versuchs. `answered` Gespräch geführt, `no_answer` nicht abgenommen, `busy` besetzt, `voicemail` Mailbox erkannt und aufgelegt, `failed` technisch fehlgeschlagen."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Auftrag angelegt am."
          },
          "finished_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abgeschlossen am. `null`, solange der Anruf offen ist."
          },
          "attempts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CallAttempt"
            },
            "description": "Alle Wählversuche in ihrer Reihenfolge."
          }
        },
        "required": [
          "id",
          "status",
          "block_reason",
          "to",
          "from",
          "assistant_id",
          "campaign_id",
          "variables",
          "metadata",
          "scheduled_at",
          "next_attempt_at",
          "max_attempts",
          "attempt_count",
          "last_result",
          "created_at",
          "finished_at",
          "attempts"
        ],
        "additionalProperties": false,
        "description": "Ein ausgehender Anruf (Auftrag) mit seinen Versuchen.",
        "examples": [
          {
            "id": "0b1d7c2e-6a0f-4d0b-9a55-2f4f8f1c7e10",
            "status": "completed",
            "block_reason": null,
            "to": "+4915228817386",
            "from": "+493023125010",
            "assistant_id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44",
            "campaign_id": null,
            "variables": {
              "name": "Frau Meier"
            },
            "metadata": {
              "kundennummer": "4711"
            },
            "scheduled_at": null,
            "next_attempt_at": null,
            "max_attempts": 2,
            "attempt_count": 1,
            "last_result": "answered",
            "created_at": "2026-11-16T09:00:00.000Z",
            "finished_at": "2026-11-16T09:02:10.000Z",
            "attempts": [
              {
                "number": 1,
                "result": "answered",
                "started_at": "2026-11-16T09:00:02.000Z",
                "ended_at": "2026-11-16T09:02:10.000Z",
                "duration_seconds": 118
              }
            ]
          }
        ]
      },
      "CallAttempt": {
        "type": "object",
        "properties": {
          "number": {
            "type": "integer",
            "description": "Nummer des Versuchs, beginnend bei 1."
          },
          "result": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "answered",
                  "no_answer",
                  "busy",
                  "voicemail",
                  "failed"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Ergebnis des Versuchs. `null`, solange er läuft."
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "description": "Beginn des Wählens."
          },
          "ended_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ende des Versuchs. `null`, solange er läuft."
          },
          "duration_seconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dauer des Gesprächs in Sekunden, nur bei einem Gespräch."
          }
        },
        "required": [
          "number",
          "result",
          "started_at",
          "ended_at",
          "duration_seconds"
        ],
        "additionalProperties": false,
        "description": "Ein Wählversuch."
      },
      "CallEndedEvent": {
        "type": "object",
        "properties": {
          "version": {
            "type": "number",
            "const": 1,
            "description": "Version der Payload."
          },
          "event": {
            "type": "string",
            "const": "call.ended",
            "description": "Name des Ereignisses."
          },
          "deliveryId": {
            "type": "string",
            "description": "ID der Zustellung, bleibt über Wiederholungen gleich (auch im Header `Speakki-Delivery-Id`)."
          },
          "occurredAt": {
            "type": "string",
            "format": "date-time",
            "description": "Zeitpunkt der Zustellung."
          },
          "test": {
            "type": "boolean",
            "description": "`true` beim Testereignis aus dem Dashboard, sonst `false`."
          },
          "organization": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid",
                "description": "ID der Organisation."
              },
              "name": {
                "description": "Name der Organisation.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "name"
            ],
            "additionalProperties": false,
            "description": "Die Organisation."
          },
          "agent": {
            "type": "object",
            "properties": {
              "id": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uuid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ID des Assistenten."
              },
              "name": {
                "description": "Technischer Name des Assistenten.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "name"
            ],
            "additionalProperties": false,
            "description": "Der Assistent, der das Gespräch geführt hat."
          },
          "call": {
            "type": "object",
            "properties": {
              "interactionId": {
                "type": "string",
                "format": "uuid",
                "description": "ID des Gesprächs, dieselbe wie `id` in `GET /v1/conversations/{id}`."
              },
              "callId": {
                "type": "string",
                "format": "uuid",
                "description": "Interne ID des Telefonats."
              },
              "direction": {
                "type": "string",
                "enum": [
                  "INBOUND",
                  "OUTBOUND"
                ],
                "description": "`INBOUND` eingehend, `OUTBOUND` ausgehend."
              },
              "outboundCallId": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uuid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Bei ausgehenden Gesprächen im Kundenauftrag der Anruf aus `GET /v1/calls/{id}`, sonst `null`."
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "description": "Beginn des Gesprächs."
              },
              "endedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Ende des Gesprächs."
              },
              "durationSec": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Dauer in Sekunden."
              },
              "callerName": {
                "description": "Name des Gesprächspartners, falls bekannt.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "callerPhone": {
                "description": "Nummer des Gesprächspartners in E.164.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": "string",
                "description": "Bearbeitungsstand im Posteingang: `OPEN`, `IN_PROGRESS`, `DONE` oder `ARCHIVED`."
              },
              "category": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "slug": {
                        "type": "string",
                        "description": "Fester Schlüssel der Einordnung."
                      },
                      "label": {
                        "type": "string",
                        "description": "Bezeichnung der Einordnung."
                      }
                    },
                    "required": [
                      "slug",
                      "label"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Einordnung des Gesprächs."
              },
              "summary": {
                "description": "Zusammenfassung des Gesprächs.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "dashboardUrl": {
                "type": "string",
                "description": "Link zum Gespräch im Dashboard."
              }
            },
            "required": [
              "interactionId",
              "callId",
              "direction",
              "outboundCallId",
              "startedAt",
              "endedAt",
              "durationSec",
              "callerName",
              "callerPhone",
              "status",
              "category",
              "summary",
              "dashboardUrl"
            ],
            "additionalProperties": false,
            "description": "Das Gespräch."
          },
          "contact": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "ID des Kontakts."
                  },
                  "name": {
                    "description": "Name der Person.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "company": {
                    "description": "Firma.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "phone": {
                    "description": "Rufnummer in E.164.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "email": {
                    "description": "E-Mail-Adresse.",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "id",
                  "name",
                  "company",
                  "phone",
                  "email"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "Kontakt des Gesprächspartners, falls zugeordnet."
          },
          "outcomes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "category": {
                  "type": "string",
                  "description": "Fester Schlüssel des Ergebnisses."
                },
                "label": {
                  "type": "string",
                  "description": "Bezeichnung des Ergebnisses."
                },
                "toolName": {
                  "description": "Fähigkeit des Assistenten, die das Ergebnis erzeugt hat.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "caseKey": {
                  "description": "Nur bei „Anliegen aufnehmen“: Schlüssel des Falls.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "caseName": {
                  "description": "Nur bei „Anliegen aufnehmen“: Name des Falls.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "occurredAt": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Zeitpunkt des Ergebnisses."
                }
              },
              "required": [
                "category",
                "label",
                "toolName",
                "caseKey",
                "caseName",
                "occurredAt"
              ],
              "additionalProperties": false
            },
            "description": "Ergebnisse des Gesprächs, zum Beispiel ein gebuchter Termin."
          },
          "capturedData": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "toolName": {
                  "type": "string",
                  "description": "Name der Erfassung im Assistenten."
                },
                "label": {
                  "description": "Bezeichnung der Erfassung.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "caseKey": {
                  "description": "Nur bei „Anliegen aufnehmen“: Schlüssel des Falls.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "caseName": {
                  "description": "Nur bei „Anliegen aufnehmen“: Name des Falls.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "incomplete": {
                  "type": "boolean",
                  "description": "`true`, wenn der Anrufer vor den letzten Angaben aufgelegt hat."
                },
                "capturedAt": {
                  "type": "string",
                  "description": "Zeitpunkt der Erfassung."
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "Name des Felds."
                      },
                      "type": {
                        "description": "Typ des Felds, zum Beispiel `string`.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "value": {
                        "description": "Der erfasste Wert."
                      }
                    },
                    "required": [
                      "name",
                      "type",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "description": "Die erfassten Angaben."
                }
              },
              "required": [
                "toolName",
                "label",
                "caseKey",
                "caseName",
                "incomplete",
                "capturedAt",
                "fields"
              ],
              "additionalProperties": false
            },
            "description": "Daten, die der Assistent im Gespräch erfasst hat."
          },
          "transcript": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "role": {
                      "type": "string",
                      "enum": [
                        "assistant",
                        "user"
                      ],
                      "description": "`assistant` der Assistent, `user` der Gesprächspartner."
                    },
                    "content": {
                      "type": "string",
                      "description": "Der gesprochene Text."
                    },
                    "timestamp": {
                      "description": "Zeitpunkt der Äußerung, falls bekannt.",
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "role",
                    "content",
                    "timestamp"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Der gesprochene Dialog. `null`, wenn für das Gespräch die Aufzeichnung nicht aktiv war."
          }
        },
        "required": [
          "version",
          "event",
          "deliveryId",
          "occurredAt",
          "test",
          "organization",
          "agent",
          "call",
          "contact",
          "outcomes",
          "capturedData",
          "transcript"
        ],
        "additionalProperties": false,
        "description": "Webhook-Ereignis nach jedem geführten Gespräch (eingehend und ausgehend). Feldnamen in camelCase, anders als bei den übrigen Objekten dieser API."
      },
      "CallList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Call"
            },
            "description": "Die Einträge dieser Seite."
          },
          "next_cursor": {
            "description": "Für die nächste Seite als `cursor` senden. `null` = keine weitere Seite.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor"
        ],
        "additionalProperties": false,
        "description": "Eine Seite Anrufe, neueste zuerst."
      },
      "CallWindow": {
        "type": "object",
        "properties": {
          "days": {
            "minItems": 1,
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": 1,
              "maximum": 6
            },
            "description": "Wochentage, 1 = Montag bis 6 = Samstag."
          },
          "from": {
            "type": "string",
            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
            "description": "Beginn in deutscher Zeit, frühestens 08:00."
          },
          "to": {
            "type": "string",
            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
            "description": "Ende in deutscher Zeit, spätestens 20:00."
          }
        },
        "required": [
          "days",
          "from",
          "to"
        ],
        "additionalProperties": false,
        "description": "Anrufzeiten der Kampagne. Nur innerhalb von Montag bis Samstag, 8 bis 20 Uhr, und innerhalb der Anrufzeiten der Organisation.",
        "examples": [
          {
            "days": [
              1,
              2,
              3,
              4,
              5
            ],
            "from": "09:00",
            "to": "17:00"
          }
        ]
      },
      "Campaign": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID der Kampagne."
          },
          "name": {
            "type": "string",
            "description": "Name der Kampagne."
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "scheduled",
              "running",
              "paused",
              "completed",
              "canceled"
            ],
            "description": "`draft` Entwurf, `scheduled` Start geplant, `running` läuft, `paused` pausiert, `completed` alle Empfänger erledigt, `canceled` abgebrochen."
          },
          "assistant_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Assistent, der die Empfänger anruft."
          },
          "from_number_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Eigene Absendernummer der Kampagne, sonst `null` (dann gilt die des Assistenten)."
          },
          "from_number": {
            "description": "Absender in E.164.",
            "type": [
              "string",
              "null"
            ]
          },
          "contact_list_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kontaktliste, aus der die Empfänger kopiert wurden."
          },
          "variables": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Namen der Variablen, die die Empfänger mitbringen."
          },
          "missing_variables": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Platzhalter des Assistenten, für die die Empfänger keinen Wert haben. Solche Empfänger werden übersprungen."
          },
          "start_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Geplanter Start. `null` = beim Starten sofort."
          },
          "call_window": {
            "$ref": "#/components/schemas/CallWindow"
          },
          "pause_seconds": {
            "type": "integer",
            "description": "Pause zwischen zwei Empfängern in Sekunden."
          },
          "max_attempts": {
            "type": "integer",
            "description": "Versuche je Empfänger."
          },
          "retry_delay_minutes": {
            "type": "integer",
            "description": "Abstand zwischen zwei Versuchen in Minuten."
          },
          "contact_source": {
            "type": "string",
            "description": "Herkunft der Kontakte, wie beim Anlegen angegeben."
          },
          "consent_confirmed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Zeitpunkt, zu dem die Einwilligung der Empfänger beim Start bestätigt wurde."
          },
          "next_dispatch_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Frühester Zeitpunkt für den nächsten Empfänger."
          },
          "started_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tatsächlicher Start. `null` vor dem Start."
          },
          "completed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abgeschlossen oder abgebrochen am. `null`, solange die Kampagne offen ist."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Angelegt am."
          },
          "counts": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer",
                "description": "Alle Empfänger der Kampagne."
              },
              "pending": {
                "type": "integer",
                "description": "Noch nicht angerufen."
              },
              "queued": {
                "type": "integer",
                "description": "Anruf läuft oder wartet auf den nächsten Versuch."
              },
              "reached": {
                "type": "integer",
                "description": "Gespräch geführt."
              },
              "not_reached": {
                "type": "integer",
                "description": "Anruf beendet ohne Gespräch."
              },
              "skipped": {
                "type": "integer",
                "description": "Nie angerufen (Sperrliste, gesperrter Kontakt, ungültig oder Kampagne abgebrochen)."
              }
            },
            "required": [
              "total",
              "pending",
              "queued",
              "reached",
              "not_reached",
              "skipped"
            ],
            "additionalProperties": false,
            "description": "Empfänger nach Stand."
          }
        },
        "required": [
          "id",
          "name",
          "status",
          "assistant_id",
          "from_number_id",
          "from_number",
          "contact_list_id",
          "variables",
          "missing_variables",
          "start_at",
          "call_window",
          "pause_seconds",
          "max_attempts",
          "retry_delay_minutes",
          "contact_source",
          "consent_confirmed_at",
          "next_dispatch_at",
          "started_at",
          "completed_at",
          "created_at",
          "counts"
        ],
        "additionalProperties": false,
        "description": "Eine Kampagne: eine feste Empfängerliste, die der Assistent nacheinander anruft.",
        "examples": [
          {
            "id": "3f8a2b1c-9d4e-4a6f-8b2c-1e5d7f9a0b3c",
            "name": "Terminerinnerung November",
            "status": "running",
            "assistant_id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44",
            "from_number_id": null,
            "from_number": "+493023125010",
            "contact_list_id": null,
            "variables": [
              "name",
              "termin"
            ],
            "missing_variables": [],
            "start_at": null,
            "call_window": {
              "days": [
                1,
                2,
                3,
                4,
                5
              ],
              "from": "09:00",
              "to": "17:00"
            },
            "pause_seconds": 30,
            "max_attempts": 2,
            "retry_delay_minutes": 120,
            "contact_source": "Bestandskunden mit Einwilligung aus dem Kundenportal",
            "consent_confirmed_at": "2026-11-16T08:55:00.000Z",
            "next_dispatch_at": "2026-11-16T09:03:00.000Z",
            "started_at": "2026-11-16T08:55:00.000Z",
            "completed_at": null,
            "created_at": "2026-11-16T08:50:00.000Z",
            "counts": {
              "total": 120,
              "pending": 97,
              "queued": 1,
              "reached": 15,
              "not_reached": 5,
              "skipped": 2
            }
          }
        ]
      },
      "CampaignCreated": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID der Kampagne."
          },
          "name": {
            "type": "string",
            "description": "Name der Kampagne."
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "scheduled",
              "running",
              "paused",
              "completed",
              "canceled"
            ],
            "description": "`draft` Entwurf, `scheduled` Start geplant, `running` läuft, `paused` pausiert, `completed` alle Empfänger erledigt, `canceled` abgebrochen."
          },
          "assistant_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Assistent, der die Empfänger anruft."
          },
          "from_number_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Eigene Absendernummer der Kampagne, sonst `null` (dann gilt die des Assistenten)."
          },
          "from_number": {
            "description": "Absender in E.164.",
            "type": [
              "string",
              "null"
            ]
          },
          "contact_list_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kontaktliste, aus der die Empfänger kopiert wurden."
          },
          "variables": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Namen der Variablen, die die Empfänger mitbringen."
          },
          "missing_variables": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Platzhalter des Assistenten, für die die Empfänger keinen Wert haben. Solche Empfänger werden übersprungen."
          },
          "start_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Geplanter Start. `null` = beim Starten sofort."
          },
          "call_window": {
            "$ref": "#/components/schemas/CallWindow"
          },
          "pause_seconds": {
            "type": "integer",
            "description": "Pause zwischen zwei Empfängern in Sekunden."
          },
          "max_attempts": {
            "type": "integer",
            "description": "Versuche je Empfänger."
          },
          "retry_delay_minutes": {
            "type": "integer",
            "description": "Abstand zwischen zwei Versuchen in Minuten."
          },
          "contact_source": {
            "type": "string",
            "description": "Herkunft der Kontakte, wie beim Anlegen angegeben."
          },
          "consent_confirmed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Zeitpunkt, zu dem die Einwilligung der Empfänger beim Start bestätigt wurde."
          },
          "next_dispatch_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Frühester Zeitpunkt für den nächsten Empfänger."
          },
          "started_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tatsächlicher Start. `null` vor dem Start."
          },
          "completed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abgeschlossen oder abgebrochen am. `null`, solange die Kampagne offen ist."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Angelegt am."
          },
          "counts": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer",
                "description": "Alle Empfänger der Kampagne."
              },
              "pending": {
                "type": "integer",
                "description": "Noch nicht angerufen."
              },
              "queued": {
                "type": "integer",
                "description": "Anruf läuft oder wartet auf den nächsten Versuch."
              },
              "reached": {
                "type": "integer",
                "description": "Gespräch geführt."
              },
              "not_reached": {
                "type": "integer",
                "description": "Anruf beendet ohne Gespräch."
              },
              "skipped": {
                "type": "integer",
                "description": "Nie angerufen (Sperrliste, gesperrter Kontakt, ungültig oder Kampagne abgebrochen)."
              }
            },
            "required": [
              "total",
              "pending",
              "queued",
              "reached",
              "not_reached",
              "skipped"
            ],
            "additionalProperties": false,
            "description": "Empfänger nach Stand."
          },
          "rejected_recipients": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "line": {
                  "type": "integer",
                  "description": "Position in `recipients` (ab 1) bzw. in der Kontaktliste."
                },
                "reason": {
                  "type": "string",
                  "enum": [
                    "missing_number",
                    "invalid_number",
                    "country_not_allowed",
                    "special_number",
                    "value_too_long",
                    "invalid_variables"
                  ],
                  "description": "`missing_number` Nummer fehlt, `invalid_number` keine gültige Nummer, `country_not_allowed` nicht Deutschland, Österreich oder Schweiz, `special_number` Sonder- oder Mehrwertnummer, `value_too_long` ein Wert über 500 Zeichen, `invalid_variables` ungültiger Variablenname."
                },
                "value": {
                  "type": "string",
                  "description": "Der beanstandete Wert, gekürzt."
                }
              },
              "required": [
                "line",
                "reason",
                "value"
              ],
              "additionalProperties": false
            },
            "description": "Empfänger, die nicht übernommen wurden (ungültige Nummer, anderes Land, Sondernummer)."
          },
          "duplicate_recipients": {
            "type": "integer",
            "description": "Einträge mit einer Nummer, die schon vorkam."
          }
        },
        "required": [
          "id",
          "name",
          "status",
          "assistant_id",
          "from_number_id",
          "from_number",
          "contact_list_id",
          "variables",
          "missing_variables",
          "start_at",
          "call_window",
          "pause_seconds",
          "max_attempts",
          "retry_delay_minutes",
          "contact_source",
          "consent_confirmed_at",
          "next_dispatch_at",
          "started_at",
          "completed_at",
          "created_at",
          "counts",
          "rejected_recipients",
          "duplicate_recipients"
        ],
        "additionalProperties": false,
        "description": "Die angelegte Kampagne, dazu die Empfänger, die nicht übernommen wurden."
      },
      "CampaignList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Campaign"
            },
            "description": "Die Einträge dieser Seite."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Für die nächste Seite als `cursor` senden. `null` = keine weitere Seite."
          }
        },
        "required": [
          "data",
          "next_cursor"
        ],
        "additionalProperties": false,
        "description": "Eine Seite Kampagnen, neueste zuerst."
      },
      "CampaignRecipient": {
        "type": "object",
        "properties": {
          "position": {
            "type": "integer",
            "description": "Platz in der Liste, ab 1."
          },
          "to": {
            "type": "string",
            "description": "Zielnummer in E.164."
          },
          "variables": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Werte für die Platzhalter des Assistenten."
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "queued",
              "done",
              "skipped"
            ],
            "description": "`pending` noch nicht angerufen, `queued` Anruf angelegt, `done` Anruf beendet, `skipped` nie angerufen."
          },
          "skip_reason": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "plan_required",
                  "access_not_approved",
                  "billing_blocked",
                  "assistant_not_found",
                  "assistant_outbound_disabled",
                  "from_number_missing",
                  "from_number_not_allowed",
                  "invalid_number",
                  "country_not_allowed",
                  "special_number",
                  "own_number",
                  "suppressed",
                  "contact_blocked",
                  "outside_call_hours",
                  "daily_limit_reached",
                  "number_called_today",
                  "missing_variables"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Grund bei `skipped`, falls bekannt."
          },
          "last_result": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "answered",
                  "no_answer",
                  "busy",
                  "voicemail",
                  "failed"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Ergebnis des letzten Versuchs, sobald es einen gab. `answered` Gespräch geführt, `no_answer` nicht abgenommen, `busy` besetzt, `voicemail` Mailbox erkannt und aufgelegt, `failed` technisch fehlgeschlagen."
          },
          "attempt_count": {
            "type": "integer",
            "description": "Bisherige Wählversuche für diesen Empfänger."
          },
          "call_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Anruf dieses Empfängers (`GET /v1/calls/{id}`)."
          }
        },
        "required": [
          "position",
          "to",
          "variables",
          "status",
          "skip_reason",
          "last_result",
          "attempt_count",
          "call_id"
        ],
        "additionalProperties": false,
        "description": "Ein Empfänger einer Kampagne."
      },
      "CampaignRecipientList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignRecipient"
            },
            "description": "Die Einträge dieser Seite."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Für die nächste Seite als `cursor` senden. `null` = keine weitere Seite."
          }
        },
        "required": [
          "data",
          "next_cursor"
        ],
        "additionalProperties": false,
        "description": "Eine Seite Empfänger in Listenreihenfolge."
      },
      "Contact": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID des Kontakts."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der Person."
          },
          "company": {
            "type": [
              "string",
              "null"
            ],
            "description": "Firma."
          },
          "phone": {
            "type": "string",
            "description": "Rufnummer in E.164."
          },
          "email": {
            "type": [
              "string",
              "null"
            ],
            "description": "E-Mail-Adresse."
          },
          "notes": {
            "description": "Notiz am Kontakt.",
            "type": [
              "string",
              "null"
            ]
          },
          "calls_blocked": {
            "type": "boolean",
            "description": "`true`, wenn eingehende Anrufe dieses Kontakts gesperrt sind."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Angelegt am."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Zuletzt geändert am."
          }
        },
        "required": [
          "id",
          "name",
          "company",
          "phone",
          "email",
          "notes",
          "calls_blocked",
          "created_at",
          "updated_at"
        ],
        "additionalProperties": false,
        "description": "Ein Kontakt aus dem Telefonbuch der Organisation.",
        "examples": [
          {
            "id": "a4d2c8e6-5f1b-4a3d-8c7e-9b0f2d4a6c81",
            "name": "Max Mustermann",
            "company": "Mustermann Haustechnik",
            "phone": "+4915228817386",
            "email": "max@example.com",
            "notes": null,
            "calls_blocked": false,
            "created_at": "2026-10-02T10:15:00.000Z",
            "updated_at": "2026-11-16T09:03:00.000Z"
          }
        ]
      },
      "ContactList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contact"
            },
            "description": "Die Einträge dieser Seite."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Für die nächste Seite als `cursor` senden. `null` = keine weitere Seite."
          }
        },
        "required": [
          "data",
          "next_cursor"
        ],
        "additionalProperties": false,
        "description": "Eine Seite Kontakte, neueste zuerst."
      },
      "Conversation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID des Gesprächs (dieselbe wie `interactionId` im Webhook)."
          },
          "direction": {
            "type": "string",
            "enum": [
              "inbound",
              "outbound"
            ],
            "description": "`inbound` eingehend, `outbound` ausgehend."
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "description": "Beginn des Gesprächs."
          },
          "ended_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ende des Gesprächs."
          },
          "duration_seconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dauer in Sekunden."
          },
          "phone_number": {
            "description": "Nummer des Gesprächspartners in E.164: der Anrufer bei eingehenden, das Ziel bei ausgehenden Gesprächen. `null` bei unterdrückter Nummer.",
            "type": [
              "string",
              "null"
            ]
          },
          "own_number": {
            "description": "Ihre Rufnummer: die angerufene Nummer bei eingehenden, der Absender bei ausgehenden Gesprächen.",
            "type": [
              "string",
              "null"
            ]
          },
          "caller_name": {
            "description": "Name des Gesprächspartners, falls bekannt.",
            "type": [
              "string",
              "null"
            ]
          },
          "assistant_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Assistent, der das Gespräch führt (`GET /v1/assistants`)."
          },
          "assistant_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name des Assistenten, wie er im Dashboard steht."
          },
          "contact_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kontakt des Gesprächspartners (`GET /v1/contacts/{id}`)."
          },
          "status": {
            "type": "string",
            "enum": [
              "open",
              "in_progress",
              "done",
              "archived"
            ],
            "description": "Bearbeitungsstand im Posteingang."
          },
          "category": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string",
                    "description": "Fester Schlüssel der Einordnung."
                  },
                  "label": {
                    "type": "string",
                    "description": "Bezeichnung der Einordnung."
                  }
                },
                "required": [
                  "slug",
                  "label"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "Einordnung des Gesprächs."
          },
          "summary": {
            "description": "Zusammenfassung des Gesprächs.",
            "type": [
              "string",
              "null"
            ]
          },
          "captured_data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tool_name": {
                  "type": "string",
                  "description": "Name der Erfassung im Assistenten."
                },
                "label": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Bezeichnung der Erfassung."
                },
                "case_key": {
                  "description": "Nur bei „Anliegen aufnehmen“: Schlüssel des Falls.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "case_name": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Nur bei „Anliegen aufnehmen“: Name des Falls."
                },
                "incomplete": {
                  "type": "boolean",
                  "description": "`true`, wenn der Anrufer vor den letzten Angaben aufgelegt hat."
                },
                "captured_at": {
                  "type": "string",
                  "description": "Zeitpunkt der Erfassung."
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "Name des Felds."
                      },
                      "type": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Typ des Felds, zum Beispiel `string` oder `boolean`."
                      },
                      "value": {
                        "description": "Der erfasste Wert, Typ je Feld."
                      }
                    },
                    "required": [
                      "name",
                      "type",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "description": "Die erfassten Angaben."
                }
              },
              "required": [
                "tool_name",
                "label",
                "case_key",
                "case_name",
                "incomplete",
                "captured_at",
                "fields"
              ],
              "additionalProperties": false
            },
            "description": "Daten, die der Assistent im Gespräch erfasst hat."
          },
          "outbound_call_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Bei ausgehenden Gesprächen im Kundenauftrag der Anruf aus `GET /v1/calls/{id}`."
          },
          "content_deleted": {
            "type": "boolean",
            "description": "`true`, wenn Inhalte nach Ablauf der Löschfrist entfernt wurden (Zusammenfassung, erfasste Daten, Transkript)."
          }
        },
        "required": [
          "id",
          "direction",
          "started_at",
          "ended_at",
          "duration_seconds",
          "phone_number",
          "own_number",
          "caller_name",
          "assistant_id",
          "assistant_name",
          "contact_id",
          "status",
          "category",
          "summary",
          "captured_data",
          "outbound_call_id",
          "content_deleted"
        ],
        "additionalProperties": false,
        "description": "Ein geführtes Telefongespräch, eingehend oder ausgehend, ohne Transkript.",
        "examples": [
          {
            "id": "c1a7e3f9-2b4d-4c6e-9f8a-0d3b5e7a9c21",
            "direction": "inbound",
            "started_at": "2026-11-16T09:00:00.000Z",
            "ended_at": "2026-11-16T09:03:00.000Z",
            "duration_seconds": 180,
            "phone_number": "+4915228817386",
            "own_number": "+493023125010",
            "caller_name": "Max Mustermann",
            "assistant_id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44",
            "assistant_name": "Empfang",
            "contact_id": "a4d2c8e6-5f1b-4a3d-8c7e-9b0f2d4a6c81",
            "status": "open",
            "category": {
              "slug": "REQUEST_RECORDED",
              "label": "Anliegen aufgenommen"
            },
            "summary": "Herr Mustermann möchte ein Angebot für die jährliche Heizungswartung und bittet um Rückruf.",
            "captured_data": [
              {
                "tool_name": "rueckruf_erfassen",
                "label": "Rückrufwunsch erfassen",
                "case_key": null,
                "case_name": null,
                "incomplete": false,
                "captured_at": "2026-11-16T09:02:40.000Z",
                "fields": [
                  {
                    "name": "name",
                    "type": "string",
                    "value": "Max Mustermann"
                  }
                ]
              }
            ],
            "outbound_call_id": null,
            "content_deleted": false
          }
        ]
      },
      "ConversationDetail": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID des Gesprächs (dieselbe wie `interactionId` im Webhook)."
          },
          "direction": {
            "type": "string",
            "enum": [
              "inbound",
              "outbound"
            ],
            "description": "`inbound` eingehend, `outbound` ausgehend."
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "description": "Beginn des Gesprächs."
          },
          "ended_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ende des Gesprächs."
          },
          "duration_seconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dauer in Sekunden."
          },
          "phone_number": {
            "description": "Nummer des Gesprächspartners in E.164: der Anrufer bei eingehenden, das Ziel bei ausgehenden Gesprächen. `null` bei unterdrückter Nummer.",
            "type": [
              "string",
              "null"
            ]
          },
          "own_number": {
            "description": "Ihre Rufnummer: die angerufene Nummer bei eingehenden, der Absender bei ausgehenden Gesprächen.",
            "type": [
              "string",
              "null"
            ]
          },
          "caller_name": {
            "description": "Name des Gesprächspartners, falls bekannt.",
            "type": [
              "string",
              "null"
            ]
          },
          "assistant_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Assistent, der das Gespräch führt (`GET /v1/assistants`)."
          },
          "assistant_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name des Assistenten, wie er im Dashboard steht."
          },
          "contact_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kontakt des Gesprächspartners (`GET /v1/contacts/{id}`)."
          },
          "status": {
            "type": "string",
            "enum": [
              "open",
              "in_progress",
              "done",
              "archived"
            ],
            "description": "Bearbeitungsstand im Posteingang."
          },
          "category": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string",
                    "description": "Fester Schlüssel der Einordnung."
                  },
                  "label": {
                    "type": "string",
                    "description": "Bezeichnung der Einordnung."
                  }
                },
                "required": [
                  "slug",
                  "label"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "Einordnung des Gesprächs."
          },
          "summary": {
            "description": "Zusammenfassung des Gesprächs.",
            "type": [
              "string",
              "null"
            ]
          },
          "captured_data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tool_name": {
                  "type": "string",
                  "description": "Name der Erfassung im Assistenten."
                },
                "label": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Bezeichnung der Erfassung."
                },
                "case_key": {
                  "description": "Nur bei „Anliegen aufnehmen“: Schlüssel des Falls.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "case_name": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Nur bei „Anliegen aufnehmen“: Name des Falls."
                },
                "incomplete": {
                  "type": "boolean",
                  "description": "`true`, wenn der Anrufer vor den letzten Angaben aufgelegt hat."
                },
                "captured_at": {
                  "type": "string",
                  "description": "Zeitpunkt der Erfassung."
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "Name des Felds."
                      },
                      "type": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Typ des Felds, zum Beispiel `string` oder `boolean`."
                      },
                      "value": {
                        "description": "Der erfasste Wert, Typ je Feld."
                      }
                    },
                    "required": [
                      "name",
                      "type",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "description": "Die erfassten Angaben."
                }
              },
              "required": [
                "tool_name",
                "label",
                "case_key",
                "case_name",
                "incomplete",
                "captured_at",
                "fields"
              ],
              "additionalProperties": false
            },
            "description": "Daten, die der Assistent im Gespräch erfasst hat."
          },
          "outbound_call_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "description": "Bei ausgehenden Gesprächen im Kundenauftrag der Anruf aus `GET /v1/calls/{id}`."
          },
          "content_deleted": {
            "type": "boolean",
            "description": "`true`, wenn Inhalte nach Ablauf der Löschfrist entfernt wurden (Zusammenfassung, erfasste Daten, Transkript)."
          },
          "transcript": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "role": {
                      "type": "string",
                      "enum": [
                        "assistant",
                        "user"
                      ],
                      "description": "`assistant` der Assistent, `user` der Gesprächspartner."
                    },
                    "content": {
                      "type": "string",
                      "description": "Der gesprochene Text."
                    },
                    "timestamp": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Zeitpunkt der Äußerung, falls bekannt."
                    }
                  },
                  "required": [
                    "role",
                    "content",
                    "timestamp"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Der gesprochene Dialog. `null`, wenn für dieses Gespräch die Aufzeichnung nicht aktiv war oder die Inhalte gelöscht sind. Gleiche Regel wie im Dashboard und im Webhook `call.ended`."
          }
        },
        "required": [
          "id",
          "direction",
          "started_at",
          "ended_at",
          "duration_seconds",
          "phone_number",
          "own_number",
          "caller_name",
          "assistant_id",
          "assistant_name",
          "contact_id",
          "status",
          "category",
          "summary",
          "captured_data",
          "outbound_call_id",
          "content_deleted",
          "transcript"
        ],
        "additionalProperties": false,
        "description": "Ein Gespräch mit Transkript, soweit es sichtbar ist.",
        "examples": [
          {
            "id": "c1a7e3f9-2b4d-4c6e-9f8a-0d3b5e7a9c21",
            "direction": "inbound",
            "started_at": "2026-11-16T09:00:00.000Z",
            "ended_at": "2026-11-16T09:03:00.000Z",
            "duration_seconds": 180,
            "phone_number": "+4915228817386",
            "own_number": "+493023125010",
            "caller_name": "Max Mustermann",
            "assistant_id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44",
            "assistant_name": "Empfang",
            "contact_id": "a4d2c8e6-5f1b-4a3d-8c7e-9b0f2d4a6c81",
            "status": "open",
            "category": {
              "slug": "REQUEST_RECORDED",
              "label": "Anliegen aufgenommen"
            },
            "summary": "Herr Mustermann möchte ein Angebot für die jährliche Heizungswartung und bittet um Rückruf.",
            "captured_data": [
              {
                "tool_name": "rueckruf_erfassen",
                "label": "Rückrufwunsch erfassen",
                "case_key": null,
                "case_name": null,
                "incomplete": false,
                "captured_at": "2026-11-16T09:02:40.000Z",
                "fields": [
                  {
                    "name": "name",
                    "type": "string",
                    "value": "Max Mustermann"
                  }
                ]
              }
            ],
            "outbound_call_id": null,
            "content_deleted": false,
            "transcript": [
              {
                "role": "assistant",
                "content": "Guten Tag, wie kann ich helfen?",
                "timestamp": "2026-11-16T09:00:02.000Z"
              },
              {
                "role": "user",
                "content": "Ich hätte gern ein Angebot für die Heizungswartung.",
                "timestamp": "2026-11-16T09:00:08.000Z"
              }
            ]
          }
        ]
      },
      "ConversationList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Conversation"
            },
            "description": "Die Einträge dieser Seite."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Für die nächste Seite als `cursor` senden. `null` = keine weitere Seite."
          }
        },
        "required": [
          "data",
          "next_cursor"
        ],
        "additionalProperties": false,
        "description": "Eine Seite Gespräche, neueste zuerst."
      },
      "CreateCallRequest": {
        "type": "object",
        "properties": {
          "assistant_id": {
            "type": "string",
            "format": "uuid",
            "description": "Assistent, der anruft (aus `GET /v1/assistants`)."
          },
          "to": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Zielnummer, am besten in E.164 (+49…). Nur Deutschland, Österreich und Schweiz, keine Sonder- und Mehrwertnummern."
          },
          "from_number_id": {
            "description": "Absender aus `GET /v1/phone-numbers`. Ohne Angabe gilt die Absendernummer des Assistenten.",
            "type": "string",
            "format": "uuid"
          },
          "variables": {
            "description": "Werte für die Platzhalter des Assistenten, z. B. {\"name\": \"Frau Meier\"}. Höchstens 30 Einträge.",
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "maxLength": 500
            }
          },
          "metadata": {
            "description": "Freie Daten, höchstens 4096 Bytes als JSON. Sie kommen im Call-Objekt und im Webhook zurück.",
            "type": "object",
            "additionalProperties": {}
          },
          "scheduled_at": {
            "description": "Geplanter Start (ISO 8601), höchstens 30 Tage voraus und innerhalb der Anrufzeiten. Ohne Angabe oder mit `null` startet der Anruf sofort.",
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "max_attempts": {
            "description": "Versuche insgesamt, Standard 1.",
            "type": "integer",
            "minimum": 1,
            "maximum": 3
          },
          "retry_delay_minutes": {
            "description": "Abstand zwischen zwei Versuchen in Minuten, Standard 120.",
            "type": "integer",
            "minimum": 120,
            "maximum": 10080
          }
        },
        "required": [
          "assistant_id",
          "to"
        ],
        "additionalProperties": false,
        "description": "Auftrag für einen ausgehenden Anruf.",
        "examples": [
          {
            "assistant_id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44",
            "to": "+4915228817386",
            "variables": {
              "name": "Frau Meier"
            },
            "metadata": {
              "kundennummer": "4711"
            },
            "max_attempts": 2
          }
        ]
      },
      "CreateCampaignRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "Name der Kampagne, höchstens 80 Zeichen."
          },
          "assistant_id": {
            "type": "string",
            "format": "uuid",
            "description": "Assistent, der anruft (aus `GET /v1/assistants`)."
          },
          "from_number_id": {
            "description": "Ohne Angabe gilt die Absendernummer des Assistenten.",
            "type": "string",
            "format": "uuid"
          },
          "recipients": {
            "description": "Empfänger in der Reihenfolge der Anrufe, höchstens 2000. Entweder `recipients` oder `contact_list_id`.",
            "minItems": 1,
            "maxItems": 2000,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "to": {
                  "type": "string",
                  "description": "Zielnummer, am besten in E.164."
                },
                "variables": {
                  "description": "Werte für die Platzhalter des Assistenten.",
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "to"
              ],
              "additionalProperties": false
            }
          },
          "contact_list_id": {
            "description": "Kontaktliste aus dem Dashboard. Die Kontakte werden beim Anlegen kopiert, Variablen sind `name`, `firma` und `email`.",
            "type": "string",
            "format": "uuid"
          },
          "start_at": {
            "description": "Geplanter Start (ISO 8601). Ohne Angabe oder mit `null` beginnt die Kampagne beim Starten sofort.",
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "call_window": {
            "$ref": "#/components/schemas/CallWindow"
          },
          "pause_seconds": {
            "description": "Pause zwischen zwei Empfängern in Sekunden, Standard 30.",
            "type": "integer",
            "minimum": 10,
            "maximum": 600
          },
          "max_attempts": {
            "description": "Versuche je Empfänger, Standard 1.",
            "type": "integer",
            "minimum": 1,
            "maximum": 3
          },
          "retry_delay_minutes": {
            "type": "integer",
            "minimum": 120,
            "maximum": 10080,
            "description": "Abstand zwischen zwei Versuchen in Minuten, Standard 120."
          },
          "contact_source": {
            "type": "string",
            "minLength": 10,
            "maxLength": 500,
            "description": "Herkunft der Kontakte, zum Beispiel „Bestandskunden“."
          },
          "consent_confirmed": {
            "type": "boolean",
            "const": true,
            "description": "Muss `true` sein: Sie bestätigen, dass alle Empfänger dem Anruf zugestimmt haben."
          },
          "start": {
            "description": "`true` startet die Kampagne sofort nach dem Anlegen, sonst bleibt sie ein Entwurf.",
            "type": "boolean"
          }
        },
        "required": [
          "name",
          "assistant_id",
          "contact_source",
          "consent_confirmed"
        ],
        "additionalProperties": false,
        "description": "Neue Kampagne mit Empfängern.",
        "examples": [
          {
            "name": "Terminerinnerung November",
            "assistant_id": "5e2a9c1b-7f43-4c1d-8b0a-3d9e6f2a1c44",
            "recipients": [
              {
                "to": "+4915228817386",
                "variables": {
                  "name": "Frau Meier",
                  "termin": "Dienstag"
                }
              },
              {
                "to": "+491729925904",
                "variables": {
                  "name": "Herr Kurz",
                  "termin": "Mittwoch"
                }
              }
            ],
            "call_window": {
              "days": [
                1,
                2,
                3,
                4,
                5
              ],
              "from": "09:00",
              "to": "17:00"
            },
            "max_attempts": 2,
            "contact_source": "Bestandskunden mit Einwilligung aus dem Kundenportal",
            "consent_confirmed": true,
            "start": true
          }
        ]
      },
      "CreateSuppressionRequest": {
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Nummer, die nicht mehr angerufen werden soll."
          },
          "reason": {
            "description": "Freier Vermerk, nur für Sie.",
            "type": "string",
            "maxLength": 200
          }
        },
        "required": [
          "number"
        ],
        "additionalProperties": false,
        "examples": [
          {
            "number": "+4915228817386",
            "reason": "Widerspruch per E-Mail"
          }
        ],
        "description": "Nummer, die auf die Sperrliste soll."
      },
      "Deleted": {
        "type": "object",
        "properties": {
          "deleted": {
            "type": "boolean",
            "const": true,
            "description": "Immer `true`."
          }
        },
        "required": [
          "deleted"
        ],
        "additionalProperties": false,
        "description": "Bestätigung, dass der Eintrag entfernt wurde."
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "unauthorized",
                  "insufficient_scope",
                  "invalid_request",
                  "not_found",
                  "conflict",
                  "rate_limited",
                  "internal_error",
                  "plan_required",
                  "access_not_approved",
                  "billing_blocked",
                  "assistant_not_found",
                  "assistant_outbound_disabled",
                  "from_number_missing",
                  "from_number_not_allowed",
                  "invalid_number",
                  "country_not_allowed",
                  "special_number",
                  "own_number",
                  "suppressed",
                  "contact_blocked",
                  "outside_call_hours",
                  "daily_limit_reached",
                  "number_called_today",
                  "missing_variables"
                ],
                "description": "Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht."
              },
              "message": {
                "type": "string",
                "description": "Meldung für Menschen, auf Deutsch."
              },
              "details": {
                "description": "Zusatz je Code, z. B. `fields` bei `invalid_request` oder `missing_variables` bei `missing_variables`.",
                "type": "object",
                "additionalProperties": {}
              }
            },
            "required": [
              "code",
              "message"
            ],
            "additionalProperties": false,
            "description": "Der Fehler."
          }
        },
        "required": [
          "error"
        ],
        "additionalProperties": false,
        "description": "Einheitliches Fehlerformat aller Antworten unter /v1.",
        "examples": [
          {
            "error": {
              "code": "outside_call_hours",
              "message": "Außerhalb der Anrufzeiten sind keine Anrufe möglich."
            }
          }
        ]
      },
      "OutboundCallFinishedEvent": {
        "type": "object",
        "properties": {
          "event": {
            "type": "string",
            "const": "outbound_call.finished",
            "description": "Name des Ereignisses."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Zeitpunkt des Abschlusses."
          },
          "data": {
            "$ref": "#/components/schemas/Call"
          }
        },
        "required": [
          "event",
          "created_at",
          "data"
        ],
        "additionalProperties": false,
        "description": "Webhook-Ereignis, sobald ein ausgehender Anruf abgeschlossen ist (completed, not_reached, blocked oder canceled). Genau einmal je Anruf."
      },
      "OutboundCampaignFinishedEvent": {
        "type": "object",
        "properties": {
          "event": {
            "type": "string",
            "const": "outbound_campaign.finished",
            "description": "Name des Ereignisses."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Zeitpunkt des Abschlusses."
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          }
        },
        "required": [
          "event",
          "created_at",
          "data"
        ],
        "additionalProperties": false,
        "description": "Webhook-Ereignis, sobald eine Kampagne abgeschlossen (completed) oder abgebrochen (canceled) ist. Genau einmal je Kampagne."
      },
      "PhoneNumber": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID der Rufnummer, für `from_number_id`."
          },
          "number": {
            "type": "string",
            "description": "Rufnummer in E.164."
          },
          "label": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bezeichnung der Rufnummer im Dashboard."
          }
        },
        "required": [
          "id",
          "number",
          "label"
        ],
        "additionalProperties": false,
        "description": "Eigene Rufnummer, die als Absender möglich ist.",
        "examples": [
          {
            "id": "9c4f1d2a-3b6e-4f70-8a1c-5d2e7b9f0a31",
            "number": "+493023125010",
            "label": "Zentrale"
          }
        ]
      },
      "PhoneNumberList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PhoneNumber"
            },
            "description": "Die Einträge dieser Seite."
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false,
        "description": "Alle eigenen Rufnummern, die als Absender möglich sind."
      },
      "Suppression": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID des Eintrags."
          },
          "number": {
            "type": "string",
            "description": "Gesperrte Nummer in E.164."
          },
          "source": {
            "type": "string",
            "enum": [
              "assistant",
              "manual",
              "api"
            ],
            "description": "`assistant` im Gespräch gewünscht, `manual` im Dashboard eingetragen, `api` über die API."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ihr Vermerk zum Eintrag, falls vorhanden."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Gesperrt seit."
          }
        },
        "required": [
          "id",
          "number",
          "source",
          "reason",
          "created_at"
        ],
        "additionalProperties": false,
        "description": "Eintrag der Sperrliste: diese Nummer wird nie ausgehend angerufen.",
        "examples": [
          {
            "id": "7b2e4c9a-1f3d-4e8b-9a6c-2d5f8e1b4a7c",
            "number": "+4915228817386",
            "source": "api",
            "reason": "Widerspruch per E-Mail",
            "created_at": "2026-11-16T09:00:00.000Z"
          }
        ]
      },
      "SuppressionList": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Suppression"
            },
            "description": "Die Einträge dieser Seite."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Für die nächste Seite als `cursor` senden. `null` = keine weitere Seite."
          }
        },
        "required": [
          "data",
          "next_cursor"
        ],
        "additionalProperties": false,
        "description": "Eine Seite der Sperrliste, neueste zuerst."
      }
    }
  }
}
