Anruf abbrechen
const url = 'https://api.speakki.de/v1/calls/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cancel';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.speakki.de/v1/calls/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cancel \ --header 'Authorization: Bearer <token>'Bricht einen wartenden Anruf ab (Status queued). Läuft der Anruf schon oder ist er abgeschlossen, antwortet die API mit 409.
Berechtigung: calls:write.
Authorizations
Abschnitt betitelt „Authorizations“Parameters
Abschnitt betitelt „Parameters“Path Parameters
Abschnitt betitelt „Path Parameters“ID des Anrufs.
Responses
Abschnitt betitelt „Responses“Der abgebrochene Anruf.
Ein ausgehender Anruf (Auftrag) mit seinen Versuchen.
object
ID des Anrufs.
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.
Zielnummer in E.164.
Absendernummer in E.164.
Werte für die Platzhalter in Begrüßung und Auftrag.
object
Ihre freien Daten, unverändert zurückgegeben.
object
Versuche insgesamt, die für diesen Anruf erlaubt sind.
Bisherige Wählversuche.
Auftrag angelegt am.
Alle Wählversuche in ihrer Reihenfolge.
Ein Wählversuch.
Example
{ "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 } ]}Ungültige Anfrage.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "invalid_request", "message": "Die Anfrage ist ungültig." }}API-Schlüssel fehlt oder ist ungültig.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "unauthorized", "message": "Der API-Schlüssel fehlt oder ist ungültig. Senden Sie ihn als „Authorization: Bearer spk_live_…“." }}Nicht erlaubt: Tarif, Freischaltung oder Berechtigung des Schlüssels.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "insufficient_scope", "message": "Diesem API-Schlüssel fehlt die Berechtigung für diese Anfrage." }}{ "error": { "code": "plan_required", "message": "Ausgehende Anrufe sind ab dem Tarif Professional enthalten." }}Nicht gefunden.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "not_found", "message": "Nicht gefunden." }}Passt nicht zum aktuellen Zustand.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "conflict", "message": "Die Anfrage passt nicht zum aktuellen Zustand." }}Zu viele Anfragen. retry-after und x-ratelimit-reset nennen die Sekunden, bis wieder Anfragen möglich sind.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "rate_limited", "message": "Zu viele Anfragen. Bitte versuchen Sie es gleich noch einmal." }}Interner Fehler.
Einheitliches Fehlerformat aller Antworten unter /v1.
object
Der Fehler.
object
Fester Code für Programme. Neue Codes können dazukommen, bestehende ändern sich nicht.
Meldung für Menschen, auf Deutsch.
Zusatz je Code, z. B. fields bei invalid_request oder missing_variables bei missing_variables.
object
Examples
{ "error": { "code": "internal_error", "message": "Interner Fehler. Bitte versuchen Sie es später noch einmal." }}