Developer & API. Integrieren Sie CyberTell in Ihre Infrastruktur.

REST API und OpenAPI-Spezifikation für Sicherheitsoperationen. Drei Portale, ein Vokabular — Firma, Privatpersonen, Reseller.

Basis-URL: https://portal.cybertell.io · v0.4 · OpenAPI 3.1 · Postman Collection
# Mitarbeiter abrufencurl -H "Authorization: Bearer ctk_7f3a…" \https://portal.cybertell.io/company/api/employees/ # Response 200{ "employees": [{ "id": "c4e1…", "firstname": "Anna" }] }
01

Firma(B2B)

Security Operations Platform für Unternehmen — alle für die Firma freigeschalteten Module über eine API.

https://portal.cybertell.io
API-Key (Bearer) 150 Endpoints
02

Privatpersonen

Individuelles Cyber Security Portal — Konto, Prüfungen und Lerninhalte über eine API.

https://app.cybertell.io
API-Key (Bearer) 5 Endpoints
03

Reseller/ Versicherung

Partner-Management-Portal für Reseller, Versicherungen und Gemeinden. Verwaltung aller zugeordneten Firmen und Privatpersonen.

https://portal.cybertell.io
API-Key (Bearer) 139 Endpoints

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

API Key Firma · Reseller · Privatpersonen Bearer

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 Endpoints
GET /company/tickets/api/me/ Aktueller Benutzer ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/me/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "ok": true,
  "language": "fr"
}

Mitarbeiter & Verwaltung

