Developer & API. Intégrez CyberTell à votre infrastructure.

API REST et spécification OpenAPI pour les opérations de sécurité. Trois portails, un vocabulaire — entreprise, particuliers, revendeur.

URL de base : https://portal.cybertell.io · v0.4 · OpenAPI 3.1 · Postman Collection
# Récupérer les collaborateurscurl -H "Authorization: Bearer ctk_7f3a…" \https://portal.cybertell.io/company/api/employees/ # Response 200{ "employees": [{ "id": "c4e1…", "firstname": "Anna" }] }
01

Entreprise(B2B)

Plateforme de Security Operations pour les entreprises — tous les modules activés pour l'entreprise via une seule API.

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

Particuliers

Portail de cybersécurité individuel — compte, vérifications et contenus d'apprentissage via une seule API.

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

Revendeur/ Assurance

Portail de gestion des partenaires pour revendeurs, assureurs et communes. Gestion de toutes les entreprises et de tous les particuliers assignés.

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

Aperçu.

CyberTell met à disposition une API REST complète, organisée en trois portails. Chaque portail a sa propre authentification et ses propres endpoints. Toutes les réponses sont en JSON. Tous les horodatages sont en UTC (ISO 8601).

Authentification.

Les trois portails s’authentifient de la même manière : avec une clé API comme jeton Bearer. Chaque portail a ses propres clés, et chaque clé ne vaut que pour les périmètres choisis à sa création.

API Key Entreprise · Revendeur · Particuliers Bearer

Créez une clé API dans le portail concerné : entreprise sous Profil → Clés API, revendeur sous API → Clés API (administrateurs uniquement), particuliers sous Profil → Clés API. La clé a la forme ctk_<id>_<secret> et n’est affichée qu’une fois. Envoyez-la à chaque appel comme Authorization: Bearer <clé>.

# Utiliser la clé API de votre profil
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/employees/

Périmètres : les clés d’entreprise sont accordées pour des modules, les clés revendeur pour les clients et la facturation, les clés de particuliers pour le profil, les fuites de données, les incidents et les cours. Un endpoint hors périmètre répond 403, une clé invalide, expirée ou désactivée 401.

Entreprise : les endpoints d’administration comme les campagnes, la flotte, les rôles et les sites vérifient aussi le périmètre de module de la clé. La facturation et le design d’entreprise (/company/api/billing/, /company/api/layout/) exigent le périmètre Compte de l’entreprise, que seuls les administrateurs de l’entreprise peuvent attribuer à une clé.

Anciennes clés d’entreprise : les paires de clés d’accès (Authorization: CTAK <id>:<secret>) et les clés statiques de 64 caractères hexadécimaux fonctionnent encore pour l’instant. L’en-tête X-Company-UUID n’est plus nécessaire ; si vous l’envoyez, il doit désigner la bonne entreprise. Les nouvelles clés sont toujours des clés ctk_.

Les entreprises disposant de leur propre instance remplacent l'hôte par l'adresse de leur instance – les chemins restent identiques.

API Entreprise (B2B)

Tous les endpoints exigent une clé API d’entreprise dans l’en-tête Authorization (Bearer ctk_…), accordée pour le module de l’endpoint.

Authentification & connexion

2 Endpoints
GET /company/tickets/api/me/ Utilisateur actuel ▶
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/ Changer la langue du compte ▶
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"
}

Collaborateurs & administration

