Übersicht.
CyberTell stellt eine umfassende REST API bereit, organisiert in drei Portale. Jedes Portal hat eigene Authentifizierung und Endpoints. Alle Antworten sind JSON. Alle Zeitstempel sind UTC (ISO 8601).
Authentifizierung.
Alle drei Portale authentifizieren gleich: mit einem API-Key als Bearer-Token. Jedes Portal hat eigene Keys, und jeder Key gilt nur für die Zugriffsbereiche, die beim Anlegen gewählt wurden.
Erstellen Sie einen API-Key im jeweiligen Portal: Firma unter Profil → API-Keys, Reseller unter API → API-Keys (nur Admins), Privatpersonen unter Profil → API-Keys. Der Key hat die Form ctk_<id>_<secret> und wird nur einmal angezeigt. Senden Sie ihn bei jedem Aufruf als Authorization: Bearer <Key>.
# API-Key aus dem Profil verwenden curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/employees/
Zugriffsbereiche: Firmen-Keys werden für Module freigegeben, Reseller-Keys für Kunden und Abrechnung, Privat-Keys für Profil, Datenlecks, Vorfälle und Kurse. Ein Endpoint ausserhalb der Freigabe antwortet mit 403, ein ungültiger, abgelaufener oder deaktivierter Key mit 401.
Firma: Auch Admin-Endpoints wie Kampagnen, Fleet, Rollen und Standorte prüfen die Modul-Freigabe des Keys. Abrechnung und Corporate Design (/company/api/billing/, /company/api/layout/) brauchen den Zugriffsbereich Firmenkonto, den nur Firmen-Admins einem Key geben können.
Ältere Firmen-Keys: Access-Key-Paare (Authorization: CTAK <id>:<secret>) und statische Keys aus 64 Hex-Zeichen funktionieren vorerst weiter. Der Header X-Company-UUID ist nicht mehr nötig; wer ihn mitschickt, muss die richtige Firma nennen. Neue Keys sind immer ctk_-Keys.
Firmen mit eigener Instanz ersetzen den Host durch die Adresse ihrer Instanz – die Pfade bleiben gleich.
Firma API (B2B)
Alle Endpoints erfordern einen Firmen-API-Key im Authorization-Header (Bearer ctk_…), freigegeben für das Modul des Endpoints.
Auth & Login
2 EndpointsGET /company/tickets/api/me/ Aktueller Benutzer ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/me/
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"first_name": "Max",
"last_name": "Muster",
"email": "[email protected]",
"is_admin": true,
"company_name": "Murmelibach AG",
"company_uuid": "2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02",
"language": "de",
"modules": ["incidents", "phishing_analysis", "courses"],
"has_firewalla": true,
"gamification_enabled": true,
"profile_image_url": null,
"company_logo_url": "https://cybertell.io/media/logos/murmelibach.png"
}
POST /company/tickets/api/me/language/ Sprache des Kontos ändern ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/me/language/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"language": "fr"}'
{
"ok": true,
"language": "fr"
}
Mitarbeiter & Verwaltung
14 EndpointsGET /company/api/employees/ Alle Mitarbeiter auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/employees/
{
"employees": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"status_display": "Aktiv",
"is_company_admin": false,
"language": "de",
"roles": [{"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d", "name": "Mitarbeiter"}],
"last_login": "2026-06-10T08:15:00+00:00",
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
POST /company/api/employees/create/ Mitarbeiter erstellen ▶
curl -X POST https://portal.cybertell.io/company/api/employees/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"firstname": "Anna", "lastname": "Müller", "email": "[email protected]", "language": "de", "is_company_admin": false, "role_ids": ["a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d"], "send_invite_now": true}'
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"is_company_admin": false,
"invitation_sent": true
}
GET/PATCH/PUT/DEL /company/api/employees/<uuid>/ Mitarbeiter lesen, ändern oder deaktivieren (DELETE setzt status=inactive) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"status_display": "Aktiv",
"is_company_admin": false,
"language": "de",
"phone": "",
"department": "",
"position": "",
"roles": [{"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d", "name": "Mitarbeiter"}],
"certifications": [{"id": "3b9d1f72-8c4a-4e15-9a6b-2d7e0c1f5a83", "title": "Security Awareness Basis"}],
"totp_enabled": false,
"passkey_enabled": true,
"last_login": "2026-06-10T08:15:00+00:00",
"private_email": "",
"company_mobile": "",
"private_mobile": "",
"country": "ch"
}
POST /company/api/employees/<uuid>/invite/ Einladung senden ▶
curl -X POST https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/invite/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"invitation_sent": true
}
GET/POST /company/api/roles/ Rollen auflisten / anlegen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/roles/
{
"roles": [
{
"id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"name": "Werkstatt",
"is_default": false,
"is_external": false,
"modules": [{"id": 3, "key": "incidents", "name": "Vorfälle"}],
"member_count": 8
}
]
}
PATCH/DELETE /company/api/roles/<uuid>/ Rolle bearbeiten oder löschen ▶
curl -X PATCH https://portal.cybertell.io/company/api/roles/b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Werkstatt", "is_external": false, "module_ids": [3]}'
{
"id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"name": "Werkstatt",
"is_default": false,
"is_external": false
}
GET /company/api/locations/ Standorte auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/locations/
{
"locations": [
{
"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
"name": "Hauptsitz Murmelibach",
"street": "Dorfstrasse 12",
"address": "Dorfstrasse 12",
"zip_code": "3000",
"city": "Murmelibach",
"country_code": "ch",
"country": "ch",
"location_types": [{"id": 1, "name": "Büro", "key": "office"}],
"ai_risk_level": "",
"ai_risk_analysis": "",
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
POST /company/api/locations/create/ Standort erstellen ▶
curl -X POST https://portal.cybertell.io/company/api/locations/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Filiale Tannenhof", "street": "Bahnhofstrasse 3", "zip_code": "3011", "city": "Bern", "country_code": "ch", "employee_count": 6, "location_type_ids": [1]}'
{
"id": "e7f9a1c3-5b2d-4c84-9e16-7a3c5e9b1d40",
"name": "Filiale Tannenhof"
}
GET/PATCH/PUT/DEL /company/api/locations/<uuid>/ Standort-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/locations/a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d/
{
"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
"name": "Hauptsitz Murmelibach",
"street": "Dorfstrasse 12",
"zip_code": "3000",
"city": "Murmelibach",
"country_code": "ch",
"description": "",
"notes": "",
"location_types": [{"id": 1, "name": "Büro", "key": "office"}],
"employee_count": 24,
"has_servers": true,
"has_network_infrastructure": true,
"has_physical_security": true,
"has_backup_power": false,
"has_fire_suppression": false,
"has_access_control": true,
"ai_risk_level": "",
"ai_risk_analysis": "",
"created_at": "2026-01-12T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET /company/api/location-types/ Standort-Typen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/location-types/
{
"types": [
{ "id": 1, "name": "Büro", "key": "office" },
{ "id": 2, "name": "Rechenzentrum", "key": "datacenter" }
]
}
GET /company/api/billing/ Billing-Informationen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/billing/
{
"plan": "tier_10",
"billed_via": "direct",
"reseller": null,
"employee_count": 8,
"billing_cycle": "yearly",
"subscription_status": "active",
"trial_ends_at": null,
"stripe_current_period_end": "2027-01-12T09:00:00+00:00"
}
GET /company/api/layout/ Dokument-Layout (Logo / CI) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/layout/
{
"accent_color": "#1f6f4a",
"font_family": "",
"heading_font_family": "",
"confidentiality_text": "Vertraulich",
"footer_text": "",
"cover_variant": "classic",
"accent_line": "left",
"logo_position": "right",
"watermark_text": "",
"margin_preset": "normal",
"show_toc": true,
"show_changelog": true,
"updated_at": "2026-04-02T10:00:00+00:00"
}
GET /company/tabletop/api/company-profile/ Firmenprofil lesen (mit Auswahllisten) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/company-profile/
{
"company_title": "Murmelibach AG",
"industry": "finance",
"industry_label": "Finanzdienstleistung",
"company_size": "11-50",
"company_size_label": "11–50 Mitarbeiter",
"description": "",
"it_landscape": "Microsoft 365, Fileserver",
"critical_assets": "Kundendaten, Zahlungsverkehr",
"compliance_notes": "",
"country": "Schweiz",
"country_code": "ch",
"country_label": "Schweiz",
"website": "https://murmelibach-ag.example",
"default_language": "de",
"logo_url": "/media/logos/murmelibach.png",
"domains": [
{ "domain": "murmelibach-ag.ch", "is_primary": true, "notes": "" }
],
"industry_choices": [
{ "value": "finance", "label": "Finanzdienstleistung" }
],
"company_size_choices": [
{ "value": "11-50", "label": "11–50 Mitarbeiter" }
],
"country_choices": [
{ "value": "ch", "label": "Schweiz" }
],
"language_choices": [
{ "value": "de", "label": "Deutsch" }
]
}
POST /company/tabletop/api/company-profile/update/ Firmenprofil aktualisieren ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/company-profile/update/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"company_title": "Murmelibach AG", "industry": "finance", "company_size": "11-50", "critical_assets": "Kundendaten, Zahlungsverkehr", "default_language": "de", "country_code": "ch"}'
{
"company_title": "Murmelibach AG",
"industry": "finance",
"industry_label": "Finanzdienstleistung",
"company_size": "11-50",
"company_size_label": "11–50 Mitarbeiter",
"description": "",
"it_landscape": "",
"critical_assets": "Kundendaten, Zahlungsverkehr",
"compliance_notes": "",
"country": "Schweiz",
"country_code": "ch",
"country_label": "Schweiz",
"website": "",
"default_language": "de",
"logo_url": "",
"domains": [],
"industry_choices": [],
"company_size_choices": [],
"country_choices": [],
"language_choices": []
}
Phishing-Kampagnen
3 EndpointsGET /company/api/campaigns/ Kampagnen auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/campaigns/
{
"campaigns": [
{
"id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
"name": "Q2 Awareness",
"status": "Wird gesendet",
"created_date": "2026-05-02T09:00:00+00:00",
"stats": { "sent": 120, "opened": 61, "clicked": 14 }
}
]
}
POST /company/api/campaigns/create/ Kampagne als Entwurf anlegen (Start im Web-Portal) ▶
curl -X POST https://portal.cybertell.io/company/api/campaigns/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Q2 Awareness", "template_id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "smtp_profile_id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "landing_page_id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24"}'
{
"id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
"name": "Q2 Awareness"
}
GET /company/api/campaigns/options/ Vorlagen & Optionen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/campaigns/options/
{
"templates": [
{ "id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "name": "Paket-Benachrichtigung" }
],
"smtp_profiles": [
{ "id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "name": "Standard-SMTP" }
],
"landing_pages": [
{ "id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24", "name": "Login-Seite" }
]
}
Incidents & Tickets
11 EndpointsGET /company/tickets/api/list/ Ticket-Liste (Filter: ?status=, ?category=, ?type=employee|incident, ?q=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/list/?status=offen&category=phishing
{
"tickets": [
{
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"message_count": 2
}
],
"total_count": 1
}
POST /company/tickets/api/create/ Ticket erstellen ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"category": "phishing", "title": "Verdächtige E-Mail", "description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.", "priority": "hoch", "ticket_type": "meldung"}'
{
"ticket_id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"message": "Ticket erstellt."
}
GET /company/tickets/api/options/ Auswahllisten für neue Tickets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/options/
{
"categories": [
{ "value": "frage", "label": "Frage" },
{ "value": "phishing", "label": "Phishing-Verdacht" },
{ "value": "sonstiges", "label": "Sonstiges" }
],
"ticket_types": [
{ "value": "meldung", "label": "Meldung" },
{ "value": "vorfall", "label": "Vorfall" }
],
"priorities": [
{ "value": "niedrig", "label": "Niedrig" },
{ "value": "mittel", "label": "Mittel" },
{ "value": "hoch", "label": "Hoch" },
{ "value": "kritisch", "label": "Kritisch" }
],
"defaults": { "category": "sonstiges", "ticket_type": "meldung", "priority": "mittel" }
}
GET /company/tickets/api/<uuid>/ Ticket-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/
{
"ticket": {
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_by": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "email": "[email protected]" },
"assigned_to": null,
"participants": [],
"description_edited_at": null,
"can_edit": true,
"escalated_by": null,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"closed_at": null,
"escalated_at": null,
"messages": [
{
"id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
"author": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]" },
"body": "Bitte E-Mail nicht öffnen, wir prüfen.",
"is_internal": false,
"created_at": "2026-05-16T07:10:00+00:00",
"edited_at": null,
"mentioned": [],
"attachments": []
}
],
"attachments": []
}
}
POST /company/tickets/api/<uuid>/reply/ Antwort senden ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/reply/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"body": "Bitte E-Mail nicht öffnen, wir prüfen.", "mentions": []}'
{
"message_id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
"message": "Antwort gespeichert."
}
POST /company/tickets/api/<uuid>/status/ Status ändern ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/status/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"status": "in_bearbeitung"}'
{
"message": "Status aktualisiert."
}
POST /company/tickets/api/<uuid>/priority/ Priorität ändern ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/priority/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"priority": "kritisch"}'
{
"message": "Priorität aktualisiert."
}
POST /company/tickets/api/<uuid>/assign/ Ticket einer Person zuweisen (Admin; leer = Zuweisung entfernen) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/assign/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"assigned_to": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"}'
{
"changed": true,
"assigned_to": {
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Anna Müller",
"email": "[email protected]"
}
}
POST /company/tickets/api/<uuid>/edit/ Titel/Beschreibung oder eigene Nachricht bearbeiten (mit message_id) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/edit/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Verdächtige E-Mail mit Rechnungsanhang"}'
{
"changed": ["title"]
}
GET /company/tickets/api/<uuid>/mentionable/ Personen für @-Erwähnungen suchen (?q=, ohne E-Mail-Adressen) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/mentionable/?q=an
{
"results": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "is_admin": false }
]
}
GET /company/tickets/api/dashboard/ Dashboard-Statistiken ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/dashboard/
{
"total_tickets": 46,
"open_tickets": 3,
"closed_tickets": 41,
"serious_incidents": 1,
"by_category": [
{ "category": "phishing", "category_display": "Phishing-Verdacht", "count": 18 }
],
"by_priority": [
{ "priority": "hoch", "priority_display": "Hoch", "count": 7 }
],
"by_status": [
{ "status": "offen", "status_display": "Offen", "count": 3 }
],
"recent_tickets": [
{
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"message_count": 2
}
]
}
MITRE ATT&CK
2 EndpointsGET /company/tickets/mitre/api/mobile/ Taktiken mit Techniken und Abdeckung durch eigene Tickets und News ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/mitre/api/mobile/
{
"tactics": [
{
"tactic_id": "TA0001",
"name": "Initial Access",
"technique_count": 1,
"techniques": [
{ "technique_id": "T1566", "name": "Phishing", "is_subtechnique": false, "ticket_count": 3, "news_count": 12 }
]
}
],
"technique_total": 211,
"technique_covered": 18
}
GET /company/tickets/mitre/api/mobile/<technique_id>/ Eine Technik mit verknüpften Tickets und News (je höchstens 20) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/mitre/api/mobile/T1566/
{
"technique_id": "T1566",
"name": "Phishing",
"description": "…",
"is_subtechnique": false,
"parent_id": "",
"tactics": ["Initial Access"],
"assets": ["E-Mail"],
"tickets": [
{ "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen", "priority": "hoch", "priority_display": "Hoch", "created_at": "2026-05-15T09:30:00+00:00" }
],
"news": [
{ "id": "4812", "title": "Neue Phishing-Welle gegen KMU", "url": "https://www.ncsc.admin.ch/…", "published_at": "2026-05-14T06:00:00+00:00" }
]
}
War Rooms
6 EndpointsGET /company/tickets/api/warrooms/ War Rooms auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/warrooms/?status=aktiv
{
"warrooms": [
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participant_count": 5,
"message_count": 12,
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
]
}
POST /company/tickets/api/warrooms/create/ War Room erstellen ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware-Vorfall", "description": "Fileserver FS01 verschlüsselt.", "external_link": "", "external_link_label": "Video-Call"}'
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participant_count": 1,
"message_count": 0,
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
GET /company/tickets/api/warrooms/<uuid>/ War Room Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participants": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "initials": "MM", "is_admin": true }
],
"tickets": [
{ "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen" }
],
"playbooks": [
{ "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response" }
],
"messages": [
{
"id": 501,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Systeme isoliert.",
"created_at": "16.05.2026 10:00",
"created_at_iso": "2026-05-16T10:00:00+00:00",
"attachments": []
}
],
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
GET /company/tickets/warroom/<uuid>/api/messages/ Nachrichten abrufen (Polling) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/messages/?after=500
{
"messages": [
{
"id": 501,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Systeme isoliert.",
"created_at": "16.05.2026 10:00",
"attachments": []
}
]
}
POST /company/tickets/warroom/<uuid>/api/send/ Nachricht senden ▶
curl -X POST https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/send/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"body": "Backups werden geprüft."}'
{
"id": 502,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Backups werden geprüft.",
"created_at": "16.05.2026 10:05",
"attachments": []
}
GET/POST /company/tickets/api/warrooms/<uuid>/participants/ Teilnehmer lesen, einladen oder entfernen ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/participants/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"add": ["c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"], "remove": [], "add_groups": []}'
{
"participants": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Max Muster",
"initials": "MM",
"is_admin": true
}
],
"employees": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Max Muster",
"initials": "MM",
"is_admin": true,
"is_participant": true,
"group_ids": ["b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01"]
}
],
"groups": [
{ "id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01", "name": "Werkstatt" }
],
"can_manage": true
}
Dark Web Monitoring
4 EndpointsGET /company/tickets/api/darkweb/ Scan-Übersicht ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/
{
"scans": [
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch",
"total_credentials": 7,
"unique_emails": 5,
"breach_count": 3,
"has_plaintext_pw": true,
"risk_level": "high",
"sources_queried": "Dehashed, HIBP, LeakCheck",
"created_at": "2026-05-15T02:00:00+00:00"
}
]
}
POST /company/tickets/api/darkweb/scan/ Scan starten (nur verifizierte Domains) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/darkweb/scan/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"domain": "murmelibach-ag.ch", "run_dehashed": true, "run_hibp": true, "run_leakcheck": true}'
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch"
}
GET /company/tickets/api/darkweb/<uuid>/ Scan-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e/
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch",
"total_credentials": 7,
"unique_emails": 5,
"breach_count": 3,
"has_plaintext_pw": true,
"risk_level": "high",
"sources_queried": "Dehashed, HIBP, LeakCheck",
"created_at": "2026-05-15T02:00:00+00:00",
"stats": { "dehashed_count": 4, "hibp_count": 3, "leakcheck_count": 3 },
"findings": [
{
"source": "Dehashed",
"email": "[email protected]",
"username": "",
"password": "Sommer2024!",
"hashed_password": "",
"name": "",
"database": "combolist-2025",
"url": ""
}
],
"findings_total": 7,
"breaches": [
{
"name": "ExampleBreach2024",
"date": "2024-11-02",
"pwn_count": 1420000,
"data_classes": ["Email addresses", "Passwords"],
"description": "…",
"domain": "example.com"
}
]
}
GET /company/tickets/api/darkweb/domains/ Firmen-Domains für den Scan ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/domains/
{
"domains": [
{
"domain": "murmelibach-ag.ch",
"is_primary": true,
"is_verified": true
}
]
}
Phishing-Analyse (EML)
2 EndpointsPOST /company/tickets/analysis/api/upload/ EML-Datei hochladen ▶
curl -X POST https://portal.cybertell.io/company/tickets/analysis/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "[email protected]"
{
"analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"detail_url": "https://cybertell.io/company/tickets/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/",
"message": "E-Mail erfolgreich analysiert."
}
GET /company/tickets/analysis/api/list/ Analyse-Liste ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/analysis/api/list/
{
"analyses": [
{
"id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"subject": "Ihr Konto wurde gesperrt",
"sender": "[email protected]",
"risk_score": 85,
"vt_status": "done",
"ai_status": "done",
"created_at": "2026-05-15T18:20:00+00:00"
}
]
}
Mail Plugin (Phishing-Indikatoren)
3 EndpointsAPI für das Apple Mail Plugin zur automatischen Phishing-Erkennung. Indikatoren werden aus bestätigten Phishing-Analysen extrahiert.
GET /company/tickets/api/mail-plugin/indicators/ Phishing-Indikatoren abrufen (Sync) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/mail-plugin/indicators/?since=2026-05-01T00:00:00Z
{
"indicators": [
{
"id": 12,
"type": "sender_domain",
"value": "paypa1.com",
"risk_level": "high",
"description": "Gefälschter Absender",
"analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"hit_count": 3,
"created_at": "2026-05-15T18:25:00+00:00",
"expires_at": null
}
],
"count": 1,
"last_updated": "2026-05-16T08:00:00+00:00"
}
POST /company/tickets/api/mail-plugin/check/ E-Mail gegen Indikatoren prüfen ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/mail-plugin/check/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"sender": "[email protected]", "subject": "Konto gesperrt", "urls": ["https://paypa1.com/login"]}'
{
"is_phishing": true,
"risk_level": "high",
"matches": [
{ "type": "sender_domain", "value": "paypa1.com", "risk_level": "high", "analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13" }
],
"analysis_url": "https://cybertell.io/company/tickets/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/"
}
GET /company/tickets/api/mail-plugin/analysis/<uuid>/ Analyse-Detail für Popup ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/mail-plugin/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/
{
"id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"sender": "[email protected]",
"subject": "Ihr Konto wurde gesperrt",
"risk_score": 85,
"risk_label": "Hoch",
"spf": "fail",
"dkim": "none",
"dmarc": "fail",
"malicious_urls": ["https://paypa1.com/login"],
"ai_category": "Phishing",
"ai_assessment": "KATEGORIE: Phishing\n- Domain 2 Tage alt\nEMPFEHLUNG: Nicht öffnen.",
"ai_indicators": ["Domain 2 Tage alt"],
"ai_recommendation": "Nicht öffnen.",
"analysed_at": "2026-05-15T18:20:00+00:00",
"analysed_by": "Max Muster"
}
Awareness-Videos
7 EndpointsGET /company/videos/api/list/ Video-Liste ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/videos/api/list/
{
"videos": [
{
"id": "e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24",
"title": "Phishing in 90 Sekunden",
"language": "de",
"status": "completed",
"status_display": "Fertig",
"slide_count": 8,
"duration_seconds": 92,
"render_progress": 100,
"source": "generated",
"completed_by_me": false,
"release_status": "publiziert",
"release_status_display": "Publiziert",
"is_published": true,
"is_current": true,
"valid_from": null,
"valid_until": null,
"created_at": "2026-05-10T09:00:00+00:00"
}
]
}
POST /company/videos/api/generate/ Awareness-Video generieren (KI; optional: tone, address_form, length_preset, slide_count, style_template, setting, tts_voice, tts_speed) ▶
curl -X POST https://portal.cybertell.io/company/videos/api/generate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Sicheres Homeoffice", "language": "de", "enable_tts": false, "video_format": "landscape", "extra_notes": ""}'
{
"job_id": "f7b9d1e3-5d7a-4f02-9c38-4e6a8b0d2f35",
"status": "generating"
}
GET /company/videos/api/<uuid>/ Video-Detail mit Folien ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/
{
"id": "e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24",
"title": "Phishing in 90 Sekunden",
"extra_notes": "",
"language": "de",
"video_format": "landscape",
"status": "completed",
"status_display": "Fertig",
"slide_count": 8,
"duration_seconds": 92,
"render_progress": 100,
"render_error": "",
"enable_tts": false,
"has_video": true,
"video_url": "/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/",
"source": "generated",
"completed_by_me": false,
"release_status": "publiziert",
"release_status_display": "Publiziert",
"is_published": true,
"is_current": true,
"valid_from": null,
"valid_until": null,
"created_at": "2026-05-10T09:00:00+00:00",
"slides": [
{
"id": "0b2d4f68-1a3c-4e75-9b18-5d7f9a1c3e60",
"order": 1,
"slide_type": "intro",
"title": "Was ist Phishing?",
"bullets": ["Gefälschter Absender", "Zeitdruck"],
"speaker_notes": "",
"narration": "",
"illustration_key": "mail",
"duration_sec": 12
}
]
}
POST /company/videos/api/<uuid>/render/ Rendering neu anstossen ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/render/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "rendering",
"phase": "waiting",
"position": 1,
"status_display": "In Warteschlange"
}
GET /company/videos/api/<uuid>/video/ MP4 für den Player laden ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o awareness.mp4 https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/
HTTP/1.1 200 OK Content-Type: video/mp4 Accept-Ranges: bytes Content-Length: 4821004 <MP4-Datenstrom>
POST/DEL /company/videos/api/<uuid>/delete/ Video löschen ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/delete/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "deleted"
}
POST /company/videos/api/<uuid>/progress/ Angesehene Sekunden melden (Abschluss-Erfassung) ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/progress/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"watched": 73, "duration": 92, "ended": false}'
{
"progress_pct": 79,
"completed": false
}
Asset-Register
5 EndpointsLesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.
GET /company/assets/api/list/ Assets mit Risikobewertung ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/assets/api/list/
{
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01",
"asset_type": "system",
"asset_type_display": "System / Server",
"status": "active",
"status_display": "Aktiv",
"criticality": "high",
"criticality_display": "Hoch",
"confidentiality": "high",
"integrity": "medium",
"availability": "high",
"owner_name": "Max Muster",
"owner_email": "[email protected]",
"supplier": {
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
},
"status_page_url": "",
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"renews_on": "2027-01-31",
"renewal_state": "ok",
"auto_renew": true,
"payment_method": "invoice",
"payment_method_display": "Rechnung",
"risk_count": 2,
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/assets/api/create/ Asset erstellen ▶
curl -X POST https://portal.cybertell.io/company/assets/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Fileserver FS01", "asset_type": "system", "criticality": "high", "supplier": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "owner_email": "[email protected]"}'
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01"
}
GET/PATCH/PUT/DEL /company/assets/api/<uuid>/ Asset-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01",
"asset_type": "system",
"asset_type_display": "System / Server",
"status": "active",
"status_display": "Aktiv",
"criticality": "high",
"criticality_display": "Hoch",
"confidentiality": "high",
"integrity": "medium",
"availability": "high",
"owner_name": "Max Muster",
"owner_email": "[email protected]",
"supplier": {
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
},
"status_page_url": "",
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"renews_on": "2027-01-31",
"renewal_state": "ok",
"auto_renew": true,
"payment_method": "invoice",
"payment_method_display": "Rechnung",
"description": "Zentraler Dateiserver",
"notes": "",
"renewal_cycle": "yearly",
"renewal_cycle_display": "Jährlich",
"payment_note": "",
"provider_account": "",
"risks": [],
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET/POST /company/assets/api/<uuid>/risks/ Risiken eines Assets auflisten oder anlegen ▶
curl -X POST https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/risks/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ausfall Rechenzentrum", "likelihood": 2, "impact": 4, "target_likelihood": 1, "target_impact": 4, "contingency": "Failover ausl\u00f6sen"}'
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"asset_id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"title": "Ausfall Rechenzentrum",
"threat": "Stromausfall",
"vulnerability": "Kein Zweitstandort",
"likelihood": 2,
"impact": 4,
"risk_score": 8,
"risk_level": "high",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"status": "assessed",
"treatment": "Replikation ins Zweit-RZ",
"contingency": "Failover auslösen",
"accepted": false,
"accepted_by": "",
"accepted_at": null,
"accepted_justification": "",
"review_date": "2027-03-31",
"ai_generated": false,
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET/PATCH/DEL /company/assets/api/risks/<uuid>/ Risiko lesen, ändern oder löschen; accepted: true akzeptiert es ▶
curl -X PATCH https://portal.cybertell.io/company/assets/api/risks/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"accepted": true, "accepted_justification": "Kosten stehen in keinem Verh\u00e4ltnis"}'
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"asset_id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"title": "Ausfall Rechenzentrum",
"threat": "Stromausfall",
"vulnerability": "Kein Zweitstandort",
"likelihood": 2,
"impact": 4,
"risk_score": 8,
"risk_level": "high",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"status": "assessed",
"treatment": "Replikation ins Zweit-RZ",
"contingency": "Failover auslösen",
"accepted": false,
"accepted_by": "",
"accepted_at": null,
"accepted_justification": "",
"review_date": "2027-03-31",
"ai_generated": false,
"updated_at": "2026-05-02T10:00:00+00:00"
}
Drittanbieter (Suppliers)
3 EndpointsLesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.
GET /company/suppliers/api/list/ Lieferanten auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/suppliers/api/list/
{
"suppliers": [
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft",
"category": "cloud_saas",
"category_display": "Cloud / SaaS",
"status": "active",
"status_display": "Aktiv",
"risk_level": "high",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"ai_risk_level": "",
"country_code": "ch",
"website": "https://wolkensoftware.example",
"contact_name": "Erika Muster",
"contact_email": "[email protected]",
"data_access": true,
"system_access": false,
"status_page_url": "https://status.wolkensoftware.example",
"status_sources": [
"https://status.wolkensoftware.example/history.rss"
],
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"sla": {
"target": 99.9,
"claim_days": 30
},
"document_count": 1,
"created_at": "2026-02-01T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/suppliers/api/create/ Lieferant erstellen ▶
curl -X POST https://portal.cybertell.io/company/suppliers/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Wolkensoftware Eidgenossenschaft", "category": "cloud_saas", "risk_level": "high", "likelihood": 3, "impact": 4, "contingency": "Zweitanbieter aktivieren", "status_page_url": "https://status.wolkensoftware.example", "status_sources": ["https://status.wolkensoftware.example/history.rss"], "data_access": true, "sla_target": 99.9, "sla_claim_days": 30}'
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
}
GET/PATCH/PUT/DEL /company/suppliers/api/<uuid>/ Lieferant-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/suppliers/api/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft",
"category": "cloud_saas",
"category_display": "Cloud / SaaS",
"status": "active",
"status_display": "Aktiv",
"risk_level": "high",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"ai_risk_level": "",
"country_code": "ch",
"website": "https://wolkensoftware.example",
"contact_name": "Erika Muster",
"contact_email": "[email protected]",
"data_access": true,
"system_access": false,
"status_page_url": "https://status.wolkensoftware.example",
"status_sources": [
"https://status.wolkensoftware.example/history.rss"
],
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"sla": {
"target": 99.9,
"claim_days": 30
},
"document_count": 1,
"contact_phone": "",
"language": "de",
"description": "Mail und Ablage",
"notes": "",
"contingency": "Zweitanbieter aktivieren, Kunden informieren",
"ai_risk_analysis": "",
"backup_strategy": "Tägliche Sicherung im Zweit-RZ",
"backup_last_tested_at": "2026-10-01",
"backup_test_result": "Rücksicherung in 2 h",
"documents": [],
"compliance_requests": [],
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01"
}
],
"sla_breaches": [
{
"id": "8c1e3a57-9d2b-4f60-a8e4-2b7d5c9f1a36",
"month": "2026-10",
"target": 99.9,
"achieved": 99.583,
"outage_minutes": 180,
"claim_deadline": "2026-11-30",
"claim_sent_at": null
}
],
"created_at": "2026-02-01T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
IKT Assessment
7 EndpointsLesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.
GET /company/ict/api/list/ Assessments auflisten (?include_auto=1 mit CyberTell-Abbild) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/list/
{
"assessments": [
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt",
"standard_name": "IKT-Minimalstandard",
"rating_max": 4,
"overall_score": 2.1,
"completion_percent": 40,
"maturity_label": "Wiederholbar",
"created_at": "2026-04-02T10:00:00+00:00",
"created_by": "Max Muster",
"is_auto": false,
"read_only": false
}
]
}
GET /company/ict/api/catalog/ Anforderungskatalog eines Standards (Funktionen, Kategorien, Anforderungen; ?standard=ikt|isms|vvt|tom|din27076|nistcsf2) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/catalog/?standard=ikt
{
"standard_slug": "ikt",
"standard_name": "IKT-Minimalstandard",
"rating_max": 4,
"rating_choices": [
{ "value": "na", "label": "Nicht anwendbar" },
{ "value": "0", "label": "0 – Nicht umgesetzt" }
],
"functions": [
{
"code": "ID",
"short_code": "ID",
"name": "Identifizieren",
"description": "…",
"categories": [
{
"code": "ID.AM",
"short_code": "AM",
"name": "Asset Management",
"items": [
{
"id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"code": "ID.AM-1",
"title": "Inventar der Geräte",
"description": "…",
"priority": 1
}
]
}
]
}
]
}
POST /company/ict/api/new/ Assessment erstellen ▶
curl -X POST https://portal.cybertell.io/company/ict/api/new/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"standard": "ikt", "title": "IKT-Minimalstandard 2026"}'
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"prefilled": 0,
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt"
}
GET/DEL /company/ict/api/<uuid>/ Assessment-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt",
"rating_max": 4,
"overall_score": 2.1,
"completion_percent": 40,
"maturity_label": "Wiederholbar",
"is_complete": false,
"is_auto": false,
"read_only": false,
"created_at": "2026-04-02T10:00:00+00:00",
"functions": [
{
"code": "ID",
"short_code": "ID",
"name": "Identifizieren",
"description": "…",
"score": 2.4,
"categories": [
{
"code": "ID.AM",
"short_code": "AM",
"name": "Asset Management",
"score": 2.0,
"items": [
{
"id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"code": "ID.AM-1",
"title": "Inventar der Geräte",
"priority": 1,
"rating": "3",
"comment": "Inventar in Asset-Register"
}
]
}
]
}
]
}
POST /company/ict/api/<uuid>/save-response/ Antwort speichern ▶
curl -X POST https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/save-response/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"item_id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20", "rating": "3", "comment": "MFA aktiv"}'
{
"ok": true,
"completion_percent": 42,
"overall_score": 2.2,
"review_status": "",
"transferred": []
}
GET /company/ict/api/standards/ Verfügbare Compliance-Standards ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/standards/
{
"standards": [
{
"slug": "ikt",
"name": "IKT-Minimalstandard",
"description": "Bundesamt für wirtschaftliche Landesversorgung",
"rating_max": 4,
"is_status_scale": false
}
]
}
GET /company/ict/api/<uuid>/pdf/ Compliance-Report als PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o compliance-report.pdf https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="compliance-report.pdf" %PDF-1.7 …
AD Assessment
3 EndpointsLesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.
GET /company/ad/api/list/ AD-Dumps auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ad/api/list/
{
"dumps": [
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"filename": "ad_dump.json",
"status": "analysed",
"risk_score": 62,
"risk_level": "Hoch",
"risk_color": "warning",
"user_count": 140,
"computer_count": 96,
"has_ai_recommendations": true,
"created_at": "2026-05-10T09:00:00+00:00",
"uploaded_by": "Max Muster"
}
]
}
POST /company/ad/api/upload/ AD-Dump hochladen ▶
curl -X POST https://portal.cybertell.io/company/ad/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "dump_file=@ad_dump.json"
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"status": "analysed"
}
GET /company/ad/api/<uuid>/ Dump-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ad/api/3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74/
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"filename": "ad_dump.json",
"status": "analysed",
"risk_score": 62,
"risk_level": "Hoch",
"risk_color": "warning",
"ai_recommendations": "…",
"user_count": 140,
"computer_count": 96,
"group_count": 31,
"risks": [
{ "severity": "high", "title": "Kerberoastable accounts" }
],
"password_policy": { "min_length": 8 },
"domain_info": { "name": "murmelibach.local" },
"created_at": "2026-05-10T09:00:00+00:00"
}
Microsoft 365 Assessment
3 EndpointsLesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.
GET /company/azure/api/list/ Azure-Dumps auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/azure/api/list/
{
"dumps": [
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"filename": "azure_export.json",
"status": "analysed",
"risk_score": 45,
"risk_level": "Mittel",
"risk_color": "warning",
"user_count": 140,
"has_ai_recommendations": true,
"created_at": "2026-05-10T09:00:00+00:00",
"uploaded_by": "Max Muster"
}
]
}
POST /company/azure/api/upload/ Azure-Dump hochladen ▶
curl -X POST https://portal.cybertell.io/company/azure/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "dump_file=@azure_export.json"
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"status": "analysed"
}
GET /company/azure/api/<uuid>/ Dump-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/azure/api/2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60/
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"filename": "azure_export.json",
"status": "analysed",
"risk_score": 45,
"risk_level": "Mittel",
"risk_color": "warning",
"ai_recommendations": "…",
"user_count": 140,
"role_count": 12,
"app_count": 27,
"risks": [
{ "severity": "medium", "title": "Legacy auth aktiv" }
],
"security_defaults": { "enabled": false },
"conditional_access": [],
"checks": [
{ "id": "M365.AAD.02", "workload": "entra", "status": "fail", "severity": "critical", "title": "Conditional-Access-Richtlinie vorhanden", "evidence": "…", "fix": "…", "refs": ["CIS 5.2.2.1"] }
],
"workloads": [
{ "key": "entra", "label": "Entra ID", "collected": true, "skip_reason": "", "passed": 18, "failed": 4, "skipped": 0 }
],
"created_at": "2026-05-10T09:00:00+00:00"
}
Risikomanagement
2 EndpointsGET /company/risk/api/list/ Risiken auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/risk/api/list/
{
"risks": [
{
"id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
"title": "Ransomware",
"category": "technical",
"category_display": "Technisch",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"risk_level": "high",
"risk_level_display": "Hoch",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"treatment": "Offline-Backups einführen",
"treatment_display": "Offline-Backups einführen",
"owner": "Max Muster",
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/risk/api/create/ Risiko erstellen ▶
curl -X POST https://portal.cybertell.io/company/risk/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware", "category": "technical", "threat": "Verschlüsselung", "vulnerability": "Kein Offline-Backup", "likelihood": 3, "impact": 4, "target_likelihood": 1, "target_impact": 4, "owner": "Max Muster", "treatment": "Offline-Backups einführen"}'
{
"id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
"title": "Ransomware",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium"
}
Abhängigkeiten & Ausfall
16 EndpointsLesen und Simulieren mit Modul-Freigabe des Keys; Karte, Prozesse, Gruppen und Szenarien ändern nur Firmen-Admins.
GET /company/data-flows/api/mobile/ Kennzahlen, Single Points of Failure und Ausfallszenarien ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/mobile/
{
"node_count": 14,
"edge_count": 22,
"process_count": 5,
"spof": [],
"scenarios": []
}
GET /company/data-flows/api/map/ Karte: alle Knoten, Flüsse und Gruppen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/map/
{
"nodes": [
{
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"kind": "supplier",
"label": "Hosting AG",
"criticality": "high"
}
],
"edges": [
{
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
],
"groups": [
{
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
]
}
POST /company/data-flows/api/nodes/ Lieferant, Asset oder Prozess auf die Karte setzen (idempotent) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/nodes/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82"}'
{
"ok": true,
"node": {
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"kind": "supplier",
"label": "Hosting AG",
"criticality": "high"
}
}
DEL /company/data-flows/api/nodes/<uuid>/ Knoten samt Flüssen von der Karte nehmen; Lieferant, Asset oder Prozess bleiben ▶
curl -X DELETE https://portal.cybertell.io/company/data-flows/api/nodes/5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…"
{
"ok": true
}
POST /company/data-flows/api/edges/ Fluss zwischen zwei Knoten anlegen ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/edges/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"source": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26", "target": "8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20", "flow_type": "service", "data_categories": ["customer"]}'
{
"ok": true,
"edge": {
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
}
PATCH/DEL /company/data-flows/api/edges/<uuid>/ Fluss ändern (nur genannte Felder) oder löschen ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/edges/9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"is_redundant": true}'
{
"ok": true,
"edge": {
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
}
GET/POST /company/data-flows/api/processes/ Geschäftsprozesse auflisten oder anlegen (landet sofort auf der Karte) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/processes/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Auftragsabwicklung", "criticality": "high", "rto_hours": 8, "mtpd_hours": 24}'
{
"process": {
"uuid": "2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82",
"name": "Auftragsabwicklung",
"description": "",
"criticality": "high",
"rto_hours": 8,
"mtpd_hours": 24,
"rpo_hours": 4,
"owner_email": "[email protected]"
}
}
GET/PATCH/DEL /company/data-flows/api/processes/<uuid>/ Geschäftsprozess lesen, ändern oder löschen ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/processes/2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"rpo_hours": 4}'
{
"process": {
"uuid": "2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82",
"name": "Auftragsabwicklung",
"description": "",
"criticality": "high",
"rto_hours": 8,
"mtpd_hours": 24,
"rpo_hours": 4,
"owner_email": "[email protected]"
}
}
GET/POST /company/data-flows/api/groups/ Gruppen auflisten oder anlegen ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/groups/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Hosting", "nodes": ["5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"]}'
{
"ok": true,
"group": {
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
}
GET/PATCH/DEL /company/data-flows/api/groups/<uuid>/ Gruppe umbenennen, Knoten setzen (nodes), hinzufügen (add), entfernen (remove) oder Gruppe löschen ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/groups/4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"add": ["8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20"]}'
{
"ok": true,
"group": {
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
}
POST /company/data-flows/api/simulation/ Ausfall durchrechnen, ohne etwas zu speichern (Auslöser per Knoten oder per Lieferant, Asset, Prozess) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/simulation/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "outage_hours": 24}'
{
"ok": true,
"outage_hours": 24,
"counts": {
"total": 2,
"critical": 1,
"high": 1,
"mtpd_breached": 0,
"rto_breached": 1
},
"affected": [
{
"id": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"label": "Auftragsabwicklung",
"kind": "process",
"via_rule": "single",
"via_source_label": "Hosting AG"
}
],
"processes": [
{
"label": "Auftragsabwicklung",
"rto": 8,
"mtpd": 24,
"rto_breached": true
}
],
"affected_edges": [
"e_9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47"
]
}
GET/POST /company/data-flows/api/scenarios/ Gespeicherte Szenarien auflisten oder eine Simulation als Szenario speichern ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/scenarios/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "outage_hours": 24, "name": "Hoster 24 h weg"}'
{
"ok": true,
"scenario": {
"uuid": "2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81",
"name": "Hoster 24 h weg",
"trigger_label": "Hosting AG",
"trigger_kind": "supplier",
"trigger_node": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"outage_hours": 24,
"counts": {
"total": 2,
"mtpd_breached": 0
},
"has_assessment": false,
"result": {},
"ai_assessment": "",
"ai_assessed_at": null,
"created_at": "2026-05-14T10:00:00+00:00"
}
}
GET/DEL /company/data-flows/api/scenarios/<uuid>/ Szenario mit Ergebnis lesen oder löschen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/scenarios/2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81/
{
"ok": true,
"scenario": {
"uuid": "2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81",
"name": "Hoster 24 h weg",
"trigger_label": "Hosting AG",
"trigger_kind": "supplier",
"trigger_node": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"outage_hours": 24,
"counts": {
"total": 2,
"mtpd_breached": 0
},
"has_assessment": false,
"result": {},
"ai_assessment": "",
"ai_assessed_at": null,
"created_at": "2026-05-14T10:00:00+00:00"
}
}
GET /company/data-flows/api/status/ Zustand der Statusseiten je Knoten und Wirkung der laufenden Störungen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/status/
{
"ok": true,
"nodes": [
{
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"url": "https://status.hosting.example",
"state": "outage",
"label": "Ausfall",
"tone": "critical",
"summary": "Rechenzentrum offline",
"since": "2026-05-14T09:12:00+00:00",
"disrupted": true
}
],
"impact": {
"total": 2,
"processes": [
"Auftragsabwicklung"
],
"affected": [
"n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20"
],
"edges": [
"e_9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47"
]
}
}
GET /company/data-flows/api/outages/ Störungsverlauf der Anbieter, jüngste zuerst; ?open=1 nur laufende ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/outages/
{
"outages": [
{
"url": "https://status.hosting.example",
"source": "Hosting AG Status",
"state": "outage",
"label": "Ausfall",
"summary": "Rechenzentrum offline",
"started_at": "2026-05-14T09:12:00+00:00",
"ended_at": null,
"open": true,
"duration_minutes": null,
"affected": [
"Hosting AG"
]
}
]
}
GET/PUT /company/data-flows/api/layout/ Positionen der Knoten lesen und setzen ▶
curl -X PUT https://portal.cybertell.io/company/data-flows/api/layout/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"positions": {"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26": {"x": 0, "y": 160}}}'
{
"ok": true,
"updated": 1
}
Backup & Wiederherstellung
1 EndpointGET /company/backups/api/mobile/ Backup-Pläne mit Wiederherstellungstests und ungeschützten Assets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/backups/api/mobile/
{
"is_admin": true,
"kpi": {
"active": 1,
"tests_overdue": 0,
"not_resilient": 0,
"unprotected": 1,
"exempted": 0
},
"plans": [
{
"id": "3b5d7f91-2c4e-4a68-8d0b-1f3a5c7e9b02",
"name": "Fileserver täglich",
"scope": "Alle Freigaben",
"status": "active",
"status_display": "Aktiv",
"frequency": "daily",
"frequency_display": "Täglich",
"weekdays": [],
"schedule_display": "Täglich",
"location": "cloud",
"location_display": "Cloud",
"location_detail": "",
"tool": "Veeam",
"template_key": "",
"retention_days": 30,
"rpo_hours": 24,
"rpo_gap": false,
"has_offline_copy": true,
"is_immutable": false,
"is_encrypted": true,
"is_monitored": true,
"is_ransomware_resilient": true,
"owner": "Alma Admin",
"test_interval_months": 6,
"next_test_due": "2026-11-12",
"test_overdue": false,
"asset_names": ["Fileserver"],
"tips": [],
"tests": [
{
"id": "9e1a3c5b-7d2f-4b46-8a80-2c4e6f8a0b13",
"tested_on": "2026-05-12",
"scope": "file",
"scope_display": "Einzelne Dateien",
"result": "success",
"result_display": "Erfolgreich",
"duration_minutes": 45,
"tested_by": "Alma Admin",
"findings": ""
}
]
}
],
"unprotected_assets": [
{
"id": "4c6e8a02-3d5f-4b79-9e1c-2a4b6d8f0c14",
"name": "ERP",
"criticality": "critical",
"criticality_display": "Kritisch"
}
],
"exempted_assets": []
}
Angriffsfläche
1 EndpointGET /company/attack-surface/api/mobile/ Kennzahlen, letzter Lauf, offene Befunde und Assets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/attack-surface/api/mobile/
{
"is_admin": true,
"stats": {
"hosts": 3,
"ips": 2,
"open_ports": 5,
"cves": 1,
"open_findings": 1,
"by_severity": {"critical": 0, "high": 1, "medium": 0, "low": 0, "info": 0}
},
"budget": {"limit": 200, "used": 26, "remaining": 174, "blocked": false},
"scan": {
"id": "8a0c2e4a-7b9d-4f13-8a2b-6c8d0e2f4a57",
"domain": "beispiel.ch",
"status": "done",
"status_display": "Abgeschlossen",
"created_at": "2026-05-16T07:00:00+00:00",
"completed_at": "2026-05-16T07:02:10+00:00",
"new_assets": 1,
"new_findings": 1,
"changes": {"new_assets": 1, "new_ports": 2},
"error": ""
},
"findings": [
{
"id": "0c2e4a6c-9d1f-4b35-9c4d-8e0f2a4b6c79",
"kind": "risky_port",
"kind_display": "Riskanter Port",
"severity": "high",
"severity_display": "Hoch",
"subject": "203.0.113.5:3389",
"domain": "beispiel.ch",
"status": "open",
"status_display": "Offen",
"first_seen_at": "2026-05-16T07:02:00+00:00",
"last_seen_at": "2026-05-16T07:02:00+00:00",
"note": "Hoster informiert",
"asset_id": "2e4a6c8e-1f3b-4d57-8e6f-0a2b4c6d8e91",
"risk": {"id": "4a6c8e0a-3b5d-4f79-8a8b-2c4d6e8f0a13", "title": "RDP offen", "level": "high", "status": "assessed"}
}
],
"assets": [
{
"id": "2e4a6c8e-1f3b-4d57-8e6f-0a2b4c6d8e91",
"kind": "ip",
"kind_display": "IP-Adresse",
"value": "203.0.113.5",
"domain": "beispiel.ch",
"ports": [443, 3389],
"vuln_count": 1,
"last_seen": "2026-05-16T07:02:00+00:00",
"technologies": ["nginx 1.24.0"],
"note": "",
"excluded": false,
"shared": false,
"register_asset": null
}
]
}
Hausverbote
3 EndpointsGET /company/banning-orders/api/list/ Hausverbote auflisten (neueste 100) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/banning-orders/api/list/
{
"hausverbote": [
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"firstname": "Unbekannt",
"lastname": "männlich",
"status": "aktiv",
"reason": "Hausfriedensbruch",
"location": "Filiale Tannenhof",
"ban_date": "2026-05-16",
"ban_until": "2027-05-16",
"photo_url": null,
"violation_count": 0
}
]
}
POST /company/banning-orders/api/create/ Hausverbot erstellen ▶
curl -X POST https://portal.cybertell.io/company/banning-orders/api/create/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "firstname=Unbekannt" \ -F "lastname=männlich" \ -F "reason=Hausfriedensbruch" \ -F "location=Filiale Tannenhof" \ -F "ban_date=2026-05-16" \ -F "ban_until=2027-05-16" \ -F "[email protected]"
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"status": "ok"
}
GET/PATCH/PUT/DEL /company/banning-orders/api/<uuid>/ Hausverbot-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/banning-orders/api/8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60/
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"firstname": "Unbekannt",
"lastname": "männlich",
"date_of_birth": null,
"photo_url": null,
"description": "",
"street": "",
"postal_code": "",
"city": "",
"country": "",
"reason": "Hausfriedensbruch",
"location": "Filiale Tannenhof",
"ban_date": "2026-05-16",
"ban_until": "2027-05-16",
"status": "aktiv",
"notes": "",
"violations": [
{
"id": "0a2c4e68-1b3d-4f75-9c18-5e7a9c1d3f60",
"date": "2026-06-01",
"description": "Erneut im Laden",
"reported_to_police": true,
"notes": ""
}
],
"can_edit": true,
"can_manage": true
}
Tabletop-Übungen
6 EndpointsGET /company/tabletop/api/scenarios/ Szenarien auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/scenarios/
{
"scenarios": [
{
"id": "1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02",
"title": "Ransomware Krisenfall",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "hard",
"difficulty_display": "Schwer",
"narrative": "Montagmorgen, 07:15 Uhr …",
"duration_min": 90,
"target_roles": "Geschäftsleitung, IT",
"phase_count": 6,
"created_at": "2026-05-02T09:00:00+00:00"
}
]
}
POST /company/tabletop/api/scenarios/generate/ Szenario generieren (AI) ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/scenarios/generate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"scenario_type": "ransomware", "difficulty": "hard", "extra_context": "", "phase_count": 8}'
{
"job_id": "6d8f0a24-5c7e-4b91-8a36-2f4a6c8e0d51",
"status": "generating"
}
GET /company/tabletop/api/scenarios/<uuid>/ Szenario-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/scenarios/1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02/
{
"id": "1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02",
"title": "Ransomware Krisenfall",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "hard",
"narrative": "Montagmorgen, 07:15 Uhr …",
"duration_min": 90,
"target_roles": "Geschäftsleitung, IT",
"learning_goals": "Entscheidungswege unter Zeitdruck üben",
"phases": [
{
"id": "2b4d6f80-3c5e-4a91-8b27-3e5a7c9e1b02",
"order": 1,
"title": "Erste Meldung",
"situation": "Der Fileserver antwortet nicht mehr.",
"time_pressure": "15 Minuten",
"discussion_question": "Wer wird sofort informiert?",
"choices": [
{ "label": "A", "text": "IT-Leitung informieren", "consequence": "…", "is_recommended": true }
]
}
]
}
GET /company/tabletop/api/negotiations/ Verhandlungen auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/negotiations/
{
"negotiations": [
{
"id": "7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "medium",
"status": "active",
"initial_ransom": 250000,
"current_ransom": 125000,
"trust_level": 40,
"threat_level": 70,
"score": null,
"outcome": "",
"message_count": 6,
"started_at": "2026-05-16T09:00:00+00:00",
"completed_at": null
}
]
}
GET /company/tabletop/api/negotiations/<uuid>/ Verhandlung-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/
{
"id": "7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24",
"scenario_type": "ransomware",
"scenario_briefing": "Ihre Server sind verschlüsselt …",
"difficulty": "medium",
"status": "active",
"initial_ransom": 250000,
"current_ransom": 125000,
"deadline_hours": 48,
"trust_level": 40,
"threat_level": 70,
"score": null,
"outcome": "",
"ai_feedback": "",
"messages": [
{ "role": "attacker", "content": "Sie haben 48 Stunden.", "timestamp": "2026-05-16T09:00:00+00:00" }
],
"started_at": "2026-05-16T09:00:00+00:00"
}
POST /company/tabletop/api/negotiations/<uuid>/message/ Nachricht senden ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/message/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"message": "Wir benötigen mehr Zeit."}'
{
"message": "Sie haben 24 Stunden.",
"current_ransom": 125000,
"trust_level": 35,
"threat_level": 75,
"status": "active",
"outcome": ""
}
SOC, Geräteflotte & Threat Report
8 EndpointsGET /company/api/soc/status/ SOC-Hub-Status (konfigurierte Firewall) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/status/
{
"firewalla": true,
"sophos": false,
"defender": false,
"pfsense": false,
"waf": true
}
GET/POST /company/api/threat-reports/config/ Threat-Report-Konfiguration lesen / speichern (role_id als UUID oder interne Ganzzahl) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/threat-reports/config/
{
"configs": [
{
"id": 3,
"role_id": 12,
"role_uuid": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"role_name": "Geschäftsleitung",
"frequency": "monthly",
"send_hour": 8,
"send_weekday": 0,
"send_day": 1,
"sections": ["lage_schweiz", "eigene_vorfaelle"],
"is_active": true,
"include_ai_summary": true
}
],
"available_sections": [
{ "key": "lage_schweiz", "label": "Lage Schweiz" }
]
}
GET /company/api/soc/<provider>/live/ Live-Daten eines SOC-Anbieters (provider = firewalla, pfsense, sophos, defender, graylog; Zeitfenster ?start_ts=&end_ts=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/firewalla/live/?start_ts=1778914800&end_ts=1778918400
{
"provider": "firewalla",
"capabilities": { "label": "Firewalla", "device_assignments": true },
"soc_stats": {
"threat_level": "medium",
"alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
"total_alarms": 7,
"boxes_online": 2,
"boxes_total": 2,
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880
},
"flow_map": [
{ "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
],
"recent_blocked": [
{ "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
],
"suspicious": [
{ "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
],
"company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
"blocked_countries": ["RU", "KP"]
}
GET /company/api/soc/<provider>/device-flows/ Aggregierte Flows eines Geräts der letzten Stunde (?device= Pflicht, optional ?region=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/firewalla/device-flows/?device=WS-042
{
"device": "WS-042",
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880,
"filter_region": "",
"top_domains": [
{ "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
],
"top_regions": [
{ "region": "CH", "count": 640, "blocked": 0 }
]
}
GET/POST/DEL /company/api/soc/<provider>/device-assignments/ Geräte Mitarbeitern zuweisen (Admin; mitarbeiter_id als UUID oder interne Ganzzahl) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/device-assignments/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"device_key": "AA:BB:CC:DD:EE:FF", "device_name": "WS-042", "context_id": "0a1b2c3d", "mitarbeiter_id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "notes": ""}'
{
"ok": true,
"created": true,
"assignment": {
"id": 7,
"provider": "firewalla",
"device_key": "AA:BB:CC:DD:EE:FF",
"device_name": "WS-042",
"context_id": "0a1b2c3d",
"mitarbeiter_id": 42,
"mitarbeiter_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"mitarbeiter_name": "Max Muster",
"assigned_at": "2026-05-16T08:10:00+00:00",
"notes": ""
}
}
POST /company/api/soc/<provider>/alarm-ai/ KI-Analyse eines Alarms (Formular-Felder; auch unter /company/api/firewalla/alarm-ai/) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/alarm-ai/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'alarm_type=Abnormal Upload' \ --data-urlencode 'severity=high' \ --data-urlencode 'device=NAS-Buero' \ --data-urlencode 'target=203.0.113.50' \ --data-urlencode 'message=2.1 GB in 10 min' \ --data-urlencode 'timestamp=2026-05-16T07:40:00Z'
{
"analysis": "ZUSAMMENFASSUNG: …"
}
POST /company/api/soc/<provider>/suspicious-analyse/ Verdächtiges Ziel prüfen (action=vt|ai|both; auch unter /company/api/firewalla/suspicious-analyse/) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/suspicious-analyse/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'action=both' \ --data-urlencode 'type=blocked_flow' \ --data-urlencode 'title=Blockiertes Ziel' \ --data-urlencode 'detail=WS-042 nach RU' \ --data-urlencode 'domains=198.51.100.7' \ --data-urlencode 'severity=low' \ --data-urlencode 'region=RU'
{
"vt": [
{ "url": "198.51.100.7", "verdict": "malicious", "source": "ipsum", "score": 4 }
],
"ai": "ZUSAMMENFASSUNG: …"
}
GET /company/api/threat-report/latest/ Letzter Bedrohungslage-Report ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/threat-report/latest/
{
"report": {
"sent_at": "2026-05-01T06:00:00+00:00",
"recipient_count": 3,
"ai_summary": "Im April dominierten QR-Phishing und Rechnungsbetrug.",
"sections": ["lage_schweiz", "eigene_vorfaelle"],
"role": "Geschäftsleitung"
}
}
Firewalla Integration
13 EndpointsGET /company/api/firewalla/overview/ Dashboard-Übersicht ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/overview/
{
"stats": {
"box_count": 2,
"online_count": 2,
"offline_count": 0,
"alarm_count": 7,
"alarm_severity": { "high": 1, "medium": 2, "info": 4 },
"rule_count": 64,
"block_rule_count": 40,
"allow_rule_count": 24,
"target_list_count": 3,
"blocked_domain_count": 12
},
"boxes": [
{
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
}
],
"recent_alarms": [
{
"id": "a-901",
"type": "Sicherheitsaktivität",
"message": "Verbindung zu bekannter Malware-Domain",
"device": "WS-042",
"target": "boese-domain.example",
"timestamp": "16.05.2026 08:05",
"severity": "high",
"box_id": "0a1b2c3d"
}
],
"rules": [
{
"id": "55",
"type": "dns",
"target": "boese-domain.example",
"action": "block",
"direction": "outbound",
"protocol": "",
"scope": "",
"expire": 0,
"created_at": "10.05.2026 09:00",
"paused": false
}
],
"target_lists": [
{ "id": "TL-1", "name": "CyberTell Blocklist", "target_count": 12, "owner": "" }
],
"blocked_domains": ["boese-domain.example"]
}
GET /company/api/firewalla/boxes/ Geräte (Boxes) auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/
{
"boxes": [
{
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
}
]
}
GET /company/api/firewalla/boxes/<box_id>/ Box-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/
{
"box_id": "0a1b2c3d",
"box": {
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
},
"alarms": [
{
"id": "a-901",
"type": "Sicherheitsaktivität",
"message": "Verbindung zu bekannter Malware-Domain",
"device": "WS-042",
"target": "boese-domain.example",
"timestamp": "16.05.2026 08:05",
"severity": "high",
"box_id": "0a1b2c3d"
}
],
"rules": [
{
"id": "55",
"type": "dns",
"target": "boese-domain.example",
"action": "block",
"direction": "outbound",
"protocol": "",
"scope": "",
"expire": 0,
"created_at": "10.05.2026 09:00",
"paused": false
}
],
"devices": [
{
"id": "AA:BB:CC:DD:EE:FF",
"mac": "AA:BB:CC:DD:EE:FF",
"mac_vendor": "Dell",
"ip": "10.0.0.42",
"name": "WS-042",
"online": true,
"last_seen": "16.05.2026 08:00",
"total_download": 41984000,
"total_upload": 5242880,
"assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
}
]
}
GET /company/api/firewalla/boxes/<box_id>/devices/ Geräte einer Box ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/devices/
{
"box_id": "0a1b2c3d",
"devices": [
{
"id": "AA:BB:CC:DD:EE:FF",
"mac": "AA:BB:CC:DD:EE:FF",
"mac_vendor": "Dell",
"ip": "10.0.0.42",
"name": "WS-042",
"online": true,
"last_seen": "16.05.2026 08:00",
"total_download": 41984000,
"total_upload": 5242880,
"assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
}
],
"count": 1
}
GET /company/api/firewalla/flows/ Traffic-Flows (?query=, ?groupBy=, ?sortBy=, ?cursor=, ?limit= Standard 50, max. 500) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/flows/?limit=200
{
"flows": [
{
"ts": "16.05.2026 08:00",
"ts_epoch": 1778918400.0,
"protocol": "tcp",
"dport": "443",
"sport": "",
"direction": "outbound",
"download": 10240,
"upload": 2048,
"category": "",
"region": "US",
"device": "WS-042",
"device_ip": "10.0.0.42",
"source": "",
"destination": "example.com",
"dest_ip": "93.184.216.34",
"blocked": false,
"duration": 0.4,
"count": 1
}
],
"count": 1,
"next_cursor": ""
}
GET /company/api/firewalla/device-flows/ Geräte-Traffic (?device= Pflicht, optional ?region=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/device-flows/?device=WS-042
{
"device": "WS-042",
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880,
"filter_region": "",
"top_domains": [
{ "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
],
"top_regions": [
{ "region": "CH", "count": 640, "blocked": 0 }
]
}
GET /company/api/firewalla/stats/ Fleet-Statistiken ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/stats/
{
"stats": { "onlineBoxes": 2, "offlineBoxes": 0, "alarms": 7, "rules": 64 }
}
GET /company/api/firewalla/soc-live/ Live-SOC-Feed ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/soc-live/
{
"provider": "firewalla",
"capabilities": { "label": "Firewalla", "device_assignments": true },
"soc_stats": {
"threat_level": "medium",
"alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
"total_alarms": 7,
"boxes_online": 2,
"boxes_total": 2,
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880
},
"flow_map": [
{ "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
],
"recent_blocked": [
{ "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
],
"suspicious": [
{ "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
],
"company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
"blocked_countries": ["RU", "KP"]
}
GET/POST/DEL /company/api/firewalla/blocked-countries/ Blockierte Länder ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/blocked-countries/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"country_code": "RU"}'
{
"success": true,
"country_code": "RU",
"action": "blocked"
}
GET/POST/DEL /company/api/firewalla/blocked-domains/ Blockierte Domains verwalten ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/blocked-domains/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"domain": "boese-domain.example"}'
{
"ok": true,
"message": "boese-domain.example blockiert."
}
GET/POST/DEL /company/api/firewalla/device-assignments/ Geräte-Zuordnungen verwalten (mitarbeiter_id als UUID oder interne Ganzzahl) ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/device-assignments/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"mac": "AA:BB:CC:DD:EE:FF", "device_name": "WS-042", "box_id": "0a1b2c3d", "mitarbeiter_id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "notes": ""}'
{
"ok": true,
"created": true,
"assignment": {
"id": 7,
"device_mac": "AA:BB:CC:DD:EE:FF",
"device_name": "WS-042",
"box_id": "0a1b2c3d",
"mitarbeiter_id": 42,
"mitarbeiter_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"mitarbeiter_name": "Max Muster"
}
}
POST /company/api/firewalla/rules/<rule_id>/pause/ Regel pausieren ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/pause/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"message": "Regel 55 pausiert."
}
POST /company/api/firewalla/rules/<rule_id>/resume/ Regel fortsetzen ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/resume/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"message": "Regel 55 fortgesetzt."
}
Playbooks (Incident Response)
14 EndpointsGET /company/playbooks/api/list/ Playbooks auflisten ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/list/
{
"playbooks": [
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"description": "Sofortmassnahmen bei Verschlüsselung",
"topic": "ransomware",
"topic_display": "Ransomware-Angriff",
"version": "1.0",
"updated_at": "2026-05-02T10:00:00+00:00",
"scope": "standard",
"has_steps": true
}
]
}
POST /company/playbooks/api/create/ Playbook anlegen (optional mit KI-Inhalten, ai_generate) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware Response", "topic": "ransomware", "version": "1.0", "description": "Sofortmassnahmen bei Verschlüsselung", "scope": "standard", "ai_generate": true}'
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response"
}
GET /company/playbooks/api/<uuid>/ Playbook-Detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"description": "Sofortmassnahmen bei Verschlüsselung",
"topic": "ransomware",
"topic_display": "Ransomware-Angriff",
"version": "1.0",
"updated_at": "2026-05-02T10:00:00+00:00",
"scope": "standard",
"has_steps": true,
"sections": [
{
"id": "4a6c8e02-1b3d-4f59-9c87-2e5a7d1f3b06",
"title": "Sofortmassnahmen",
"content": "Betroffene Hosts isolieren …",
"order": 0,
"intro": "",
"preparation": "",
"condition": "",
"block_key": "",
"has_steps": true,
"steps": [
{ "id": "e4b8c2d6-1a3f-4c57-9e80-2b4d6f8a0c13", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Incident Lead", "time_mark": "", "condition": "", "module_key": "", "order": 0 }
]
}
],
"roles": [
{ "id": "5b7d9f21-3c4e-4a86-9b05-1d3f5a7c9e20", "role_type": "intern", "name": "Max Muster", "role_title": "Incident Lead", "email": "[email protected]", "phone": "", "notes": "" }
]
}
GET /company/playbooks/api/<uuid>/pdf/ Playbook als PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o playbook.pdf https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="playbook.pdf" %PDF-1.7 …
GET /company/playbooks/api/runs/ Läufe auflisten (?status=laufend|finished|abgeschlossen|abgebrochen, ?kind=drill|incident) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/?status=laufend
{
"runs": [
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"playbook_id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"kind": "incident", "kind_display": "Ernstfall",
"status": "laufend", "status_display": "Laufend", "is_running": true,
"started_at": "2026-10-11T08:15:00+00:00",
"warroom": { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" },
"ticket": null,
"counts": { "done": 2, "open": 5, "skipped": 0, "na": 1, "visible": 7, "percent": 29 }
}
]
}
GET /company/playbooks/api/runs/options/ Auswahl fürs Aktivieren: Playbooks mit Fallcheck-Fragen, Systeme, Dienstleister, War Rooms, Tickets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/options/
{
"playbooks": [ { "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response", "topic": "ransomware", "questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ] } ],
"asset_groups": [ { "key": "system", "label": "System", "assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster" } ] } ],
"supplier_groups": [ { "key": "it_infrastructure", "label": "IT-Infrastruktur", "assets": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "criticality": "active", "criticality_label": "Aktiv", "owner": "" } ] } ],
"warrooms": [ { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" } ],
"tickets": [ { "id": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "title": "Verschlüsselte Dateien", "short_code": "T-0481" } ],
"can_pick_assets": true
}
POST /company/playbooks/api/runs/activate/ Lauf starten (Übung oder Ernstfall) mit Systemen, Dienstleistern, Verknüpfung und Fallcheck ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/activate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"playbook": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "kind": "incident", "link": "ticket", "ticket": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "assets": ["a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91"], "suppliers": ["b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02"], "answers": {"ransom_demand": true, "data_exfiltrated": null}}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"title": "Ransomware Response", "kind": "incident", "status": "laufend", "is_running": true,
"answers": { "ransom_demand": true },
"questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ],
"sections": [ { "index": 0, "title": "Sofortmassnahmen", "intro": "Erste Stunde.", "preparation": "", "condition": "", "block_key": "", "state": null, "hidden": false,
"steps": [ { "id": "e4b8c2d6-1f3a-4e59-9b07-2c6d8a0f4e12", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Technischer IR-Lead", "time_mark": "0–15 min", "condition": "", "module_key": "warroom", "module": { "key": "warroom", "label": "War Room", "url": "/company/incidents/warroom/" }, "state": "offen", "applicable": true, "open_question": false, "assignee": null, "done_by": null, "done_at": null, "note": "", "ticket": null, "asset_hint": "", "can_change": true } ] } ],
"assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "asset_type_label": "System", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster", "supplier": "Hosting AG", "backup_plans": [], "no_backup": true, "open_findings": [], "url": "/company/asset-register/a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91/" } ],
"suppliers": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "category_label": "IT-Infrastruktur", "status": "active", "status_label": "Aktiv", "contact_name": "", "contact_email": "[email protected]", "contact_phone": "", "data_access": true, "scope": "", "contingency": "Hotline 24/7", "url": "/company/suppliers/b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02/" } ],
"counts": { "done": 0, "open": 7, "skipped": 0, "na": 0, "visible": 7, "percent": 0 },
"permissions": { "can_operate": true, "can_finish": true, "can_delete": true, "can_edit_assets": true }
}
GET /company/playbooks/api/runs/<uuid>/ Lauf-Detail: Abschnitte und Schritte mit Zustand, Fallcheck, betroffene Systeme und Dienstleister, Rechte ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"title": "Ransomware Response", "status": "laufend",
"sections": [], "assets": [], "suppliers": [],
"permissions": { "can_operate": true, "can_finish": true, "can_delete": false, "can_edit_assets": true }
}
POST /company/playbooks/api/runs/<uuid>/assets/ Betroffene Systeme und Dienstleister ersetzen (ohne den Schlüssel suppliers bleiben die Dienstleister unverändert) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/assets/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"assets": ["a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91"], "suppliers": ["b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02"]}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"assets": [], "suppliers": []
}
POST /company/playbooks/api/runs/<uuid>/answers/ Fallcheck-Antworten setzen (true, false oder null = offen) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/answers/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"answers": {"ransom_demand": true, "data_exfiltrated": false, "customers_affected": null}}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"answers": { "ransom_demand": true, "data_exfiltrated": false },
"sections": []
}
POST /company/playbooks/api/runs/<uuid>/steps/<uuid>/state/ Schritt abhaken, überspringen oder wieder öffnen (offen|erledigt|uebersprungen), optional mit Notiz ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/steps/e4b8c2d6-1f3a-4e59-9b07-2c6d8a0f4e12/state/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"state": "erledigt", "note": "Kabel gezogen, 08:21"}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"counts": { "done": 1, "open": 6, "skipped": 0, "na": 0, "visible": 7, "percent": 14 },
"sections": []
}
POST /company/playbooks/api/runs/<uuid>/finish/ Lauf abschliessen oder abbrechen (action=finish|abort), Abschlussnotiz, optional Review anlegen ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/finish/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"action": "finish", "notes": "Wiederanlauf um 14:30 abgeschlossen.", "create_review": true}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"status": "abgeschlossen", "is_running": false,
"review": { "id": "5a3c7e91-2d4f-4b68-8c17-9e1b3d5f7a20", "status": "entwurf" }
}
POST/DEL /company/playbooks/api/runs/<uuid>/delete/ Lauf löschen (nur Firmen-Admin) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/delete/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true
}
GET /company/playbooks/api/runs/<uuid>/pdf/ Lauf als PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o playbook-lauf.pdf https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="playbook-lauf.pdf" %PDF-1.7 …
Security Policy
3 EndpointsMitarbeiter rufen die aktuelle Sicherheitsrichtlinie ab und bestätigen sie. Bestätigungen werden für Compliance-Nachweise protokolliert.
GET /company/policy/api/ Aktuelle Policy abrufen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/policy/api/
{
"version": "4",
"published_at": "2026-04-30T12:00:00+00:00",
"sections": [
{ "key": "password", "title": "Passwort-Richtlinien", "extra": "", "icon": "Key", "sort_order": 1, "is_custom": false,
"body_html": "<ul><li>Passwörter haben mindestens 12 Zeichen.</li></ul>" }
],
"pw_rules": { "min_length": 12, "require_uppercase": true, "require_numbers": true, "require_special": false, "expiry_days": 0, "no_reuse": true },
"incident_contact": { "name": "Max Muster", "email": "[email protected]", "phone": "+41 31 000 00 00" },
"acknowledged": false,
"acknowledged_at": null,
"acknowledged_version": null
}
POST /company/policy/api/acknowledge/ Policy bestätigen (Mitarbeiter) ▶
curl -X POST https://portal.cybertell.io/company/policy/api/acknowledge/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "ok"
}
GET /company/policy/api/mobile/pdf/ Richtlinie als PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o sicherheitsrichtlinie.pdf https://portal.cybertell.io/company/policy/api/mobile/pdf/?lang=de
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="sicherheitsrichtlinie.pdf" %PDF-1.7 …
Sichere Dokumente
1 EndpointGET /company/api/documents/ Freigegebene Firmen-Dokumente ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/documents/
{
"documents": [
{
"id": "2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02",
"title": "Notfallkonzept",
"description": "",
"category": "Notfall",
"filename": "notfallkonzept.pdf",
"size": 284120,
"download_url": "/secure-file/2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02/",
"can_read": true,
"uploaded_at": "2026-04-02T10:00:00+00:00"
}
]
}
Punkte
1 EndpointGET /company/api/points/me/ Eigene Punkte und Rangliste ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/points/me/
{
"points": {
"total": 1840,
"this_month": 260,
"this_month_chf": 26.0,
"monthly_budget_chf": 50.0,
"enabled": true,
"level": "Wachsam",
"level_progress": 0.6,
"next_level_points": 2000,
"my_rank": 3,
"leaderboard": [
{ "rank": 1, "name": "Erika Muster", "points": 2410, "is_me": false },
{ "rank": 3, "name": "Max Muster", "points": 1840, "is_me": true }
]
}
}
Roadmap
2 EndpointsGET /company/roadmap/api/mobile/ Phasen, Fortschritt und nächste Schritte ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/roadmap/api/mobile/
{
"progress": 35,
"phases": [
{
"key": "grundschutz",
"label": "Grundschutz",
"desc": "…",
"done": 6,
"total": 12,
"items": [
{
"key": "module:incidents",
"label": "Vorfall-Meldung aktivieren",
"desc": "…",
"icon": "Shield",
"status": "done",
"cadence": "",
"recurring": false,
"last_done": "2026-05-02T09:00:00+00:00",
"snoozed_until": null,
"planned_date": null,
"overdue": false
}
]
}
],
"next_steps": []
}
POST /company/roadmap/api/mobile/action/ Schritt erledigen oder verschieben ▶
curl -X POST https://portal.cybertell.io/company/roadmap/api/mobile/action/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'action=done' \ --data-urlencode 'item_key=module:incidents'
{
"ok": true,
"progress": 38
}
DMARC
2 EndpointsGET /company/dmarc/api/mobile/ DMARC-Kennzahlen und Reports ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/dmarc/api/mobile/
{
"pass_rate": 96,
"failing_sources": 2,
"reporters": 5,
"total_messages": 18240,
"reports": [
{
"uuid": "7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91",
"policy_domain": "murmelibach-ag.ch",
"org_name": "google.com",
"date_begin": "2026-05-14T00:00:00+00:00",
"date_end": "2026-05-15T00:00:00+00:00",
"total_count": 420,
"pass_count": 404,
"pass_rate": 96
}
]
}
GET /company/dmarc/api/mobile/<uuid>/ Report mit Alignment und Fehlerquellen ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/dmarc/api/mobile/7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91/
{
"uuid": "7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91",
"policy_domain": "murmelibach-ag.ch",
"org_name": "google.com",
"date_begin": "2026-05-14T00:00:00+00:00",
"date_end": "2026-05-15T00:00:00+00:00",
"total_count": 420,
"pass_count": 404,
"pass_rate": 96,
"pol_p": "quarantine",
"pol_sp": "",
"pol_pct": 100,
"pol_adkim": "r",
"pol_aspf": "r",
"alignment": { "both": 390, "dkim_only": 10, "spf_only": 4, "none": 16 },
"failing_records": [
{
"source_ip": "203.0.113.7",
"count": 16,
"disposition": "quarantine",
"dkim_result": "fail",
"spf_result": "fail",
"dkim_aligned": false,
"spf_aligned": false,
"header_from": "murmelibach-ag.ch"
}
]
}
Incident Response
1 EndpointGET /company/api/mobile/incident-response/ Untersuchungen und Kennzahlen (?severity=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/mobile/incident-response/?status=aktiv
{
"investigations": [
{
"id": "1d3f5a79-2b4c-4e86-9a01-7c9e1b3d5f40",
"title": "Kompromittiertes Notebook",
"description": "",
"status": "aktiv",
"status_display": "Aktiv",
"severity": "hoch",
"severity_display": "Hoch",
"lead": "Max Muster",
"created_at": "2026-05-15T14:00:00+00:00"
}
],
"stats": { "active": 1, "critical": 0, "indicators": 24, "draft_rules": 2 }
}
Audit-Log
1 EndpointGET /company/tickets/api/audit-log/ Audit-Log der Firma (letzte 100 Ereignisse, nur Firmen-Admins) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/audit-log/
{
"events": [
{
"id": 9001,
"action": "login",
"success": true,
"actor_email": "[email protected]",
"target_label": "B2B-Portal",
"ip_address": "203.0.113.10",
"ip_country": "CH",
"ip_city": "Bern",
"user_agent": "Safari 18 · macOS",
"failure_reason": "",
"created_at": "2026-05-16T07:02:00+00:00",
"lat": 46.95,
"lng": 7.45,
"location_precision": "city"
}
]
}
Privatpersonen API.
Alle Endpoints erfordern einen Privat-API-Key im Authorization-Header (Bearer ctk_…). Ein Key sieht nur die Daten der Person, die ihn angelegt hat.
Dashboard & Profil
2 EndpointsGET /individual/api/dashboard/ Dashboard-Übersicht (courses_* zählt Prüfungsversuche) ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/dashboard/
{
"dashboard": {
"leak_checks": 3,
"total_breaches": 5,
"verified_emails": 2,
"incidents": 1,
"canary_tokens": 2,
"canary_hits": 0,
"simulations": 4,
"courses_total": 5,
"courses_passed": 2
}
}
GET /individual/api/profile/ Profil-Daten ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/profile/
{
"profile": {
"id": "3d4e5f6a-9b1c-4d46-8e72-8c0d2f4a6e79",
"firstname": "Max",
"lastname": "Muster",
"email": "[email protected]",
"phone": "+41790000000",
"plan": "family",
"subscription_status": "active",
"language": "de",
"created_at": "2026-01-12T09:00:00+00:00",
"family": { "is_owner": true, "member_count": 2, "members": [ { "id": "9e1c3a57-2b4d-4f86-8a09-3c5e7a9b1d40", "name": "Erika Muster", "email": "[email protected]" } ] }
}
}
E-Mail Leak-Checks
2 EndpointsGET /individual/api/leak-checks/ Leak-Check-Liste ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/leak-checks/
{
"leak_checks": [
{
"id": "d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92",
"email": "[email protected]",
"breach_count": 3,
"risk_level": "high",
"checked_at": "2026-05-15T20:00:00+00:00"
}
],
"verified_emails": [
{ "id": "8b0d2f46-1a3c-4e75-9b18-5d7f9a1c3e60", "email": "[email protected]", "verified_at": "2026-01-12T09:05:00+00:00" }
]
}
GET /individual/api/leak-checks/<uuid>/ Detail mit Breaches ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/leak-checks/d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92/
{
"leak_check": {
"id": "d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92",
"email": "[email protected]",
"breach_count": 3,
"risk_level": "high",
"checked_at": "2026-05-15T20:00:00+00:00",
"breaches": [
{ "name": "ExampleBreach2024", "date": "2024-11-02", "domain": "example.com", "pwn_count": 1420000, "data_classes": ["E-Mail-Adressen", "Passwörter"], "description": "…", "logo_path": "" }
]
}
}
Kurse
1 EndpointGET /individual/api/courses/ Kurse der Person mit Fortschritt (dieselbe Auswahl wie /individual/courses/api/certifications/) ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/courses/
{
"courses": [
{
"id": "4e5f6a7b-0c2d-4e57-9f83-9d1e3f5a7b80",
"title": "Phishing erkennen",
"topic_count": 4,
"content_count": 12,
"completed_count": 7,
"progress_pct": 58,
"exam": { "id": "2c4e6a80-1b3d-4f57-9a29-6d8f0b2d4e61", "passed": true, "score": "14/16", "finished_at": "2026-05-16T09:00:00+00:00" }
}
]
}
Reseller / Versicherung API.
Alle Endpoints erfordern einen Reseller-API-Key im Authorization-Header (Bearer ctk_…). Die Abrechnung verlangt zusätzlich, dass der Key von einem Admin stammt, der noch Admin ist.
Dashboard
1 EndpointGET /reseller/api/dashboard/ Übersicht ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/dashboard/
{
"dashboard": {
"type": "reseller",
"company_count": 12,
"active_companies": 10,
"total_employees": 240,
"open_tickets": 5,
"sponsored_persons": 0
}
}
Companies
6 EndpointsGET /reseller/api/companies/ Verwaltete Firmen auflisten ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/
{
"companies": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"email": "[email protected]",
"industry": "finance",
"plan": "tier_10",
"subscription_status": "active",
"employee_count": 24,
"open_tickets": 1,
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
GET /reseller/api/companies/<uuid>/ Firmen-Detail ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"email": "[email protected]",
"industry": "finance",
"company_size": "11-50",
"plan": "tier_10",
"subscription_status": "active",
"country": "Schweiz",
"employees": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]", "is_admin": true }
]
}
}
GET /reseller/api/companies/security/ Sicherheitslage aller Kunden ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/
{
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"own_company": false,
"migrated": false,
"assets": 42,
"assets_critical": 3,
"systems": 12,
"cves": 9,
"findings": {
"critical": 2,
"high": 4,
"medium": 5,
"low": 1
},
"kev": 1,
"support_expired": 1,
"support_ending": 2,
"surface_findings": 4,
"surface_severe": 1,
"last_run_at": "2026-11-15T02:30:00+00:00"
}
],
"totals": {
"companies": 8,
"with_radar": 5,
"attention": 2,
"assets": 214,
"systems": 61,
"cves": 37,
"kev": 2,
"kev_companies": 2,
"critical_companies": 3,
"support_expired": 2,
"support_ending": 5
},
"shared_cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"kev": true,
"cvss": 9.8,
"companies": 3,
"systems": 4,
"customer_names": [
"Murmelibach AG",
"Seeblick GmbH"
]
}
]
}
GET /reseller/api/companies/security/cves/ Offene CVEs aller Kunden ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/cves/?kev=1
{
"cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"cvss": 9.8,
"kev": true,
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG"
}
],
"systems": 2,
"findings": 2,
"products": [
"Fortinet FortiOS"
],
"fixed_in": [
"7.4.9"
],
"first_seen_at": "2026-11-02T02:31:00+00:00"
}
],
"truncated": false,
"kev_total": 1
}
GET /reseller/api/companies/security/assets/ Aktive Assets aller Kunden ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/assets/?criticality=critical
{
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Firewall Hauptsitz",
"asset_type": "network",
"asset_type_display": "Netzwerk",
"criticality": "critical",
"criticality_display": "Kritisch",
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"open_cves": 2
}
]
}
GET /reseller/api/companies/<uuid>/security/ Sicherheitslage eines Kunden ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/security/
{
"security": {
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"migrated": false,
"radar": {
"systems": 12,
"cves": 9,
"open_findings": 12,
"findings_by_severity": {
"critical": 2,
"high": 4,
"medium": 5,
"low": 1
},
"kev": 1,
"support_expired": 1,
"packages": 0,
"last_run_at": "2026-11-15T02:30:00+00:00",
"cve_total": 9,
"affected_systems": 5,
"system_total": 12,
"open_cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"kev": true,
"cvss": 9.8,
"findings": 2,
"products": [
"Fortinet FortiOS"
],
"fixed_in": [
"7.4.9"
]
}
],
"system_list": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"name": "Firewall Hauptsitz",
"kind": "firewall",
"kind_display": "Firewall",
"product": "Fortinet FortiOS",
"version": "7.4.3",
"open_findings": 2,
"support_end": "2027-09-30",
"support_stage": ""
}
]
},
"assets": {
"total": 42,
"critical": 3,
"items": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Firewall Hauptsitz",
"asset_type": "network",
"asset_type_display": "Netzwerk",
"criticality": "critical",
"criticality_display": "Kritisch",
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"open_cves": 2
}
]
},
"attack_surface": null
}
}
Abrechnung
6 EndpointsSammelrechnungen und Kosten je Kunde für die eigene Buchhaltung. Jede Position nennt die Kundenfirma, die Zahl der Mitarbeiter, den Plan, Menge und Einheit, den Listenpreis, den Partner-Rabatt und den Nettobetrag. Braucht einen API-Key mit Bereich «Abrechnung» von einem Admin des Partners; die Kosten je Kunde gibt es nur für IT-Partner. Ohne Listenpreis (On-Premises) sind die Beträge der laufenden Periode null, ältere Rechnungen liefern die neuen Felder als null.
GET /reseller/api/billing/ Übersicht mit Totalen, offenen Beträgen und laufender Periode ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/
{
"billing": {
"model": "it_partner",
"currency": "CHF",
"discount_percent": 30.0,
"invoices": {
"count": 12,
"open_count": 1,
"overdue_count": 0,
"gross_total_chf": 29760.0,
"discount_total_chf": 8928.0,
"net_total_chf": 20832.0,
"open_net_chf": 1736.0,
"overdue_net_chf": 0.0,
"latest_id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24"
},
"current_period": {
"period_start": "2026-11-01",
"period_end": "2026-11-30",
"priced": true,
"customer_count": 8,
"line_count": 9,
"gross_chf": 2565.0,
"discount_chf": 769.5,
"net_chf": 1795.5
},
"sponsor": null
}
}
GET /reseller/api/billing/customers/ Kunden mit Mitarbeitern, Plan, Abo und Kosten der laufenden Periode ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/customers/?include_own=0
{
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 24,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"active_employee_count": 22,
"subscription_plan": "tier_50",
"billing_cycle": "yearly",
"subscription_status": "active"
}
],
"totals": { "priced": true, "gross_chf": 2565.0, "discount_chf": 769.5, "net_chf": 1795.5 }
}
GET /reseller/api/billing/customers/<uuid>/ Kunde mit aktuellem Stand, Abo und Rechnungshistorie ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/customers/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"customer": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"own_company": false,
"billed": true,
"current": {
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 24,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main"
},
"active_employee_count": 22,
"subscription_plan": "tier_50",
"billing_cycle": "yearly",
"subscription_status": "active",
"history": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 22,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"invoice_id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"invoice_status": "sent"
}
]
}
}
GET /reseller/api/billing/invoices/ Rechnungen mit Kunden und Mitarbeitertotal, nach Status filterbar; ?include=lines hängt die Positionen an ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/invoices/?status=open
{
"invoices": [
{
"id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"gross_chf": 2480.0,
"discount_chf": 744.0,
"net_chf": 1736.0,
"currency": "CHF",
"status": "sent",
"status_display": "Gesendet",
"line_count": 9,
"customer_count": 8,
"employee_total": 186,
"companies": [
{ "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "company_name": "Murmelibach AG", "own_company": false }
],
"has_pdf": true,
"issued_at": "2026-11-01T05:00:00+00:00",
"due_at": "2026-12-01T05:00:00+00:00",
"paid_at": null
}
]
}
GET /reseller/api/billing/invoices/<uuid>/ Rechnung mit allen Positionen je Kunde ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/
{
"invoice": {
"id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"gross_chf": 2480.0,
"discount_chf": 744.0,
"net_chf": 1736.0,
"currency": "CHF",
"status": "sent",
"status_display": "Gesendet",
"line_count": 9,
"customer_count": 8,
"employee_total": 186,
"companies": [
{ "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "company_name": "Murmelibach AG", "own_company": false }
],
"has_pdf": true,
"issued_at": "2026-11-01T05:00:00+00:00",
"due_at": "2026-12-01T05:00:00+00:00",
"paid_at": null,
"lines": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 22,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"period_start": "2026-10-01",
"period_end": "2026-10-31"
}
]
}
}
GET /reseller/api/billing/invoices/<uuid>/pdf/ Rechnung als PDF ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o rechnung.pdf https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="CT-202610-0042.pdf" %PDF-1.7 …
developers.api.group.r-eng.title
24 Endpointsdevelopers.api.group.r-eng.desc
GET /reseller/api/engagements/ developers.api.ep.r-eng.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/
{
"items": [
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/ developers.api.ep.r-eng.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest ERP 2026", "company": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "pentest_type": "internal", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-2026-17"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.2 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
PATCH /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.3 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"testing_hours": "Mo-Fr 08-18 Uhr"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
DELETE /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.4 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
{
"ok": true,
"result": "deleted"
}
POST /reseller/api/engagements/<uuid>/complete-definition/ developers.api.ep.r-eng.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/complete-definition/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
PUT /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.7 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest ERP 2026 v2", "company": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "pentest_type": "internal", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-2026-17"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
PATCH/DELETE /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.8 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"testing_hours": "Mo-Fr 08-18 Uhr"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/assets/ developers.api.ep.r-eng.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/
{
"items": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/assets/ developers.api.ep.r-eng.11 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"kind": "ip_range", "label": "Server-LAN", "value": "10.0.0.0/24", "scope_keys": ["internal_pentest"]}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
GET /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
PATCH /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.13 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"label": "Server-LAN Süd"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
DELETE /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.14 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
{
"ok": true,
"result": "deleted",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
PUT /reseller/api/engagements/<uuid>/assets/by-ref/<ref>/ developers.api.ep.r-eng.15 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"kind": "ip_range", "label": "Server-LAN", "value": "10.0.0.0/24", "scope_keys": ["internal_pentest"]}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/assets/by-ref/<ref>/ developers.api.ep.r-eng.16 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/by-ref/erp-2026-17/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
POST /reseller/api/engagements/<uuid>/rules/apply-template/ developers.api.ep.r-eng.17 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/apply-template/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
PATCH /reseller/api/engagements/<uuid>/rules/categories/<cat_uuid>/ developers.api.ep.r-eng.18 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"relevant": true}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
PUT /reseller/api/engagements/<uuid>/rules/items/<item_uuid>/ developers.api.ep.r-eng.19 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/items/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"answer": "yes"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
POST /reseller/api/engagements/<uuid>/rules/compile/ developers.api.ep.r-eng.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/compile/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
POST /reseller/api/engagements/<uuid>/provision/ developers.api.ep.r-eng.21 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/provision/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "provisioned",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "delivery",
"signature_state": "signed",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
POST /reseller/api/engagements/<uuid>/cancel/ developers.api.ep.r-eng.22 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/cancel/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"reason": "Auftrag zurückgezogen"}'
{
"ok": true,
"result": "cancelled",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "cancelled",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/document/pdf/ developers.api.ep.r-eng.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o roe.pdf https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="roe.pdf" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/<uuid>/document/docx/ developers.api.ep.r-eng.24 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o roe.docx https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="roe.docx" X-Content-Type-Options: nosniff
developers.api.group.r-eng-runs.title
16 Endpointsdevelopers.api.group.r-eng-runs.desc
GET /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/
{
"items": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "ERP-Server", "pentest_type": "internal", "pentester": "Max Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-pt-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
PUT /reseller/api/engagements/<uuid>/pentests/by-ref/<ref>/ developers.api.ep.r-eng-runs.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "ERP-Server", "pentest_type": "internal", "pentester": "Max Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-pt-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/pentests/by-ref/<ref>/ developers.api.ep.r-eng-runs.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/by-ref/erp-2026-17/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
GET /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
PATCH /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.5 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"end_date": "2026-12-20"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
DELETE /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.6 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
POST /reseller/api/engagements/pentests/<run_uuid>/status/ developers.api.ep.r-eng-runs.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "active"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "active",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET /reseller/api/engagements/<uuid>/audits/ developers.api.ep.r-eng-runs.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/
{
"items": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/audits/ developers.api.ep.r-eng-runs.9 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "IKT-Audit ERP", "scope": "ERP und Anbindungen", "language": "de", "lead": "Erika Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-au-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
PUT /reseller/api/engagements/<uuid>/audits/by-ref/<ref>/ developers.api.ep.r-eng-runs.10 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "IKT-Audit ERP", "scope": "ERP und Anbindungen", "language": "de", "lead": "Erika Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-au-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/audits/by-ref/<ref>/ developers.api.ep.r-eng-runs.11 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/by-ref/erp-2026-17/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
GET /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
PATCH /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.13 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"end_date": "2026-12-20"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
DELETE /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.14 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
POST /reseller/api/engagements/audits/<run_uuid>/status/ developers.api.ep.r-eng-runs.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "preparing"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "preparing",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
developers.api.group.r-eng-plan.title
26 Endpointsdevelopers.api.group.r-eng-plan.desc
POST /reseller/api/engagements/pentests/<run_uuid>/apply-methodology/ developers.api.ep.r-eng-plan.0 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/apply-methodology/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
]
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/categories/ developers.api.ep.r-eng-plan.1 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
{
"items": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/categories/ developers.api.ep.r-eng-plan.2 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Authentisierung", "external_ref": "athn"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.3 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Authentisierung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/ developers.api.ep.r-eng-plan.5 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
GET /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/
{
"items": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwörter prüfen", "severity_default": "high", "external_ref": "wstg-athn-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.8 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwörter prüfen"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/ developers.api.ep.r-eng-plan.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
PUT /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/result/ developers.api.ep.r-eng-plan.11 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/result/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "vulnerable", "note": "Anmeldung mit admin/admin möglich"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
POST /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/raise-finding/ developers.api.ep.r-eng-plan.12 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/raise-finding/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": null,
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open"
}
}
POST /reseller/api/engagements/audits/<run_uuid>/apply-template/ developers.api.ep.r-eng-plan.13 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/apply-template/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
]
}
}
GET /reseller/api/engagements/audits/<run_uuid>/categories/ developers.api.ep.r-eng-plan.14 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
{
"items": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/categories/ developers.api.ep.r-eng-plan.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Zugriffssteuerung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.16 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Zugriffssteuerung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.17 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/ developers.api.ep.r-eng-plan.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
GET /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.19 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/
{
"items": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Rollenkonzept vorhanden"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.21 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Rollenkonzept vorhanden"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.22 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/topics/<topic_uuid>/ developers.api.ep.r-eng-plan.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
POST /reseller/api/engagements/audits/<run_uuid>/topics/<topic_uuid>/raise-finding/ developers.api.ep.r-eng-plan.24 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/raise-finding/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": null,
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/questionnaire/pdf/ developers.api.ep.r-eng-plan.25 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o fragebogen.pdf https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/questionnaire/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="fragebogen.pdf" X-Content-Type-Options: nosniff
developers.api.group.r-eng-findings.title
24 Endpointsdevelopers.api.group.r-eng-findings.desc
GET /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
{
"items": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwort aktiv", "severity": "high", "affected": "erp.murmelibach.example", "external_ref": "f-erp-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwort aktiv", "severity": "high", "affected": "erp.murmelibach.example", "external_ref": "f-erp-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/ developers.api.ep.r-eng-findings.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/status/ developers.api.ep.r-eng-findings.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "fixed"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "fixed",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/ developers.api.ep.r-eng-findings.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
{
"items": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/ developers.api.ep.r-eng-findings.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Kein Rollenkonzept"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.8 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Kein Rollenkonzept"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/ developers.api.ep.r-eng-findings.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/status/ developers.api.ep.r-eng-findings.11 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "accepted"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "accepted",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.13 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske" \ -F "external_ref=login-png"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.14 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.15 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/ developers.api.ep.r-eng-findings.16 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/file/ developers.api.ep.r-eng-findings.17 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o login.png https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/
HTTP/1.1 200 OK Content-Type: image/png Content-Disposition: attachment; filename="login.png" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.19 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske" \ -F "external_ref=login-png"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.21 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/ developers.api.ep.r-eng-findings.22 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/file/ developers.api.ep.r-eng-findings.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o login.png https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/
HTTP/1.1 200 OK Content-Type: image/png Content-Disposition: attachment; filename="login.png" X-Content-Type-Options: nosniff
developers.api.group.r-eng-reports.title
26 Endpointsdevelopers.api.group.r-eng-reports.desc
GET /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
{
"items": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
GET /reseller/api/engagements/audits/<run_uuid>/reports/ developers.api.ep.r-eng-reports.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
{
"items": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/reports/ developers.api.ep.r-eng-reports.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.6 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.7 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
GET /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
PATCH /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.9 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Report ERP, Fassung 2"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
DELETE /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.10 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
GET /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.11 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/
{
"items": [
{
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.12 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"heading": "Management Summary", "body": "<p>Text</p>"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/reports/<report_uuid>/sections/<section_uuid>/ developers.api.ep.r-eng-reports.13 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82/
{
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
POST /reseller/api/engagements/reports/<report_uuid>/finalize/ developers.api.ep.r-eng-reports.14 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/finalize/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "final",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/unfinalize/ developers.api.ep.r-eng-reports.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/unfinalize/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/deliver/ developers.api.ep.r-eng-reports.16 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/deliver/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"delivered_to": "[email protected]", "delivered_at": "2026-11-18", "note": "Per verschlüsselter Mail"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "delivered",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "[email protected]",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/undeliver/ developers.api.ep.r-eng-reports.17 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/undeliver/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "final",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET /reseller/api/engagements/reports/<report_uuid>/files/docx/ developers.api.ep.r-eng-reports.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report.docx https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="report.docx" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/reports/<report_uuid>/files/pdf/ developers.api.ep.r-eng-reports.19 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report.pdf https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="report.pdf" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/reports/<report_uuid>/versions/ developers.api.ep.r-eng-reports.20 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/
{
"items": [
{
"id": "7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13",
"sha256": "9f2c…e41a",
"status_at_time": "final",
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"created_by": "Integration ERP",
"created_at": "2026-11-17T08:00:00+00:00",
"docx": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13/docx/"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/reports/<report_uuid>/versions/<version_uuid>/docx/ developers.api.ep.r-eng-reports.21 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report-v1.docx https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="report-v1.docx" X-Content-Type-Options: nosniff
POST /reseller/api/engagements/<uuid>/ai-draft/ developers.api.ep.r-eng-reports.22 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ai-draft/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
POST /reseller/api/engagements/reports/<report_uuid>/sections/<section_uuid>/ai-text/ developers.api.ep.r-eng-reports.23 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82/ai-text/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "body", "instruction": "Kürzer und für die Geschäftsleitung formulieren"}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
POST /reseller/api/engagements/reports/<report_uuid>/generate/ developers.api.ep.r-eng-reports.24 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/generate/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
GET /reseller/api/engagements/jobs/<job_uuid>/ developers.api.ep.r-eng-reports.25 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/jobs/0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53/
{
"ok": true,
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "done",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": {
"docx": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/docx/",
"pdf": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/pdf/"
},
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
developers.api.group.r-eng-library.title
10 Endpointsdevelopers.api.group.r-eng-library.desc
GET /reseller/api/engagements/library/roe-templates/ developers.api.ep.r-eng-library.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Interner Pentest",
"description": "",
"pentest_type": "internal",
"translations": {}
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/roe-templates/<uuid>/ developers.api.ep.r-eng-library.1 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Interner Pentest",
"description": "",
"pentest_type": "internal",
"translations": {}
}
GET /reseller/api/engagements/library/methodologies/ developers.api.ep.r-eng-library.2 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/methodologies/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/methodologies/<uuid>/ developers.api.ep.r-eng-library.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/methodologies/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
GET /reseller/api/engagements/library/audit-templates/ developers.api.ep.r-eng-library.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/audit-templates/<uuid>/ developers.api.ep.r-eng-library.5 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
GET /reseller/api/engagements/library/report-templates/ developers.api.ep.r-eng-library.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/report-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Pentest-Report Standard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/report-templates/<uuid>/ developers.api.ep.r-eng-library.7 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/report-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Pentest-Report Standard",
"description": ""
}
GET /reseller/api/engagements/library/vulnerabilities/ developers.api.ep.r-eng-library.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"title": "Standardkennwörter",
"severity": "high",
"cwe": "CWE-1392",
"cvss_score": "9.1"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/vulnerabilities/<uuid>/ developers.api.ep.r-eng-library.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"title": "Standardkennwörter",
"severity": "high",
"cwe": "CWE-1392",
"cvss_score": "9.1"
}
Antwortformat.
Alle API-Antworten werden als JSON zurückgegeben. Erfolgreiche Anfragen enthalten die Daten direkt, Fehler liefern ein strukturiertes Fehlerobjekt:
Erfolgreiche Antwort
{
"employees": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Mueller",
"email": "[email protected]"
}
]
}
Fehler-Antwort
{
"error": "Nicht authentifiziert",
"code": 401
}
Fehlerobjekte der Portal-APIs enthalten error (lesbare Meldung in der Sprache des Kontos) und code (HTTP-Status als Zahl); unerwartete Serverfehler (500) liefern nur error. Ein 403 tritt typischerweise auf, wenn der API-Key den Zugriffsbereich des Endpoints nicht hat — passen Sie die Freigabe des Keys im Portal unter API-Keys an.
HTTP Status Codes.
Rate Limits & Hinweise.
- 100 Requests / Min pro Token. Bei Überschreitung wird ein
429mitRetry-After-Header zurückgegeben. - Alle Zeitstempel sind in UTC (ISO 8601 Format).
- Die API wird über HTTPS bereitgestellt.
- Basis-URL: Firma (B2B), Reseller / Versicherung:
https://portal.cybertell.io· Privatpersonen:https://app.cybertell.io. Firmen mit eigener Instanz ersetzen den Host durch die Adresse ihrer Instanz – die Pfade bleiben gleich. - Paginierung: Listen-Endpoints, die in der OpenAPI-Spezifikation die Parameter
page/page_sizetragen, unterstützen?page=und?page_size=(Standard 50, max. 200). Mit Pagination enthält die Antwort zusätzlichpage,page_size,total,total_pages. Ohne Pagination-Parameter liefern manche Listen nur die neuesten 50–200 Einträge; für vollständige Listen immer?page=verwenden.
Kontakt & Support.
Fragen zur API-Integration? Wir antworten per E-Mail, in der Regel innert eines Werktags.
Technische Fragen zur API. Antwort in der Regel innert eines Werktags.
Vertrieb, Demos, Partner-Anfragen. Antwort in der Regel innert eines Werktags.