14 Endpoints
GET /company/api/employees/ Alle Mitarbeiter auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/employees/
Response
{
  "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 ▶
Request
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}'
Response
{
  "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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
  "invitation_sent": true
}
GET/POST /company/api/roles/ Rollen auflisten / anlegen ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/roles/
Response
{
  "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 ▶
Request
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]}'
Response
{
  "id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
  "name": "Werkstatt",
  "is_default": false,
  "is_external": false
}
GET /company/api/locations/ Standorte auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/locations/
Response
{
  "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 ▶
Request
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]}'
Response
{
  "id": "e7f9a1c3-5b2d-4c84-9e16-7a3c5e9b1d40",
  "name": "Filiale Tannenhof"
}
GET/PATCH/PUT/DEL /company/api/locations/<uuid>/ Standort-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/locations/a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/location-types/
Response
{
  "types": [
    { "id": 1, "name": "Büro", "key": "office" },
    { "id": 2, "name": "Rechenzentrum", "key": "datacenter" }
  ]
}
GET /company/api/billing/ Billing-Informationen ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/billing/
Response
{
  "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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/layout/
Response
{
  "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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/company-profile/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 Endpoints
GET /company/api/campaigns/ Kampagnen auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/campaigns/
Response
{
  "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) ▶
Request
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"}'
Response
{
  "id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
  "name": "Q2 Awareness"
}
GET /company/api/campaigns/options/ Vorlagen & Optionen ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/campaigns/options/
Response
{
  "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 Endpoints
GET /company/tickets/api/list/ Ticket-Liste (Filter: ?status=, ?category=, ?type=employee|incident, ?q=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/list/?status=offen&category=phishing
Response
{
  "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 ▶
Request
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"}'
Response
{
  "ticket_id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
  "message": "Ticket erstellt."
}
GET /company/tickets/api/options/ Auswahllisten für neue Tickets ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/options/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/
Response
{
  "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 ▶
Request
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": []}'
Response
{
  "message_id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
  "message": "Antwort gespeichert."
}
POST /company/tickets/api/<uuid>/status/ Status ändern ▶
Request
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"}'
Response
{
  "message": "Status aktualisiert."
}
POST /company/tickets/api/<uuid>/priority/ Priorität ändern ▶
Request
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"}'
Response
{
  "message": "Priorität aktualisiert."
}
POST /company/tickets/api/<uuid>/assign/ Ticket einer Person zuweisen (Admin; leer = Zuweisung entfernen) ▶
Request
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"}'
Response
{
  "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) ▶
Request
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"}'
Response
{
  "changed": ["title"]
}
GET /company/tickets/api/<uuid>/mentionable/ Personen für @-Erwähnungen suchen (?q=, ohne E-Mail-Adressen) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/mentionable/?q=an
Response
{
  "results": [
    { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "is_admin": false }
  ]
}
GET /company/tickets/api/dashboard/ Dashboard-Statistiken ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/dashboard/
Response
{
  "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 Endpoints
GET /company/tickets/mitre/api/mobile/ Taktiken mit Techniken und Abdeckung durch eigene Tickets und News ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/mitre/api/mobile/
Response
{
  "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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/mitre/api/mobile/T1566/
Response
{
  "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 Endpoints
GET /company/tickets/api/warrooms/ War Rooms auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/warrooms/?status=aktiv
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/
Response
{
  "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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/messages/?after=500
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",
      "attachments": []
    }
  ]
}
POST /company/tickets/warroom/<uuid>/api/send/ Nachricht senden ▶
Request
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."}'
Response
{
  "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 ▶
Request
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": []}'
Response
{
  "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 Endpoints
GET /company/tickets/api/darkweb/ Scan-Übersicht ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/darkweb/
Response
{
  "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) ▶
Request
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}'
Response
{
  "id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
  "domain": "murmelibach-ag.ch"
}
GET /company/tickets/api/darkweb/<uuid>/ Scan-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/darkweb/7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/darkweb/domains/
Response
{
  "domains": [
    {
      "domain": "murmelibach-ag.ch",
      "is_primary": true,
      "is_verified": true
    }
  ]
}

Phishing-Analyse (EML)

2 Endpoints
POST /company/tickets/analysis/api/upload/ EML-Datei hochladen ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/analysis/api/upload/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -F "[email protected]"
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/analysis/api/list/
Response
{
  "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 Endpoints

API 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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/mail-plugin/indicators/?since=2026-05-01T00:00:00Z
Response
{
  "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 ▶
Request
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"]}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/mail-plugin/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/
Response
{
  "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 Endpoints
GET /company/videos/api/list/ Video-Liste ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/videos/api/list/
Response
{
  "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) ▶
Request
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": ""}'
Response
{
  "job_id": "f7b9d1e3-5d7a-4f02-9c38-4e6a8b0d2f35",
  "status": "generating"
}
GET /company/videos/api/<uuid>/ Video-Detail mit Folien ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "status": "rendering",
  "phase": "waiting",
  "position": 1,
  "status_display": "In Warteschlange"
}
GET /company/videos/api/<uuid>/video/ MP4 für den Player laden ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o awareness.mp4 https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/
Response
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 ▶
Request
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 '{}'
Response
{
  "status": "deleted"
}
POST /company/videos/api/<uuid>/progress/ Angesehene Sekunden melden (Abschluss-Erfassung) ▶
Request
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}'
Response
{
  "progress_pct": 79,
  "completed": false
}

Asset-Register

5 Endpoints

Lesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.

GET /company/assets/api/list/ Assets mit Risikobewertung ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/assets/api/list/
Response
{
  "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 ▶
Request
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]"}'
Response
{
  "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
  "name": "Fileserver FS01"
}
GET/PATCH/PUT/DEL /company/assets/api/<uuid>/ Asset-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 Endpoints

Lesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.

GET /company/suppliers/api/list/ Lieferanten auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/suppliers/api/list/
Response
{
  "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 ▶
Request
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}'
Response
{
  "id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
  "name": "Wolkensoftware Eidgenossenschaft"
}
GET/PATCH/PUT/DEL /company/suppliers/api/<uuid>/ Lieferant-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/suppliers/api/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/
Response
{
  "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 Endpoints

Lesen 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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/list/
Response
{
  "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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/catalog/?standard=ikt
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "ok": true,
  "completion_percent": 42,
  "overall_score": 2.2,
  "review_status": "",
  "transferred": []
}
GET /company/ict/api/standards/ Verfügbare Compliance-Standards ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/standards/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o compliance-report.pdf https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="compliance-report.pdf"

%PDF-1.7 …

AD Assessment

3 Endpoints

Lesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.

GET /company/ad/api/list/ AD-Dumps auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ad/api/list/
Response
{
  "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 ▶
Request
curl -X POST https://portal.cybertell.io/company/ad/api/upload/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -F "dump_file=@ad_dump.json"
Response
{
  "id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
  "status": "analysed"
}
GET /company/ad/api/<uuid>/ Dump-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ad/api/3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74/
Response
{
  "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 Endpoints

Lesen mit Modul-Freigabe des Keys; anlegen, ändern und löschen nur Firmen-Admins.

GET /company/azure/api/list/ Azure-Dumps auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/azure/api/list/
Response
{
  "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 ▶
Request
curl -X POST https://portal.cybertell.io/company/azure/api/upload/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -F "dump_file=@azure_export.json"
Response
{
  "id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
  "status": "analysed"
}
GET /company/azure/api/<uuid>/ Dump-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/azure/api/2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60/
Response
{
  "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 Endpoints
GET /company/risk/api/list/ Risiken auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/risk/api/list/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
  "title": "Ransomware",
  "target_likelihood": 1,
  "target_impact": 4,
  "target_score": 4,
  "target_level": "medium"
}

Abhängigkeiten & Ausfall

16 Endpoints

Lesen 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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/mobile/
Response
{
  "node_count": 14,
  "edge_count": 22,
  "process_count": 5,
  "spof": [],
  "scenarios": []
}
GET /company/data-flows/api/map/ Karte: alle Knoten, Flüsse und Gruppen ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/map/
Response
{
  "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) ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -X DELETE https://portal.cybertell.io/company/data-flows/api/nodes/5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…"
Response
{
  "ok": true
}
POST /company/data-flows/api/edges/ Fluss zwischen zwei Knoten anlegen ▶
Request
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"]}'
Response
{
  "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 ▶
Request
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}'
Response
{
  "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) ▶
Request
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}'
Response
{
  "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 ▶
Request
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}'
Response
{
  "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 ▶
Request
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"]}'
Response
{
  "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 ▶
Request
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"]}'
Response
{
  "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) ▶
Request
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}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/scenarios/2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/status/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/outages/
Response
{
  "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 ▶
Request
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}}}'
Response
{
  "ok": true,
  "updated": 1
}

Backup & Wiederherstellung

1 Endpoint
GET /company/backups/api/mobile/ Backup-Pläne mit Wiederherstellungstests und ungeschützten Assets ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/backups/api/mobile/
Response
{
  "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 Endpoint
GET /company/attack-surface/api/mobile/ Kennzahlen, letzter Lauf, offene Befunde und Assets ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/attack-surface/api/mobile/
Response
{
  "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 Endpoints
GET /company/banning-orders/api/list/ Hausverbote auflisten (neueste 100) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/banning-orders/api/list/
Response
{
  "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 ▶
Request
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]"
Response
{
  "id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
  "status": "ok"
}
GET/PATCH/PUT/DEL /company/banning-orders/api/<uuid>/ Hausverbot-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/banning-orders/api/8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60/
Response
{
  "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 Endpoints
GET /company/tabletop/api/scenarios/ Szenarien auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/scenarios/
Response
{
  "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) ▶
Request
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}'
Response
{
  "job_id": "6d8f0a24-5c7e-4b91-8a36-2f4a6c8e0d51",
  "status": "generating"
}
GET /company/tabletop/api/scenarios/<uuid>/ Szenario-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/scenarios/1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/negotiations/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/
Response
{
  "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 ▶
Request
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."}'
Response
{
  "message": "Sie haben 24 Stunden.",
  "current_ransom": 125000,
  "trust_level": 35,
  "threat_level": 75,
  "status": "active",
  "outcome": ""
}

SOC, Geräteflotte & Threat Report

8 Endpoints
GET /company/api/soc/status/ SOC-Hub-Status (konfigurierte Firewall) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/soc/status/
Response
{
  "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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/threat-reports/config/
Response
{
  "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=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/soc/firewalla/live/?start_ts=1778914800&end_ts=1778918400
Response
{
  "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=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/soc/firewalla/device-flows/?device=WS-042
Response
{
  "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) ▶
Request
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": ""}'
Response
{
  "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/) ▶
Request
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'
Response
{
  "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/) ▶
Request
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'
Response
{
  "vt": [
    { "url": "198.51.100.7", "verdict": "malicious", "source": "ipsum", "score": 4 }
  ],
  "ai": "ZUSAMMENFASSUNG: …"
}
GET /company/api/threat-report/latest/ Letzter Bedrohungslage-Report ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/threat-report/latest/
Response
{
  "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 Endpoints
GET /company/api/firewalla/overview/ Dashboard-Übersicht ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/overview/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/devices/
Response
{
  "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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/flows/?limit=200
Response
{
  "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=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/device-flows/?device=WS-042
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/stats/
Response
{
  "stats": { "onlineBoxes": 2, "offlineBoxes": 0, "alarms": 7, "rules": 64 }
}
GET /company/api/firewalla/soc-live/ Live-SOC-Feed ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/soc-live/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "success": true,
  "country_code": "RU",
  "action": "blocked"
}
GET/POST/DEL /company/api/firewalla/blocked-domains/ Blockierte Domains verwalten ▶
Request
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"}'
Response
{
  "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) ▶
Request
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": ""}'
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "ok": true,
  "message": "Regel 55 pausiert."
}
POST /company/api/firewalla/rules/<rule_id>/resume/ Regel fortsetzen ▶
Request
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 '{}'
Response
{
  "ok": true,
  "message": "Regel 55 fortgesetzt."
}

Playbooks (Incident Response)

14 Endpoints
GET /company/playbooks/api/list/ Playbooks auflisten ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/list/
Response
{
  "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) ▶
Request
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}'
Response
{
  "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
  "title": "Ransomware Response"
}
GET /company/playbooks/api/<uuid>/ Playbook-Detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o playbook.pdf https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/pdf/
Response
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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/runs/?status=laufend
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/runs/options/
Response
{
  "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 ▶
Request
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}}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/
Response
{
  "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) ▶
Request
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"]}'
Response
{
  "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
  "assets": [], "suppliers": []
}
POST /company/playbooks/api/runs/<uuid>/answers/ Fallcheck-Antworten setzen (true, false oder null = offen) ▶
Request
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}}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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}'
Response
{
  "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) ▶
Request
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 '{}'
Response
{
  "ok": true
}
GET /company/playbooks/api/runs/<uuid>/pdf/ Lauf als PDF ▶
Request
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/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="playbook-lauf.pdf"

%PDF-1.7 …

Security Policy

3 Endpoints

Mitarbeiter rufen die aktuelle Sicherheitsrichtlinie ab und bestätigen sie. Bestätigungen werden für Compliance-Nachweise protokolliert.

GET /company/policy/api/ Aktuelle Policy abrufen ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/policy/api/
Response
{
  "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) ▶
Request
curl -X POST https://portal.cybertell.io/company/policy/api/acknowledge/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "status": "ok"
}
GET /company/policy/api/mobile/pdf/ Richtlinie als PDF ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o sicherheitsrichtlinie.pdf https://portal.cybertell.io/company/policy/api/mobile/pdf/?lang=de
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="sicherheitsrichtlinie.pdf"

%PDF-1.7 …

Sichere Dokumente

1 Endpoint
GET /company/api/documents/ Freigegebene Firmen-Dokumente ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/documents/
Response
{
  "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 Endpoint
GET /company/api/points/me/ Eigene Punkte und Rangliste ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/points/me/
Response
{
  "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 Endpoints
GET /company/roadmap/api/mobile/ Phasen, Fortschritt und nächste Schritte ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/roadmap/api/mobile/
Response
{
  "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 ▶
Request
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'
Response
{
  "ok": true,
  "progress": 38
}

DMARC

2 Endpoints
GET /company/dmarc/api/mobile/ DMARC-Kennzahlen und Reports ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/dmarc/api/mobile/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/dmarc/api/mobile/7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91/
Response
{
  "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 Endpoint
GET /company/api/mobile/incident-response/ Untersuchungen und Kennzahlen (?severity=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/mobile/incident-response/?status=aktiv
Response
{
  "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 Endpoint
GET /company/tickets/api/audit-log/ Audit-Log der Firma (letzte 100 Ereignisse, nur Firmen-Admins) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/audit-log/
Response
{
  "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 Endpoints
GET /individual/api/dashboard/ Dashboard-Übersicht (courses_* zählt Prüfungsversuche) ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/dashboard/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/profile/
Response
{
  "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 Endpoints
GET /individual/api/leak-checks/ Leak-Check-Liste ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/leak-checks/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/leak-checks/d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92/
Response
{
  "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 Endpoint
GET /individual/api/courses/ Kurse der Person mit Fortschritt (dieselbe Auswahl wie /individual/courses/api/certifications/) ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/courses/
Response
{
  "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 Endpoint
GET /reseller/api/dashboard/ Übersicht ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/dashboard/
Response
{
  "dashboard": {
    "type": "reseller",
    "company_count": 12,
    "active_companies": 10,
    "total_employees": 240,
    "open_tickets": 5,
    "sponsored_persons": 0
  }
}

Companies

6 Endpoints
GET /reseller/api/companies/ Verwaltete Firmen auflisten ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/security/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/security/cves/?kev=1
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/security/assets/?criticality=critical
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/security/
Response
{
  "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 Endpoints

Sammelrechnungen 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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/customers/?include_own=0
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/customers/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/invoices/?status=open
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o rechnung.pdf https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/pdf/
Response
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 Endpoints

developers.api.group.r-eng.desc

GET /reseller/api/engagements/ developers.api.ep.r-eng.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response
{
  "ok": true,
  "result": "deleted"
}
POST /reseller/api/engagements/<uuid>/complete-definition/ developers.api.ep.r-eng.5 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/
Response
{
  "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 ▶
Request
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"]}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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…"
Response
{
  "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 ▶
Request
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"]}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o roe.pdf https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/
Response
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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o roe.docx https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/
Response
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 Endpoints

developers.api.group.r-eng-runs.desc

GET /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response

POST /reseller/api/engagements/pentests/<run_uuid>/status/ developers.api.ep.r-eng-runs.7 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response

POST /reseller/api/engagements/audits/<run_uuid>/status/ developers.api.ep.r-eng-runs.15 ▶
Request
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"}'
Response
{
  "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 Endpoints

developers.api.group.r-eng-plan.desc

POST /reseller/api/engagements/pentests/<run_uuid>/apply-methodology/ developers.api.ep.r-eng-plan.0 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
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/
Response
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 Endpoints

developers.api.group.r-eng-findings.desc

GET /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"
Response
{
  "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 ▶
Request
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"
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
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 ▶
Request
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/
Response
{
  "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 ▶
Request
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"
Response
{
  "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 ▶
Request
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"
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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/
Response
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 Endpoints

developers.api.group.r-eng-reports.desc

GET /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response

GET /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.11 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/
Response
{
  "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 ▶
Request
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>"}'
Response
{
  "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 ▶
Request
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/
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
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/
Response
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 ▶
Request
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/
Response
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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/
Response
{
  "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 ▶
Request
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/
Response
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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
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"}'
Response
{
  "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 ▶
Request
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 '{}'
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/jobs/0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53/
Response
{
  "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 Endpoints

developers.api.group.r-eng-library.desc

GET /reseller/api/engagements/library/roe-templates/ developers.api.ep.r-eng-library.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/methodologies/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/methodologies/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/report-templates/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/report-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/
Response
{
  "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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "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.

200 Erfolg
201 Erfolgreich erstellt
202 Angenommen, noch nicht fertig (erneut abfragen)
400 Ungültige Anfrage
401 Nicht authentifiziert
403 Keine Berechtigung
404 Nicht gefunden
405 Methode nicht erlaubt
409 Konflikt mit dem aktuellen Zustand (z. B. läuft bereits, gesperrt)
410 Endpoint entfernt
429 Rate Limit erreicht
500 Interner Serverfehler
503 Dienst vorübergehend nicht verfügbar (KI, PDF-Erzeugung, Render-Worker)

Rate Limits & Hinweise.

  • 100 Requests / Min pro Token. Bei Überschreitung wird ein 429 mit Retry-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_size tragen, unterstützen ?page= und ?page_size= (Standard 50, max. 200). Mit Pagination enthält die Antwort zusätzlich page, 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.

Developer-Support
[email protected]

Technische Fragen zur API. Antwort in der Regel innert eines Werktags.

Allgemeiner Kontakt
[email protected]

Vertrieb, Demos, Partner-Anfragen. Antwort in der Regel innert eines Werktags.