14 Endpoints
GET /company/api/employees/ Lister tous les collaborateurs ▶
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/ Créer un collaborateur ▶
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>/ Lire, modifier ou désactiver un collaborateur (DELETE définit 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/ Envoyer une invitation ▶
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/ Lister / créer des rôles ▶
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>/ Modifier ou supprimer un rôle ▶
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/ Lister les sites ▶
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/ Créer un site ▶
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>/ Détail du site ▶
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/ Types de site ▶
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/ Informations de facturation ▶
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/ Mise en page des documents (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/ Lire le profil de l'entreprise (avec listes de choix) ▶
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/ Mettre à jour le profil de l’entreprise ▶
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": []
}

Campagnes de phishing

3 Endpoints
GET /company/api/campaigns/ Lister les campagnes ▶
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/ Créer une campagne en brouillon (lancement dans le portail web) ▶
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/ Modèles & options ▶
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/ Liste des tickets (filtre : ?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/ Créer un ticket ▶
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/ Listes de choix pour les nouveaux 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>/ Détail du ticket ▶
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/ Envoyer une réponse ▶
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/ Modifier le statut ▶
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/ Modifier la priorité ▶
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/ Attribuer un ticket à une personne (admin ; vide = retirer l'attribution) ▶
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/ Modifier le titre/la description ou son propre message (avec 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/ Rechercher des personnes pour les mentions @ (?q=, sans adresses e-mail) ▶
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/ Statistiques du tableau de bord ▶
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/ Tactiques avec techniques et couverture par les tickets et actualités de l'entreprise ▶
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>/ Une technique avec les tickets et actualités associés (20 au maximum chacun) ▶
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/ Lister les war rooms ▶
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/ Créer une war room ▶
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>/ Détail de la war room ▶
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/ Récupérer les messages (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/ Envoyer un message ▶
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/ Lire, inviter ou retirer des participants ▶
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
}

Surveillance du Dark Web

4 Endpoints
GET /company/tickets/api/darkweb/ Vue d'ensemble des scans ▶
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/ Lancer un scan (domaines vérifiés uniquement) ▶
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>/ Détail du scan ▶
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/ Domaines de l’entreprise pour l’analyse ▶
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
    }
  ]
}

Analyse de phishing (EML)

2 Endpoints
POST /company/tickets/analysis/api/upload/ Téléverser un fichier EML ▶
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/ Liste des analyses ▶
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"
    }
  ]
}

Plugin de messagerie (indicateurs de phishing)

3 Endpoints

API pour le plugin Apple Mail de détection automatique du phishing. Les indicateurs sont extraits des analyses de phishing confirmées.

GET /company/tickets/api/mail-plugin/indicators/ Récupérer les indicateurs de phishing (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/ Vérifier l'e-mail par rapport aux indicateurs ▶
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>/ Détail de l'analyse pour la 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"
}

Vidéos de sensibilisation

7 Endpoints
GET /company/videos/api/list/ Liste des vidéos ▶
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/ Générer une vidéo de sensibilisation (IA ; optionnel : 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>/ Détail de la vidéo avec les diapositives ▶
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/ Relancer le rendu ▶
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/ Charger le MP4 pour le lecteur ▶
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/ Supprimer la vidéo ▶
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/ Signaler les secondes visionnées (suivi de l'achèvement) ▶
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
}

Registre des actifs

5 Endpoints

Lecture avec le module activé sur la clé ; création, modification et suppression réservées aux administrateurs de l’entreprise.

GET /company/assets/api/list/ Actifs avec évaluation des risques ▶
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/ Créer un actif ▶
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>/ Détail de l'actif ▶
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/ Lister ou créer les risques d’un actif ▶
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>/ Lire, modifier ou supprimer un risque ; accepted: true l’accepte ▶
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"
}

Tiers (fournisseurs)

3 Endpoints

Lecture avec le module activé sur la clé ; création, modification et suppression réservées aux administrateurs de l’entreprise.

GET /company/suppliers/api/list/ Lister les fournisseurs ▶
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/ Créer un fournisseur ▶
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>/ Détail du fournisseur ▶
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"
}

Évaluation TIC

7 Endpoints

Lecture avec le module activé sur la clé ; création, modification et suppression réservées aux administrateurs de l’entreprise.

GET /company/ict/api/list/ Lister les évaluations (?include_auto=1 inclut le reflet CyberTell) ▶
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/ Catalogue des exigences d'une norme (fonctions, catégories, exigences ; ?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/ Créer une évaluation ▶
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>/ Détail de l'évaluation ▶
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/ Enregistrer la réponse ▶
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/ Standards de conformité disponibles ▶
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/ Rapport de conformité en 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 …

Évaluation AD

3 Endpoints

Lecture avec le module activé sur la clé ; création, modification et suppression réservées aux administrateurs de l’entreprise.

