{"openapi":"3.1.0","info":{"title":"Talkward API","summary":"Gespraeche, Nachrichten, Kontakte und Webhooks von Talkward.","description":"Dokumentation: https://talkward.app/de/api/ (English: https://talkward.app/en/api/)","version":"1.1.0"},"servers":[{"url":"https://chat.talkward.app"}],"paths":{"/api/v1/ich":{"get":{"tags":["api-v1"],"summary":"Ich","operationId":"ich_api_v1_ich_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/marken":{"get":{"tags":["api-v1"],"summary":"Marken","operationId":"marken_api_v1_marken_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/team":{"get":{"tags":["api-v1"],"summary":"Team","description":"Aktive Mitarbeiter mit Anwesenheit (Migration 675): `anwesenheit` da | pause | abwesend (wirksam, ein\nabgelaufenes „abwesend bis“ ist wieder da), `abwesend_bis` nur bei abwesend mit Datum.","operationId":"team_api_v1_team_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/abteilungen":{"get":{"tags":["api-v1"],"summary":"Abteilungen","description":"Abteilungen (Migration 670); ohne Funktion `abteilungen` leer.","operationId":"abteilungen_api_v1_abteilungen_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/kontakte":{"get":{"tags":["api-v1"],"summary":"Kontakte","operationId":"kontakte_api_v1_kontakte_get","parameters":[{"name":"suche","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Suche"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api-v1"],"summary":"Kontakt Anlegen","description":"Kontakt anlegen (Quelle api) oder, wenn es ihn schon gibt, leere Felder fuellen; Segmente und\nFelder kommen dazu. Antwort {kontakt, neu}.","operationId":"kontakt_anlegen_api_v1_kontakte_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KontaktAnlegenBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/kontakte/profile":{"get":{"tags":["api-v1"],"summary":"Kontaktprofile","description":"Alle Kontaktprofile (Bereich Kontakte, Migration 530) zum Abgleich, nach ID aufsteigend: `weiter` der\nAntwort als `nach` wieder mitgeben. Vor /kontakte/{id} registriert, sonst griffe die Zahl-Route.","operationId":"kontaktprofile_api_v1_kontakte_profile_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"nach","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Nach"}},{"name":"suche","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Suche"}},{"name":"segment","in":"query","required":false,"schema":{"type":"string","maxLength":40,"default":"","title":"Segment"}},{"name":"geaendert_seit","in":"query","required":false,"schema":{"type":"string","maxLength":40,"default":"","title":"Geaendert Seit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/kontakte/{kontakt_id}":{"get":{"tags":["api-v1"],"summary":"Kontakt Lesen","operationId":"kontakt_lesen_api_v1_kontakte__kontakt_id__get","parameters":[{"name":"kontakt_id","in":"path","required":true,"schema":{"type":"integer","title":"Kontakt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["api-v1"],"summary":"Kontakt Aendern","operationId":"kontakt_aendern_api_v1_kontakte__kontakt_id__patch","parameters":[{"name":"kontakt_id","in":"path","required":true,"schema":{"type":"integer","title":"Kontakt Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KontaktAendernBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["api-v1"],"summary":"Kontakt Loeschen","description":"Kontakt loeschen (DSGVO Art. 17). Mit gespraeche=1 auch alle Gespraeche der Person samt Nachrichten und\nAnhaengen, endgueltig. Ohne bleiben die Gespraeche, nur das Profil ist weg.","operationId":"kontakt_loeschen_api_v1_kontakte__kontakt_id__delete","parameters":[{"name":"kontakt_id","in":"path","required":true,"schema":{"type":"integer","title":"Kontakt Id"}},{"name":"gespraeche","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Gespraeche"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/kontakte/{kontakt_id}/export":{"get":{"tags":["api-v1"],"summary":"Kontakt Export","description":"Auskunft (DSGVO Art. 15): Profil, Ereignisse und alle Gespraeche der Person mit Nachrichten und Notizen.","operationId":"kontakt_export_api_v1_kontakte__kontakt_id__export_get","parameters":[{"name":"kontakt_id","in":"path","required":true,"schema":{"type":"integer","title":"Kontakt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/kontakte/ereignis":{"post":{"tags":["api-v1"],"summary":"Kontakt Ereignis","description":"Ereignis („Bestellung:Abgeschlossen“ …) an den Kontakt mit dieser E-Mail/Telefonnummer; ohne\nKontakt wird er angelegt (Quelle api). Farben: rot, orange, gelb, gruen, blau, lila, rosa, braun, grau, schwarz.","operationId":"kontakt_ereignis_api_v1_kontakte_ereignis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EreignisBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche":{"get":{"tags":["api-v1"],"summary":"Gespraeche","description":"Gespraeche mit Dialog, zuletzt geaenderte zuerst. kontakt = E-Mail oder Telefonnummer (genau), status = offen |\nki | mensch | erledigt. Blaettern: `weiter` der Antwort als `nach` wieder mitgeben (Cursor ueber aktualisiert, id).\ngeaendert_seit = ISO-Zeitpunkt mit Zeitzone, fuer den Abgleich.","operationId":"gespraeche_api_v1_gespraeche_get","parameters":[{"name":"kontakt","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Kontakt"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"","title":"Status"}},{"name":"marke","in":"query","required":false,"schema":{"type":"string","default":"","title":"Marke"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"nach","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Nach"}},{"name":"geaendert_seit","in":"query","required":false,"schema":{"type":"string","maxLength":40,"default":"","title":"Geaendert Seit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}":{"get":{"tags":["api-v1"],"summary":"Gespraech","operationId":"gespraech_api_v1_gespraeche__konv_id__get","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/nachrichten":{"get":{"tags":["api-v1"],"summary":"Nachrichten","description":"Verlauf, aelteste zuerst. Ohne vor/nach die letzten `limit` Nachrichten. vor = Nachrichten-ID: die\n`limit` Nachrichten davor (aeltere nachladen). nach = Nachrichten-ID: die ersten `limit` danach (neue\nabholen). `mehr` sagt, ob es in dieser Richtung weitere gibt.","operationId":"nachrichten_api_v1_gespraeche__konv_id__nachrichten_get","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}},{"name":"notizen","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Notizen"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"vor","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Vor"}},{"name":"nach","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Nach"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["api-v1"],"summary":"Nachricht Senden","operationId":"nachricht_senden_api_v1_gespraeche__konv_id__nachrichten_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendenBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/anhaenge/{aid}":{"get":{"tags":["api-v1"],"summary":"Anhang Laden","description":"Datei eines Anhangs (url in nachricht.anhaenge). Immer als Download, nie im Browser ausgefuehrt.","operationId":"anhang_laden_api_v1_gespraeche__konv_id__anhaenge__aid__get","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}},{"name":"aid","in":"path","required":true,"schema":{"type":"string","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/vorlage":{"post":{"tags":["api-v1"],"summary":"Vorlage Senden","description":"WhatsApp-Vorlage in ein bestehendes WhatsApp-Gespraech, auch nach dem 24-Stunden-Fenster.","operationId":"vorlage_senden_api_v1_gespraeche__konv_id__vorlage_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VorlageEingabe"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/marken/{marke}/whatsapp-vorlagen":{"get":{"tags":["api-v1"],"summary":"Whatsapp Vorlagen","description":"Freigegebene WhatsApp-Vorlagen der Nummer dieser Marke: [{name, sprache, text, parameter, kategorie}].","operationId":"whatsapp_vorlagen_api_v1_marken__marke__whatsapp_vorlagen_get","parameters":[{"name":"marke","in":"path","required":true,"schema":{"type":"string","title":"Marke"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nachrichten":{"post":{"tags":["api-v1"],"summary":"Verfassen","description":"Nachricht an eine E-Mail-Adresse oder WhatsApp-Nummer: offenes Gespraech zu Marke + Adresse\nweiterfuehren, sonst ein neues anlegen. Fehler wie /api/support/konversation (verfassen.*).","operationId":"verfassen_api_v1_nachrichten_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerfassenBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/notizen":{"post":{"tags":["api-v1"],"summary":"Notiz","operationId":"notiz_api_v1_gespraeche__konv_id__notizen_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/status":{"post":{"tags":["api-v1"],"summary":"Status","operationId":"status_api_v1_gespraeche__konv_id__status_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/zuweisen":{"post":{"tags":["api-v1"],"summary":"Zuweisen","operationId":"zuweisen_api_v1_gespraeche__konv_id__zuweisen_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZuweisenBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/abteilung":{"post":{"tags":["api-v1"],"summary":"Abteilung Setzen","description":"Gespraech einer Abteilung geben (Verteilregel alle | belastung) oder sie entfernen (null).","operationId":"abteilung_setzen_api_v1_gespraeche__konv_id__abteilung_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbteilungBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/tags":{"post":{"tags":["api-v1"],"summary":"Tags","operationId":"tags_api_v1_gespraeche__konv_id__tags_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagsBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/felder":{"post":{"tags":["api-v1"],"summary":"Felder","operationId":"felder_api_v1_gespraeche__konv_id__felder_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FelderBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gespraeche/{konv_id}/kontakt":{"post":{"tags":["api-v1"],"summary":"Kontakt","description":"Kontaktdaten am Gespraech setzen. Die Absenderadresse eines Mail-Gespraechs bleibt unangetastet.","operationId":"kontakt_api_v1_gespraeche__konv_id__kontakt_post","parameters":[{"name":"konv_id","in":"path","required":true,"schema":{"type":"integer","title":"Konv Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KontaktBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/{webhook_id}/test":{"post":{"tags":["api-v1"],"summary":"Webhook Testen","description":"Sendet sofort ein signiertes Ereignis `test` an die Adresse (ohne Wiederholung) und meldet das Ergebnis.","operationId":"webhook_testen_api_v1_webhooks__webhook_id__test_post","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/{webhook_id}/zustellungen":{"get":{"tags":["api-v1"],"summary":"Webhook Zustellungen","description":"Die letzten Zustellversuche (neueste zuerst) und was noch in der Warteschlange steht.","operationId":"webhook_zustellungen_api_v1_webhooks__webhook_id__zustellungen_get","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tags":{"get":{"tags":["api-v1"],"summary":"Tags Liste","description":"Benutzte Tags der Gespraeche und Segmente der Kontakte mit Haeufigkeit (fuer Auswahlfelder).","operationId":"tags_liste_api_v1_tags_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/felder":{"get":{"tags":["api-v1"],"summary":"Felder Liste","description":"Namen der eigenen Felder, die in Gespraechen bzw. Kontakten vorkommen.","operationId":"felder_liste_api_v1_felder_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/webhooks":{"get":{"tags":["api-v1"],"summary":"Webhooks Liste","operationId":"webhooks_liste_api_v1_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["api-v1"],"summary":"Webhook Anlegen","operationId":"webhook_anlegen_api_v1_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AboBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/{webhook_id}":{"delete":{"tags":["api-v1"],"summary":"Webhook Loeschen","operationId":"webhook_loeschen_api_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/beispiele":{"get":{"tags":["api-v1"],"summary":"Beispiele","description":"Nutzlasten wie bei der Zustellung, gebaut aus den juengsten echten Gespraechen (fuer Make/Zapier\nbeim Einrichten). Die id ist negativ und eindeutig, damit sie nie mit einer echten Zustellung kollidiert.","operationId":"beispiele_api_v1_webhooks_beispiele_get","parameters":[{"name":"ereignis","in":"query","required":false,"schema":{"type":"string","default":"nachricht_neu","title":"Ereignis"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"default":3,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/meldungen":{"post":{"tags":["api-v1"],"summary":"Meldung","description":"Meldung eines Systems als Gespraech im Kanal `meldung` (Migration 700). Loest `meldung_neu` aus; ob\nalarmiert wird, entscheidet die Automation des Kunden (z. B. Baustein Kritischer Alarm).","operationId":"meldung_api_v1_meldungen_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeldungBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/team/nachricht":{"post":{"tags":["api-v1"],"summary":"Team Nachricht","description":"Meldung als Bot in einen Team-Kanal, wie POST /api/integration/nachricht (erdKERN CERT). Braucht die Funktion\nintegrationen (Erweiterung API oder Stufe Advanced) und team.chat, egal welcher Art der Schluessel ist.","operationId":"team_nachricht_api_v1_team_nachricht_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NachrichtBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AboBody":{"properties":{"ereignis":{"type":"string","title":"Ereignis","default":""},"url":{"type":"string","title":"Url","default":""},"marke":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marke"}},"type":"object","title":"AboBody"},"AbteilungBody":{"properties":{"abteilung":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Abteilung"}},"type":"object","title":"AbteilungBody"},"AnhangEingabe":{"properties":{"dateiname":{"type":"string","title":"Dateiname","default":""},"inhalt":{"type":"string","title":"Inhalt","default":""},"mime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime"}},"type":"object","title":"AnhangEingabe"},"EreignisBody":{"properties":{"mail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mail"},"telefon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefon"},"name":{"type":"string","title":"Name"},"daten":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Daten"},"farbe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Farbe"}},"type":"object","required":["name"],"title":"EreignisBody"},"FelderBody":{"properties":{"felder":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"type":"object","title":"Felder","default":{}}},"type":"object","title":"FelderBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"KontaktAendernBody":{"properties":{"mail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mail"},"telefon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefon"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"sprache":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sprache"},"land":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Land"},"stadt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadt"},"firma":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firma"},"firma_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firma Domain"},"position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"felder":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Felder"}},"type":"object","title":"KontaktAendernBody","description":"Nur mitgeschickte Felder aendern sich; \"\" leert ein Feld. tags und felder ersetzen die bisherigen."},"KontaktAnlegenBody":{"properties":{"mail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mail"},"telefon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefon"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"sprache":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sprache"},"land":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Land"},"stadt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stadt"},"firma":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firma"},"firma_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Firma Domain"},"position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Position"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"felder":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Felder"}},"type":"object","title":"KontaktAnlegenBody"},"KontaktBody":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"mail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mail"},"telefon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefon"}},"type":"object","title":"KontaktBody"},"MeldungBody":{"properties":{"titel":{"type":"string","title":"Titel","default":""},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"quelle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quelle"},"schwere":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schwere"},"schluessel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schluessel"},"marke":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marke"},"daten":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Daten"}},"type":"object","title":"MeldungBody"},"NachrichtBody":{"properties":{"kanal":{"type":"string","title":"Kanal","default":""},"titel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Titel"},"text":{"type":"string","title":"Text","default":""},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link"},"dringend":{"type":"boolean","title":"Dringend","default":false}},"type":"object","title":"NachrichtBody"},"SendenBody":{"properties":{"text":{"type":"string","title":"Text","default":""},"anhaenge":{"items":{"$ref":"#/components/schemas/AnhangEingabe"},"type":"array","title":"Anhaenge","default":[]}},"type":"object","title":"SendenBody"},"StatusBody":{"properties":{"status":{"type":"string","title":"Status","default":""}},"type":"object","title":"StatusBody"},"TagsBody":{"properties":{"hinzu":{"items":{"type":"string"},"type":"array","title":"Hinzu","default":[]},"weg":{"items":{"type":"string"},"type":"array","title":"Weg","default":[]}},"type":"object","title":"TagsBody"},"TextBody":{"properties":{"text":{"type":"string","title":"Text","default":""}},"type":"object","title":"TextBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerfassenBody":{"properties":{"marke":{"type":"string","title":"Marke","default":""},"kanal":{"type":"string","title":"Kanal","default":"mail"},"an":{"type":"string","title":"An","default":""},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"betreff":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Betreff"},"text":{"type":"string","title":"Text","default":""},"anhaenge":{"items":{"$ref":"#/components/schemas/AnhangEingabe"},"type":"array","title":"Anhaenge","default":[]},"vorlage":{"anyOf":[{"$ref":"#/components/schemas/VorlageEingabe"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"VerfassenBody"},"VorlageEingabe":{"properties":{"name":{"type":"string","title":"Name","default":""},"sprache":{"type":"string","title":"Sprache","default":"de"},"parameter":{"items":{"type":"string"},"type":"array","title":"Parameter","default":[]}},"type":"object","title":"VorlageEingabe"},"ZuweisenBody":{"properties":{"login":{"type":"string","title":"Login","default":""}},"type":"object","title":"ZuweisenBody"}},"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"API-Schluessel tw_…"},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"security":[{"bearer":[]},{"apiKey":[]}]}