GET /company/ad/api/list/ Lister les dumps AD ▶
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/ Téléverser un dump AD ▶
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>/ Détail du dump ▶
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"
}

Évaluation Microsoft 365

3 Endpoints

Lecture avec le module activé sur la clé ; création, modification et suppression réservées aux administrateurs de l’entreprise.

GET /company/azure/api/list/ Lister les dumps Azure ▶
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/ Téléverser un dump Azure ▶
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>/ Détail du dump ▶
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"
}

Gestion des risques

2 Endpoints
GET /company/risk/api/list/ Lister les risques ▶
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/ Créer un risque ▶
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"
}

Dépendances & panne

16 Endpoints

Lire et simuler nécessitent l’autorisation du module sur la clé ; seuls les administrateurs de l’entreprise modifient la carte, les processus, les groupes et les scénarios.

GET /company/data-flows/api/mobile/ Indicateurs, points de défaillance uniques et scénarios de panne ▶
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/ Carte : tous les nœuds, flux et groupes ▶
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/ Placer un fournisseur, un actif ou un processus sur la carte (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>/ Retirer un nœud et ses flux de la carte ; le fournisseur, l’actif ou le processus reste ▶
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/ Créer un flux entre deux nœuds ▶
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>/ Modifier un flux (seulement les champs envoyés) ou le supprimer ▶
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/ Lister ou créer des processus métier (placés directement sur la carte) ▶
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>/ Lire, modifier ou supprimer un processus métier ▶
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/ Lister ou créer des groupes ▶
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>/ Renommer un groupe, définir (nodes), ajouter (add) ou retirer (remove) des nœuds, ou supprimer le groupe ▶
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/ Simuler une panne sans rien enregistrer (déclencheur par nœud ou par fournisseur, actif, processus) ▶
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/ Lister les scénarios enregistrés ou enregistrer une simulation comme scénario ▶
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>/ Lire un scénario avec son résultat ou le supprimer ▶
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/ État des pages de statut par nœud et effet des perturbations en cours ▶
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/ Historique des perturbations des fournisseurs, les plus récentes d’abord ; ?open=1 seulement celles en cours ▶
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/ Lire et définir la position des nœuds ▶
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
}

Sauvegarde & restauration

1 Endpoint
GET /company/backups/api/mobile/ Plans de sauvegarde avec tests de restauration et actifs non protégés ▶
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": []
}

Surface d'attaque

1 Endpoint
GET /company/attack-surface/api/mobile/ Indicateurs, dernière analyse, constats ouverts et actifs ▶
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
    }
  ]
}

Interdictions d'accès

3 Endpoints
GET /company/banning-orders/api/list/ Lister les interdictions d'accès (les 100 plus récentes) ▶
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/ Créer une interdiction d'accès ▶
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>/ Détail de l'interdiction d'accès ▶
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
}

Exercices sur table

6 Endpoints
GET /company/tabletop/api/scenarios/ Lister les scénarios ▶
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/ Générer un scénario (IA) ▶
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>/ Détail du scénario ▶
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/ Lister les négociations ▶
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>/ Détail de la négociation ▶
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/ Envoyer un message ▶
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, parc d'appareils & rapport de menaces

8 Endpoints
GET /company/api/soc/status/ Statut du hub SOC (pare-feu configuré) ▶
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/ Lire / enregistrer la configuration du rapport de menaces (role_id en UUID ou entier interne) ▶
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/ Données en direct d'un fournisseur SOC (provider = firewalla, pfsense, sophos, defender, graylog ; fenêtre ?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/ Flux agrégés d'un appareil sur la dernière heure (?device= obligatoire, ?region= facultatif) ▶
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/ Attribuer des appareils aux collaborateurs (admin ; mitarbeiter_id en UUID ou entier interne) ▶
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/ Analyse IA d'une alarme (champs de formulaire ; aussi sous /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/ Vérifier une destination suspecte (action=vt|ai|both ; aussi sous /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/ Dernier rapport de situation ▶
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"
  }
}

Intégration Firewalla

13 Endpoints
GET /company/api/firewalla/overview/ Vue d'ensemble du tableau de bord ▶
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/ Lister les appareils (boxes) ▶
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>/ Détail de la box ▶
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/ Appareils d'une 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/ Flux de trafic (?query=, ?groupBy=, ?sortBy=, ?cursor=, ?limit= 50 par défaut, 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/ Trafic d'un appareil (?device= obligatoire, ?region= facultatif) ▶
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/ Statistiques de la fleet ▶
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/ Flux SOC en direct ▶
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/ Pays bloqués ▶
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/ Gérer les domaines bloqués ▶
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/ Gérer les attributions d'appareils (mitarbeiter_id en UUID ou entier interne) ▶
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/ Mettre la règle en pause ▶
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/ Reprendre la règle ▶
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 (réponse aux incidents)

14 Endpoints
GET /company/playbooks/api/list/ Lister les playbooks ▶
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/ Créer un playbook (optionnellement avec contenu IA, 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>/ Détail du playbook ▶
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 en 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/ Lister les exécutions (?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/ Options pour l’activation : playbooks avec questions de vérification, systèmes, prestataires, 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/ Démarrer une exécution (exercice ou incident) avec systèmes, prestataires, lien et vérification du cas ▶
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>/ Détail d’une exécution : sections et étapes avec état, vérification du cas, systèmes et prestataires concernés, droits ▶
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/ Remplacer les systèmes et prestataires concernés (sans la clé suppliers, les prestataires restent inchangés) ▶
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/ Définir les réponses de la vérification du cas (true, false ou null = ouvert) ▶
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/ Cocher, ignorer ou rouvrir une étape (offen|erledigt|uebersprungen), avec note facultative ▶
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/ Terminer ou interrompre une exécution (action=finish|abort), note de clôture, revue facultative ▶
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/ Supprimer une exécution (administrateur de l’entreprise uniquement) ▶
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/ Exécution en 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 …

Politique de sécurité

3 Endpoints

Les collaborateurs consultent la politique de sécurité en vigueur et la confirment. Les confirmations sont journalisées comme preuves de conformité.

GET /company/policy/api/ Récupérer la politique actuelle ▶
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/ Confirmer la politique (collaborateur) ▶
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/ Directive en 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 …

Documents sécurisés

1 Endpoint
GET /company/api/documents/ Documents d’entreprise partagés ▶
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"
    }
  ]
}

Points

1 Endpoint
GET /company/api/points/me/ Points personnels et classement ▶
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 }
    ]
  }
}

Feuille de route

2 Endpoints
GET /company/roadmap/api/mobile/ Phases, progression et prochaines étapes ▶
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/ Terminer ou reporter une étape ▶
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/ Indicateurs et rapports DMARC ▶
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>/ Rapport avec alignement et sources en échec ▶
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"
    }
  ]
}

Réponse aux incidents

1 Endpoint
GET /company/api/mobile/incident-response/ Investigations et indicateurs (?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 }
}

Journal d’audit

1 Endpoint
GET /company/tickets/api/audit-log/ Journal d'audit de l'entreprise (100 derniers événements, administrateurs uniquement) ▶
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"
    }
  ]
}

API Particuliers.

Tous les endpoints exigent une clé API de particulier dans l’en-tête Authorization (Bearer ctk_…). Une clé ne voit que les données de la personne qui l’a créée.

Tableau de bord & profil

2 Endpoints
GET /individual/api/dashboard/ Vue d'ensemble du tableau de bord (courses_* compte les tentatives d'examen) ▶
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/ Données du profil ▶
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]" } ] }
  }
}

Vérifications de fuites d'e-mail

2 Endpoints
GET /individual/api/leak-checks/ Liste des vérifications de fuites ▶
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>/ Détail avec les fuites ▶
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": "" }
    ]
  }
}

Cours

1 Endpoint
GET /individual/api/courses/ Cours de la personne avec progression (même sélection que /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" }
    }
  ]
}

Revendeur / API assureur.

Tous les endpoints exigent une clé API revendeur dans l’en-tête Authorization (Bearer ctk_…). La facturation exige en plus que la clé ait été créée par un administrateur qui l’est toujours.

Dashboard

1 Endpoint
GET /reseller/api/dashboard/ Vue d'ensemble ▶
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
  }
}

Entreprises

6 Endpoints
GET /reseller/api/companies/ Lister les entreprises gérées ▶
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>/ Détail de l'entreprise ▶
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/ Situation de sécurité de tous les clients ▶
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/ CVE ouvertes de tous les clients ▶
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/ Assets actifs de tous les clients ▶
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/ Situation de sécurité d'un client ▶
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
  }
}

Facturation

6 Endpoints

Factures groupées et coûts par client pour votre propre comptabilité. Chaque position indique l’entreprise cliente, le nombre de collaborateurs, le plan, la quantité et l’unité, le prix catalogue, le rabais partenaire et le montant net. Nécessite une clé API avec le domaine « Facturation » créée par un administrateur du partenaire ; les coûts par client sont réservés aux partenaires IT. Sans prix catalogue (on-premises), les montants de la période en cours sont null ; les anciennes factures renvoient les nouveaux champs à null.

GET /reseller/api/billing/ Aperçu avec totaux, montants ouverts et période en cours ▶
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/ Clients avec collaborateurs, plan, abonnement et coûts de la période en cours ▶
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>/ Client avec état actuel, abonnement et historique des factures ▶
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/ Factures avec clients et total des collaborateurs, filtrables par statut ; ?include=lines ajoute les positions ▶
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>/ Facture avec toutes les positions par client ▶
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/ Facture en 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"
}

Format de réponse.

Toutes les réponses de l'API sont renvoyées en JSON. Les requêtes réussies contiennent directement les données, les erreurs renvoient un objet d'erreur structuré :

Réponse réussie

{
  "employees": [
    {
      "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "firstname": "Anna",
      "lastname": "Mueller",
      "email": "[email protected]"
    }
  ]
}

Réponse d'erreur

{
  "error": "Non authentifié",
  "code": 401
}

Les objets d’erreur des API des portails contiennent error (un message lisible dans la langue du compte) et code (le statut HTTP sous forme de nombre) ; les erreurs serveur inattendues (500) ne renvoient que error. Un 403 survient généralement lorsque la clé API n’a pas le périmètre de l’endpoint — ajustez le périmètre de la clé dans le portail sous Clés API.

Codes de statut HTTP.

200 Succès
201 Créé avec succès
202 Accepté, pas encore terminé (interroger à nouveau)
400 Requête invalide
401 Non authentifié
403 Aucune autorisation
404 Introuvable
405 Méthode non autorisée
409 Conflit avec l'état actuel (p. ex. déjà en cours, verrouillé)
410 Endpoint supprimé
429 Limite de débit atteinte
500 Erreur interne du serveur
503 Service temporairement indisponible (IA, génération PDF, worker de rendu)

Limites de débit & remarques.

  • 100 requêtes / min par jeton. En cas de dépassement, un 429 avec en-tête Retry-After est renvoyé.
  • Tous les horodatages sont en UTC (format ISO 8601).
  • L'API est fournie via HTTPS.
  • URL de base : Entreprise (B2B), Revendeur / assureur: https://portal.cybertell.io · Particuliers: https://app.cybertell.io. Les entreprises disposant de leur propre instance remplacent l'hôte par l'adresse de leur instance – les chemins restent identiques.
  • Pagination : les endpoints de liste qui portent les paramètres page/page_size dans la spécification OpenAPI prennent en charge ?page= et ?page_size= (50 par défaut, max. 200). Avec pagination, la réponse contient en plus page, page_size, total, total_pages. Sans paramètres de pagination, certaines listes ne renvoient que les 50 à 200 entrées les plus récentes ; utilisez toujours ?page= pour des listes complètes.

Contact & support.

Des questions sur l'intégration de l'API ? Nous répondons par e-mail, en règle générale dans un jour ouvrable.

Support développeurs
[email protected]

Questions techniques sur l'API. Réponse en règle générale dans un jour ouvrable.

Contact général
[email protected]

Ventes, démos, demandes de partenariat. Réponse en règle générale dans un jour ouvrable.