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.
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 EndpointsGET /company/tickets/api/me/ Utilisateur actuel ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/me/
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"first_name": "Max",
"last_name": "Muster",
"email": "[email protected]",
"is_admin": true,
"company_name": "Murmelibach AG",
"company_uuid": "2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02",
"language": "de",
"modules": ["incidents", "phishing_analysis", "courses"],
"has_firewalla": true,
"gamification_enabled": true,
"profile_image_url": null,
"company_logo_url": "https://cybertell.io/media/logos/murmelibach.png"
}
POST /company/tickets/api/me/language/ Changer la langue du compte ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/me/language/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"language": "fr"}'
{
"ok": true,
"language": "fr"
}
Collaborateurs & administration
14 EndpointsGET /company/api/employees/ Lister tous les collaborateurs ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/employees/
{
"employees": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"status_display": "Aktiv",
"is_company_admin": false,
"language": "de",
"roles": [{"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d", "name": "Mitarbeiter"}],
"last_login": "2026-06-10T08:15:00+00:00",
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
POST /company/api/employees/create/ Créer un collaborateur ▶
curl -X POST https://portal.cybertell.io/company/api/employees/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"firstname": "Anna", "lastname": "Müller", "email": "[email protected]", "language": "de", "is_company_admin": false, "role_ids": ["a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d"], "send_invite_now": true}'
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"is_company_admin": false,
"invitation_sent": true
}
GET/PATCH/PUT/DEL /company/api/employees/<uuid>/ Lire, modifier ou désactiver un collaborateur (DELETE définit status=inactive) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"status_display": "Aktiv",
"is_company_admin": false,
"language": "de",
"phone": "",
"department": "",
"position": "",
"roles": [{"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d", "name": "Mitarbeiter"}],
"certifications": [{"id": "3b9d1f72-8c4a-4e15-9a6b-2d7e0c1f5a83", "title": "Security Awareness Basis"}],
"totp_enabled": false,
"passkey_enabled": true,
"last_login": "2026-06-10T08:15:00+00:00",
"private_email": "",
"company_mobile": "",
"private_mobile": "",
"country": "ch"
}
POST /company/api/employees/<uuid>/invite/ Envoyer une invitation ▶
curl -X POST https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/invite/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"invitation_sent": true
}
GET/POST /company/api/roles/ Lister / créer des rôles ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/roles/
{
"roles": [
{
"id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"name": "Werkstatt",
"is_default": false,
"is_external": false,
"modules": [{"id": 3, "key": "incidents", "name": "Vorfälle"}],
"member_count": 8
}
]
}
PATCH/DELETE /company/api/roles/<uuid>/ Modifier ou supprimer un rôle ▶
curl -X PATCH https://portal.cybertell.io/company/api/roles/b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Werkstatt", "is_external": false, "module_ids": [3]}'
{
"id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"name": "Werkstatt",
"is_default": false,
"is_external": false
}
GET /company/api/locations/ Lister les sites ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/locations/
{
"locations": [
{
"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
"name": "Hauptsitz Murmelibach",
"street": "Dorfstrasse 12",
"address": "Dorfstrasse 12",
"zip_code": "3000",
"city": "Murmelibach",
"country_code": "ch",
"country": "ch",
"location_types": [{"id": 1, "name": "Büro", "key": "office"}],
"ai_risk_level": "",
"ai_risk_analysis": "",
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
POST /company/api/locations/create/ Créer un site ▶
curl -X POST https://portal.cybertell.io/company/api/locations/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Filiale Tannenhof", "street": "Bahnhofstrasse 3", "zip_code": "3011", "city": "Bern", "country_code": "ch", "employee_count": 6, "location_type_ids": [1]}'
{
"id": "e7f9a1c3-5b2d-4c84-9e16-7a3c5e9b1d40",
"name": "Filiale Tannenhof"
}
GET/PATCH/PUT/DEL /company/api/locations/<uuid>/ Détail du site ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/locations/a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d/
{
"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
"name": "Hauptsitz Murmelibach",
"street": "Dorfstrasse 12",
"zip_code": "3000",
"city": "Murmelibach",
"country_code": "ch",
"description": "",
"notes": "",
"location_types": [{"id": 1, "name": "Büro", "key": "office"}],
"employee_count": 24,
"has_servers": true,
"has_network_infrastructure": true,
"has_physical_security": true,
"has_backup_power": false,
"has_fire_suppression": false,
"has_access_control": true,
"ai_risk_level": "",
"ai_risk_analysis": "",
"created_at": "2026-01-12T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET /company/api/location-types/ Types de site ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/location-types/
{
"types": [
{ "id": 1, "name": "Büro", "key": "office" },
{ "id": 2, "name": "Rechenzentrum", "key": "datacenter" }
]
}
GET /company/api/billing/ Informations de facturation ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/billing/
{
"plan": "tier_10",
"billed_via": "direct",
"reseller": null,
"employee_count": 8,
"billing_cycle": "yearly",
"subscription_status": "active",
"trial_ends_at": null,
"stripe_current_period_end": "2027-01-12T09:00:00+00:00"
}
GET /company/api/layout/ Mise en page des documents (logo / CI) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/layout/
{
"accent_color": "#1f6f4a",
"font_family": "",
"heading_font_family": "",
"confidentiality_text": "Vertraulich",
"footer_text": "",
"cover_variant": "classic",
"accent_line": "left",
"logo_position": "right",
"watermark_text": "",
"margin_preset": "normal",
"show_toc": true,
"show_changelog": true,
"updated_at": "2026-04-02T10:00:00+00:00"
}
GET /company/tabletop/api/company-profile/ Lire le profil de l'entreprise (avec listes de choix) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/company-profile/
{
"company_title": "Murmelibach AG",
"industry": "finance",
"industry_label": "Finanzdienstleistung",
"company_size": "11-50",
"company_size_label": "11–50 Mitarbeiter",
"description": "",
"it_landscape": "Microsoft 365, Fileserver",
"critical_assets": "Kundendaten, Zahlungsverkehr",
"compliance_notes": "",
"country": "Schweiz",
"country_code": "ch",
"country_label": "Schweiz",
"website": "https://murmelibach-ag.example",
"default_language": "de",
"logo_url": "/media/logos/murmelibach.png",
"domains": [
{ "domain": "murmelibach-ag.ch", "is_primary": true, "notes": "" }
],
"industry_choices": [
{ "value": "finance", "label": "Finanzdienstleistung" }
],
"company_size_choices": [
{ "value": "11-50", "label": "11–50 Mitarbeiter" }
],
"country_choices": [
{ "value": "ch", "label": "Schweiz" }
],
"language_choices": [
{ "value": "de", "label": "Deutsch" }
]
}
POST /company/tabletop/api/company-profile/update/ Mettre à jour le profil de l’entreprise ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/company-profile/update/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"company_title": "Murmelibach AG", "industry": "finance", "company_size": "11-50", "critical_assets": "Kundendaten, Zahlungsverkehr", "default_language": "de", "country_code": "ch"}'
{
"company_title": "Murmelibach AG",
"industry": "finance",
"industry_label": "Finanzdienstleistung",
"company_size": "11-50",
"company_size_label": "11–50 Mitarbeiter",
"description": "",
"it_landscape": "",
"critical_assets": "Kundendaten, Zahlungsverkehr",
"compliance_notes": "",
"country": "Schweiz",
"country_code": "ch",
"country_label": "Schweiz",
"website": "",
"default_language": "de",
"logo_url": "",
"domains": [],
"industry_choices": [],
"company_size_choices": [],
"country_choices": [],
"language_choices": []
}
Campagnes de phishing
3 EndpointsGET /company/api/campaigns/ Lister les campagnes ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/campaigns/
{
"campaigns": [
{
"id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
"name": "Q2 Awareness",
"status": "Wird gesendet",
"created_date": "2026-05-02T09:00:00+00:00",
"stats": { "sent": 120, "opened": 61, "clicked": 14 }
}
]
}
POST /company/api/campaigns/create/ Créer une campagne en brouillon (lancement dans le portail web) ▶
curl -X POST https://portal.cybertell.io/company/api/campaigns/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Q2 Awareness", "template_id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "smtp_profile_id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "landing_page_id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24"}'
{
"id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
"name": "Q2 Awareness"
}
GET /company/api/campaigns/options/ Modèles & options ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/campaigns/options/
{
"templates": [
{ "id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "name": "Paket-Benachrichtigung" }
],
"smtp_profiles": [
{ "id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "name": "Standard-SMTP" }
],
"landing_pages": [
{ "id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24", "name": "Login-Seite" }
]
}
Incidents & tickets
11 EndpointsGET /company/tickets/api/list/ Liste des tickets (filtre : ?status=, ?category=, ?type=employee|incident, ?q=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/list/?status=offen&category=phishing
{
"tickets": [
{
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"message_count": 2
}
],
"total_count": 1
}
POST /company/tickets/api/create/ Créer un ticket ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"category": "phishing", "title": "Verdächtige E-Mail", "description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.", "priority": "hoch", "ticket_type": "meldung"}'
{
"ticket_id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"message": "Ticket erstellt."
}
GET /company/tickets/api/options/ Listes de choix pour les nouveaux tickets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/options/
{
"categories": [
{ "value": "frage", "label": "Frage" },
{ "value": "phishing", "label": "Phishing-Verdacht" },
{ "value": "sonstiges", "label": "Sonstiges" }
],
"ticket_types": [
{ "value": "meldung", "label": "Meldung" },
{ "value": "vorfall", "label": "Vorfall" }
],
"priorities": [
{ "value": "niedrig", "label": "Niedrig" },
{ "value": "mittel", "label": "Mittel" },
{ "value": "hoch", "label": "Hoch" },
{ "value": "kritisch", "label": "Kritisch" }
],
"defaults": { "category": "sonstiges", "ticket_type": "meldung", "priority": "mittel" }
}
GET /company/tickets/api/<uuid>/ Détail du ticket ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/
{
"ticket": {
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_by": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "email": "[email protected]" },
"assigned_to": null,
"participants": [],
"description_edited_at": null,
"can_edit": true,
"escalated_by": null,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"closed_at": null,
"escalated_at": null,
"messages": [
{
"id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
"author": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]" },
"body": "Bitte E-Mail nicht öffnen, wir prüfen.",
"is_internal": false,
"created_at": "2026-05-16T07:10:00+00:00",
"edited_at": null,
"mentioned": [],
"attachments": []
}
],
"attachments": []
}
}
POST /company/tickets/api/<uuid>/reply/ Envoyer une réponse ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/reply/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"body": "Bitte E-Mail nicht öffnen, wir prüfen.", "mentions": []}'
{
"message_id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
"message": "Antwort gespeichert."
}
POST /company/tickets/api/<uuid>/status/ Modifier le statut ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/status/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"status": "in_bearbeitung"}'
{
"message": "Status aktualisiert."
}
POST /company/tickets/api/<uuid>/priority/ Modifier la priorité ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/priority/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"priority": "kritisch"}'
{
"message": "Priorität aktualisiert."
}
POST /company/tickets/api/<uuid>/assign/ Attribuer un ticket à une personne (admin ; vide = retirer l'attribution) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/assign/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"assigned_to": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"}'
{
"changed": true,
"assigned_to": {
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Anna Müller",
"email": "[email protected]"
}
}
POST /company/tickets/api/<uuid>/edit/ Modifier le titre/la description ou son propre message (avec message_id) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/edit/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Verdächtige E-Mail mit Rechnungsanhang"}'
{
"changed": ["title"]
}
GET /company/tickets/api/<uuid>/mentionable/ Rechercher des personnes pour les mentions @ (?q=, sans adresses e-mail) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/mentionable/?q=an
{
"results": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "is_admin": false }
]
}
GET /company/tickets/api/dashboard/ Statistiques du tableau de bord ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/dashboard/
{
"total_tickets": 46,
"open_tickets": 3,
"closed_tickets": 41,
"serious_incidents": 1,
"by_category": [
{ "category": "phishing", "category_display": "Phishing-Verdacht", "count": 18 }
],
"by_priority": [
{ "priority": "hoch", "priority_display": "Hoch", "count": 7 }
],
"by_status": [
{ "status": "offen", "status_display": "Offen", "count": 3 }
],
"recent_tickets": [
{
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"message_count": 2
}
]
}
MITRE ATT&CK
2 EndpointsGET /company/tickets/mitre/api/mobile/ Tactiques avec techniques et couverture par les tickets et actualités de l'entreprise ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/mitre/api/mobile/
{
"tactics": [
{
"tactic_id": "TA0001",
"name": "Initial Access",
"technique_count": 1,
"techniques": [
{ "technique_id": "T1566", "name": "Phishing", "is_subtechnique": false, "ticket_count": 3, "news_count": 12 }
]
}
],
"technique_total": 211,
"technique_covered": 18
}
GET /company/tickets/mitre/api/mobile/<technique_id>/ Une technique avec les tickets et actualités associés (20 au maximum chacun) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/mitre/api/mobile/T1566/
{
"technique_id": "T1566",
"name": "Phishing",
"description": "…",
"is_subtechnique": false,
"parent_id": "",
"tactics": ["Initial Access"],
"assets": ["E-Mail"],
"tickets": [
{ "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen", "priority": "hoch", "priority_display": "Hoch", "created_at": "2026-05-15T09:30:00+00:00" }
],
"news": [
{ "id": "4812", "title": "Neue Phishing-Welle gegen KMU", "url": "https://www.ncsc.admin.ch/…", "published_at": "2026-05-14T06:00:00+00:00" }
]
}
War Rooms
6 EndpointsGET /company/tickets/api/warrooms/ Lister les war rooms ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/warrooms/?status=aktiv
{
"warrooms": [
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participant_count": 5,
"message_count": 12,
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
]
}
POST /company/tickets/api/warrooms/create/ Créer une war room ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware-Vorfall", "description": "Fileserver FS01 verschlüsselt.", "external_link": "", "external_link_label": "Video-Call"}'
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participant_count": 1,
"message_count": 0,
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
GET /company/tickets/api/warrooms/<uuid>/ Détail de la war room ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participants": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "initials": "MM", "is_admin": true }
],
"tickets": [
{ "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen" }
],
"playbooks": [
{ "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response" }
],
"messages": [
{
"id": 501,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Systeme isoliert.",
"created_at": "16.05.2026 10:00",
"created_at_iso": "2026-05-16T10:00:00+00:00",
"attachments": []
}
],
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
GET /company/tickets/warroom/<uuid>/api/messages/ Récupérer les messages (polling) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/messages/?after=500
{
"messages": [
{
"id": 501,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Systeme isoliert.",
"created_at": "16.05.2026 10:00",
"attachments": []
}
]
}
POST /company/tickets/warroom/<uuid>/api/send/ Envoyer un message ▶
curl -X POST https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/send/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"body": "Backups werden geprüft."}'
{
"id": 502,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Backups werden geprüft.",
"created_at": "16.05.2026 10:05",
"attachments": []
}
GET/POST /company/tickets/api/warrooms/<uuid>/participants/ Lire, inviter ou retirer des participants ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/participants/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"add": ["c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"], "remove": [], "add_groups": []}'
{
"participants": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Max Muster",
"initials": "MM",
"is_admin": true
}
],
"employees": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Max Muster",
"initials": "MM",
"is_admin": true,
"is_participant": true,
"group_ids": ["b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01"]
}
],
"groups": [
{ "id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01", "name": "Werkstatt" }
],
"can_manage": true
}
Surveillance du Dark Web
4 EndpointsGET /company/tickets/api/darkweb/ Vue d'ensemble des scans ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/
{
"scans": [
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch",
"total_credentials": 7,
"unique_emails": 5,
"breach_count": 3,
"has_plaintext_pw": true,
"risk_level": "high",
"sources_queried": "Dehashed, HIBP, LeakCheck",
"created_at": "2026-05-15T02:00:00+00:00"
}
]
}
POST /company/tickets/api/darkweb/scan/ Lancer un scan (domaines vérifiés uniquement) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/darkweb/scan/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"domain": "murmelibach-ag.ch", "run_dehashed": true, "run_hibp": true, "run_leakcheck": true}'
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch"
}
GET /company/tickets/api/darkweb/<uuid>/ Détail du scan ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e/
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch",
"total_credentials": 7,
"unique_emails": 5,
"breach_count": 3,
"has_plaintext_pw": true,
"risk_level": "high",
"sources_queried": "Dehashed, HIBP, LeakCheck",
"created_at": "2026-05-15T02:00:00+00:00",
"stats": { "dehashed_count": 4, "hibp_count": 3, "leakcheck_count": 3 },
"findings": [
{
"source": "Dehashed",
"email": "[email protected]",
"username": "",
"password": "Sommer2024!",
"hashed_password": "",
"name": "",
"database": "combolist-2025",
"url": ""
}
],
"findings_total": 7,
"breaches": [
{
"name": "ExampleBreach2024",
"date": "2024-11-02",
"pwn_count": 1420000,
"data_classes": ["Email addresses", "Passwords"],
"description": "…",
"domain": "example.com"
}
]
}
GET /company/tickets/api/darkweb/domains/ Domaines de l’entreprise pour l’analyse ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/domains/
{
"domains": [
{
"domain": "murmelibach-ag.ch",
"is_primary": true,
"is_verified": true
}
]
}
Analyse de phishing (EML)
2 EndpointsPOST /company/tickets/analysis/api/upload/ Téléverser un fichier EML ▶
curl -X POST https://portal.cybertell.io/company/tickets/analysis/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "[email protected]"
{
"analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"detail_url": "https://cybertell.io/company/tickets/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/",
"message": "E-Mail erfolgreich analysiert."
}
GET /company/tickets/analysis/api/list/ Liste des analyses ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/analysis/api/list/
{
"analyses": [
{
"id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"subject": "Ihr Konto wurde gesperrt",
"sender": "[email protected]",
"risk_score": 85,
"vt_status": "done",
"ai_status": "done",
"created_at": "2026-05-15T18:20:00+00:00"
}
]
}
Plugin de messagerie (indicateurs de phishing)
3 EndpointsAPI 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) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/mail-plugin/indicators/?since=2026-05-01T00:00:00Z
{
"indicators": [
{
"id": 12,
"type": "sender_domain",
"value": "paypa1.com",
"risk_level": "high",
"description": "Gefälschter Absender",
"analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"hit_count": 3,
"created_at": "2026-05-15T18:25:00+00:00",
"expires_at": null
}
],
"count": 1,
"last_updated": "2026-05-16T08:00:00+00:00"
}
POST /company/tickets/api/mail-plugin/check/ Vérifier l'e-mail par rapport aux indicateurs ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/mail-plugin/check/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"sender": "[email protected]", "subject": "Konto gesperrt", "urls": ["https://paypa1.com/login"]}'
{
"is_phishing": true,
"risk_level": "high",
"matches": [
{ "type": "sender_domain", "value": "paypa1.com", "risk_level": "high", "analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13" }
],
"analysis_url": "https://cybertell.io/company/tickets/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/"
}
GET /company/tickets/api/mail-plugin/analysis/<uuid>/ Détail de l'analyse pour la popup ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/mail-plugin/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/
{
"id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"sender": "[email protected]",
"subject": "Ihr Konto wurde gesperrt",
"risk_score": 85,
"risk_label": "Hoch",
"spf": "fail",
"dkim": "none",
"dmarc": "fail",
"malicious_urls": ["https://paypa1.com/login"],
"ai_category": "Phishing",
"ai_assessment": "KATEGORIE: Phishing\n- Domain 2 Tage alt\nEMPFEHLUNG: Nicht öffnen.",
"ai_indicators": ["Domain 2 Tage alt"],
"ai_recommendation": "Nicht öffnen.",
"analysed_at": "2026-05-15T18:20:00+00:00",
"analysed_by": "Max Muster"
}
Vidéos de sensibilisation
7 EndpointsGET /company/videos/api/list/ Liste des vidéos ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/videos/api/list/
{
"videos": [
{
"id": "e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24",
"title": "Phishing in 90 Sekunden",
"language": "de",
"status": "completed",
"status_display": "Fertig",
"slide_count": 8,
"duration_seconds": 92,
"render_progress": 100,
"source": "generated",
"completed_by_me": false,
"release_status": "publiziert",
"release_status_display": "Publiziert",
"is_published": true,
"is_current": true,
"valid_from": null,
"valid_until": null,
"created_at": "2026-05-10T09:00:00+00:00"
}
]
}
POST /company/videos/api/generate/ Générer une vidéo de sensibilisation (IA ; optionnel : tone, address_form, length_preset, slide_count, style_template, setting, tts_voice, tts_speed) ▶
curl -X POST https://portal.cybertell.io/company/videos/api/generate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Sicheres Homeoffice", "language": "de", "enable_tts": false, "video_format": "landscape", "extra_notes": ""}'
{
"job_id": "f7b9d1e3-5d7a-4f02-9c38-4e6a8b0d2f35",
"status": "generating"
}
GET /company/videos/api/<uuid>/ Détail de la vidéo avec les diapositives ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/
{
"id": "e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24",
"title": "Phishing in 90 Sekunden",
"extra_notes": "",
"language": "de",
"video_format": "landscape",
"status": "completed",
"status_display": "Fertig",
"slide_count": 8,
"duration_seconds": 92,
"render_progress": 100,
"render_error": "",
"enable_tts": false,
"has_video": true,
"video_url": "/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/",
"source": "generated",
"completed_by_me": false,
"release_status": "publiziert",
"release_status_display": "Publiziert",
"is_published": true,
"is_current": true,
"valid_from": null,
"valid_until": null,
"created_at": "2026-05-10T09:00:00+00:00",
"slides": [
{
"id": "0b2d4f68-1a3c-4e75-9b18-5d7f9a1c3e60",
"order": 1,
"slide_type": "intro",
"title": "Was ist Phishing?",
"bullets": ["Gefälschter Absender", "Zeitdruck"],
"speaker_notes": "",
"narration": "",
"illustration_key": "mail",
"duration_sec": 12
}
]
}
POST /company/videos/api/<uuid>/render/ Relancer le rendu ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/render/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "rendering",
"phase": "waiting",
"position": 1,
"status_display": "In Warteschlange"
}
GET /company/videos/api/<uuid>/video/ Charger le MP4 pour le lecteur ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o awareness.mp4 https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/
HTTP/1.1 200 OK Content-Type: video/mp4 Accept-Ranges: bytes Content-Length: 4821004 <MP4-Datenstrom>
POST/DEL /company/videos/api/<uuid>/delete/ Supprimer la vidéo ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/delete/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "deleted"
}
POST /company/videos/api/<uuid>/progress/ Signaler les secondes visionnées (suivi de l'achèvement) ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/progress/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"watched": 73, "duration": 92, "ended": false}'
{
"progress_pct": 79,
"completed": false
}
Registre des actifs
5 EndpointsLecture 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 ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/assets/api/list/
{
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01",
"asset_type": "system",
"asset_type_display": "System / Server",
"status": "active",
"status_display": "Aktiv",
"criticality": "high",
"criticality_display": "Hoch",
"confidentiality": "high",
"integrity": "medium",
"availability": "high",
"owner_name": "Max Muster",
"owner_email": "[email protected]",
"supplier": {
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
},
"status_page_url": "",
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"renews_on": "2027-01-31",
"renewal_state": "ok",
"auto_renew": true,
"payment_method": "invoice",
"payment_method_display": "Rechnung",
"risk_count": 2,
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/assets/api/create/ Créer un actif ▶
curl -X POST https://portal.cybertell.io/company/assets/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Fileserver FS01", "asset_type": "system", "criticality": "high", "supplier": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "owner_email": "[email protected]"}'
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01"
}
GET/PATCH/PUT/DEL /company/assets/api/<uuid>/ Détail de l'actif ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01",
"asset_type": "system",
"asset_type_display": "System / Server",
"status": "active",
"status_display": "Aktiv",
"criticality": "high",
"criticality_display": "Hoch",
"confidentiality": "high",
"integrity": "medium",
"availability": "high",
"owner_name": "Max Muster",
"owner_email": "[email protected]",
"supplier": {
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
},
"status_page_url": "",
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"renews_on": "2027-01-31",
"renewal_state": "ok",
"auto_renew": true,
"payment_method": "invoice",
"payment_method_display": "Rechnung",
"description": "Zentraler Dateiserver",
"notes": "",
"renewal_cycle": "yearly",
"renewal_cycle_display": "Jährlich",
"payment_note": "",
"provider_account": "",
"risks": [],
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET/POST /company/assets/api/<uuid>/risks/ Lister ou créer les risques d’un actif ▶
curl -X POST https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/risks/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ausfall Rechenzentrum", "likelihood": 2, "impact": 4, "target_likelihood": 1, "target_impact": 4, "contingency": "Failover ausl\u00f6sen"}'
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"asset_id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"title": "Ausfall Rechenzentrum",
"threat": "Stromausfall",
"vulnerability": "Kein Zweitstandort",
"likelihood": 2,
"impact": 4,
"risk_score": 8,
"risk_level": "high",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"status": "assessed",
"treatment": "Replikation ins Zweit-RZ",
"contingency": "Failover auslösen",
"accepted": false,
"accepted_by": "",
"accepted_at": null,
"accepted_justification": "",
"review_date": "2027-03-31",
"ai_generated": false,
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET/PATCH/DEL /company/assets/api/risks/<uuid>/ Lire, modifier ou supprimer un risque ; accepted: true l’accepte ▶
curl -X PATCH https://portal.cybertell.io/company/assets/api/risks/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"accepted": true, "accepted_justification": "Kosten stehen in keinem Verh\u00e4ltnis"}'
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"asset_id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"title": "Ausfall Rechenzentrum",
"threat": "Stromausfall",
"vulnerability": "Kein Zweitstandort",
"likelihood": 2,
"impact": 4,
"risk_score": 8,
"risk_level": "high",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"status": "assessed",
"treatment": "Replikation ins Zweit-RZ",
"contingency": "Failover auslösen",
"accepted": false,
"accepted_by": "",
"accepted_at": null,
"accepted_justification": "",
"review_date": "2027-03-31",
"ai_generated": false,
"updated_at": "2026-05-02T10:00:00+00:00"
}
Tiers (fournisseurs)
3 EndpointsLecture 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 ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/suppliers/api/list/
{
"suppliers": [
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft",
"category": "cloud_saas",
"category_display": "Cloud / SaaS",
"status": "active",
"status_display": "Aktiv",
"risk_level": "high",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"ai_risk_level": "",
"country_code": "ch",
"website": "https://wolkensoftware.example",
"contact_name": "Erika Muster",
"contact_email": "[email protected]",
"data_access": true,
"system_access": false,
"status_page_url": "https://status.wolkensoftware.example",
"status_sources": [
"https://status.wolkensoftware.example/history.rss"
],
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"sla": {
"target": 99.9,
"claim_days": 30
},
"document_count": 1,
"created_at": "2026-02-01T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/suppliers/api/create/ Créer un fournisseur ▶
curl -X POST https://portal.cybertell.io/company/suppliers/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Wolkensoftware Eidgenossenschaft", "category": "cloud_saas", "risk_level": "high", "likelihood": 3, "impact": 4, "contingency": "Zweitanbieter aktivieren", "status_page_url": "https://status.wolkensoftware.example", "status_sources": ["https://status.wolkensoftware.example/history.rss"], "data_access": true, "sla_target": 99.9, "sla_claim_days": 30}'
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
}
GET/PATCH/PUT/DEL /company/suppliers/api/<uuid>/ Détail du fournisseur ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/suppliers/api/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft",
"category": "cloud_saas",
"category_display": "Cloud / SaaS",
"status": "active",
"status_display": "Aktiv",
"risk_level": "high",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"ai_risk_level": "",
"country_code": "ch",
"website": "https://wolkensoftware.example",
"contact_name": "Erika Muster",
"contact_email": "[email protected]",
"data_access": true,
"system_access": false,
"status_page_url": "https://status.wolkensoftware.example",
"status_sources": [
"https://status.wolkensoftware.example/history.rss"
],
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"sla": {
"target": 99.9,
"claim_days": 30
},
"document_count": 1,
"contact_phone": "",
"language": "de",
"description": "Mail und Ablage",
"notes": "",
"contingency": "Zweitanbieter aktivieren, Kunden informieren",
"ai_risk_analysis": "",
"backup_strategy": "Tägliche Sicherung im Zweit-RZ",
"backup_last_tested_at": "2026-10-01",
"backup_test_result": "Rücksicherung in 2 h",
"documents": [],
"compliance_requests": [],
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01"
}
],
"sla_breaches": [
{
"id": "8c1e3a57-9d2b-4f60-a8e4-2b7d5c9f1a36",
"month": "2026-10",
"target": 99.9,
"achieved": 99.583,
"outage_minutes": 180,
"claim_deadline": "2026-11-30",
"claim_sent_at": null
}
],
"created_at": "2026-02-01T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
Évaluation TIC
7 EndpointsLecture 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) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/list/
{
"assessments": [
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt",
"standard_name": "IKT-Minimalstandard",
"rating_max": 4,
"overall_score": 2.1,
"completion_percent": 40,
"maturity_label": "Wiederholbar",
"created_at": "2026-04-02T10:00:00+00:00",
"created_by": "Max Muster",
"is_auto": false,
"read_only": false
}
]
}
GET /company/ict/api/catalog/ Catalogue des exigences d'une norme (fonctions, catégories, exigences ; ?standard=ikt|isms|vvt|tom|din27076|nistcsf2) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/catalog/?standard=ikt
{
"standard_slug": "ikt",
"standard_name": "IKT-Minimalstandard",
"rating_max": 4,
"rating_choices": [
{ "value": "na", "label": "Nicht anwendbar" },
{ "value": "0", "label": "0 – Nicht umgesetzt" }
],
"functions": [
{
"code": "ID",
"short_code": "ID",
"name": "Identifizieren",
"description": "…",
"categories": [
{
"code": "ID.AM",
"short_code": "AM",
"name": "Asset Management",
"items": [
{
"id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"code": "ID.AM-1",
"title": "Inventar der Geräte",
"description": "…",
"priority": 1
}
]
}
]
}
]
}
POST /company/ict/api/new/ Créer une évaluation ▶
curl -X POST https://portal.cybertell.io/company/ict/api/new/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"standard": "ikt", "title": "IKT-Minimalstandard 2026"}'
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"prefilled": 0,
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt"
}
GET/DEL /company/ict/api/<uuid>/ Détail de l'évaluation ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt",
"rating_max": 4,
"overall_score": 2.1,
"completion_percent": 40,
"maturity_label": "Wiederholbar",
"is_complete": false,
"is_auto": false,
"read_only": false,
"created_at": "2026-04-02T10:00:00+00:00",
"functions": [
{
"code": "ID",
"short_code": "ID",
"name": "Identifizieren",
"description": "…",
"score": 2.4,
"categories": [
{
"code": "ID.AM",
"short_code": "AM",
"name": "Asset Management",
"score": 2.0,
"items": [
{
"id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"code": "ID.AM-1",
"title": "Inventar der Geräte",
"priority": 1,
"rating": "3",
"comment": "Inventar in Asset-Register"
}
]
}
]
}
]
}
POST /company/ict/api/<uuid>/save-response/ Enregistrer la réponse ▶
curl -X POST https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/save-response/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"item_id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20", "rating": "3", "comment": "MFA aktiv"}'
{
"ok": true,
"completion_percent": 42,
"overall_score": 2.2,
"review_status": "",
"transferred": []
}
GET /company/ict/api/standards/ Standards de conformité disponibles ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/standards/
{
"standards": [
{
"slug": "ikt",
"name": "IKT-Minimalstandard",
"description": "Bundesamt für wirtschaftliche Landesversorgung",
"rating_max": 4,
"is_status_scale": false
}
]
}
GET /company/ict/api/<uuid>/pdf/ Rapport de conformité en PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o compliance-report.pdf https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="compliance-report.pdf" %PDF-1.7 …
Évaluation AD
3 EndpointsLecture 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 ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ad/api/list/
{
"dumps": [
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"filename": "ad_dump.json",
"status": "analysed",
"risk_score": 62,
"risk_level": "Hoch",
"risk_color": "warning",
"user_count": 140,
"computer_count": 96,
"has_ai_recommendations": true,
"created_at": "2026-05-10T09:00:00+00:00",
"uploaded_by": "Max Muster"
}
]
}
POST /company/ad/api/upload/ Téléverser un dump AD ▶
curl -X POST https://portal.cybertell.io/company/ad/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "dump_file=@ad_dump.json"
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"status": "analysed"
}
GET /company/ad/api/<uuid>/ Détail du dump ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ad/api/3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74/
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"filename": "ad_dump.json",
"status": "analysed",
"risk_score": 62,
"risk_level": "Hoch",
"risk_color": "warning",
"ai_recommendations": "…",
"user_count": 140,
"computer_count": 96,
"group_count": 31,
"risks": [
{ "severity": "high", "title": "Kerberoastable accounts" }
],
"password_policy": { "min_length": 8 },
"domain_info": { "name": "murmelibach.local" },
"created_at": "2026-05-10T09:00:00+00:00"
}
Évaluation Microsoft 365
3 EndpointsLecture 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 ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/azure/api/list/
{
"dumps": [
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"filename": "azure_export.json",
"status": "analysed",
"risk_score": 45,
"risk_level": "Mittel",
"risk_color": "warning",
"user_count": 140,
"has_ai_recommendations": true,
"created_at": "2026-05-10T09:00:00+00:00",
"uploaded_by": "Max Muster"
}
]
}
POST /company/azure/api/upload/ Téléverser un dump Azure ▶
curl -X POST https://portal.cybertell.io/company/azure/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "dump_file=@azure_export.json"
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"status": "analysed"
}
GET /company/azure/api/<uuid>/ Détail du dump ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/azure/api/2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60/
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"filename": "azure_export.json",
"status": "analysed",
"risk_score": 45,
"risk_level": "Mittel",
"risk_color": "warning",
"ai_recommendations": "…",
"user_count": 140,
"role_count": 12,
"app_count": 27,
"risks": [
{ "severity": "medium", "title": "Legacy auth aktiv" }
],
"security_defaults": { "enabled": false },
"conditional_access": [],
"checks": [
{ "id": "M365.AAD.02", "workload": "entra", "status": "fail", "severity": "critical", "title": "Conditional-Access-Richtlinie vorhanden", "evidence": "…", "fix": "…", "refs": ["CIS 5.2.2.1"] }
],
"workloads": [
{ "key": "entra", "label": "Entra ID", "collected": true, "skip_reason": "", "passed": 18, "failed": 4, "skipped": 0 }
],
"created_at": "2026-05-10T09:00:00+00:00"
}
Gestion des risques
2 EndpointsGET /company/risk/api/list/ Lister les risques ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/risk/api/list/
{
"risks": [
{
"id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
"title": "Ransomware",
"category": "technical",
"category_display": "Technisch",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"risk_level": "high",
"risk_level_display": "Hoch",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"treatment": "Offline-Backups einführen",
"treatment_display": "Offline-Backups einführen",
"owner": "Max Muster",
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/risk/api/create/ Créer un risque ▶
curl -X POST https://portal.cybertell.io/company/risk/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware", "category": "technical", "threat": "Verschlüsselung", "vulnerability": "Kein Offline-Backup", "likelihood": 3, "impact": 4, "target_likelihood": 1, "target_impact": 4, "owner": "Max Muster", "treatment": "Offline-Backups einführen"}'
{
"id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
"title": "Ransomware",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium"
}
Dépendances & panne
16 EndpointsLire 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 ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/mobile/
{
"node_count": 14,
"edge_count": 22,
"process_count": 5,
"spof": [],
"scenarios": []
}
GET /company/data-flows/api/map/ Carte : tous les nœuds, flux et groupes ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/map/
{
"nodes": [
{
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"kind": "supplier",
"label": "Hosting AG",
"criticality": "high"
}
],
"edges": [
{
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
],
"groups": [
{
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
]
}
POST /company/data-flows/api/nodes/ Placer un fournisseur, un actif ou un processus sur la carte (idempotent) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/nodes/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82"}'
{
"ok": true,
"node": {
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"kind": "supplier",
"label": "Hosting AG",
"criticality": "high"
}
}
DEL /company/data-flows/api/nodes/<uuid>/ Retirer un nœud et ses flux de la carte ; le fournisseur, l’actif ou le processus reste ▶
curl -X DELETE https://portal.cybertell.io/company/data-flows/api/nodes/5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…"
{
"ok": true
}
POST /company/data-flows/api/edges/ Créer un flux entre deux nœuds ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/edges/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"source": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26", "target": "8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20", "flow_type": "service", "data_categories": ["customer"]}'
{
"ok": true,
"edge": {
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
}
PATCH/DEL /company/data-flows/api/edges/<uuid>/ Modifier un flux (seulement les champs envoyés) ou le supprimer ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/edges/9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"is_redundant": true}'
{
"ok": true,
"edge": {
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
}
GET/POST /company/data-flows/api/processes/ Lister ou créer des processus métier (placés directement sur la carte) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/processes/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Auftragsabwicklung", "criticality": "high", "rto_hours": 8, "mtpd_hours": 24}'
{
"process": {
"uuid": "2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82",
"name": "Auftragsabwicklung",
"description": "",
"criticality": "high",
"rto_hours": 8,
"mtpd_hours": 24,
"rpo_hours": 4,
"owner_email": "[email protected]"
}
}
GET/PATCH/DEL /company/data-flows/api/processes/<uuid>/ Lire, modifier ou supprimer un processus métier ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/processes/2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"rpo_hours": 4}'
{
"process": {
"uuid": "2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82",
"name": "Auftragsabwicklung",
"description": "",
"criticality": "high",
"rto_hours": 8,
"mtpd_hours": 24,
"rpo_hours": 4,
"owner_email": "[email protected]"
}
}
GET/POST /company/data-flows/api/groups/ Lister ou créer des groupes ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/groups/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Hosting", "nodes": ["5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"]}'
{
"ok": true,
"group": {
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
}
GET/PATCH/DEL /company/data-flows/api/groups/<uuid>/ Renommer un groupe, définir (nodes), ajouter (add) ou retirer (remove) des nœuds, ou supprimer le groupe ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/groups/4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"add": ["8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20"]}'
{
"ok": true,
"group": {
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
}
POST /company/data-flows/api/simulation/ Simuler une panne sans rien enregistrer (déclencheur par nœud ou par fournisseur, actif, processus) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/simulation/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "outage_hours": 24}'
{
"ok": true,
"outage_hours": 24,
"counts": {
"total": 2,
"critical": 1,
"high": 1,
"mtpd_breached": 0,
"rto_breached": 1
},
"affected": [
{
"id": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"label": "Auftragsabwicklung",
"kind": "process",
"via_rule": "single",
"via_source_label": "Hosting AG"
}
],
"processes": [
{
"label": "Auftragsabwicklung",
"rto": 8,
"mtpd": 24,
"rto_breached": true
}
],
"affected_edges": [
"e_9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47"
]
}
GET/POST /company/data-flows/api/scenarios/ Lister les scénarios enregistrés ou enregistrer une simulation comme scénario ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/scenarios/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "outage_hours": 24, "name": "Hoster 24 h weg"}'
{
"ok": true,
"scenario": {
"uuid": "2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81",
"name": "Hoster 24 h weg",
"trigger_label": "Hosting AG",
"trigger_kind": "supplier",
"trigger_node": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"outage_hours": 24,
"counts": {
"total": 2,
"mtpd_breached": 0
},
"has_assessment": false,
"result": {},
"ai_assessment": "",
"ai_assessed_at": null,
"created_at": "2026-05-14T10:00:00+00:00"
}
}
GET/DEL /company/data-flows/api/scenarios/<uuid>/ Lire un scénario avec son résultat ou le supprimer ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/scenarios/2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81/
{
"ok": true,
"scenario": {
"uuid": "2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81",
"name": "Hoster 24 h weg",
"trigger_label": "Hosting AG",
"trigger_kind": "supplier",
"trigger_node": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"outage_hours": 24,
"counts": {
"total": 2,
"mtpd_breached": 0
},
"has_assessment": false,
"result": {},
"ai_assessment": "",
"ai_assessed_at": null,
"created_at": "2026-05-14T10:00:00+00:00"
}
}
GET /company/data-flows/api/status/ État des pages de statut par nœud et effet des perturbations en cours ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/status/
{
"ok": true,
"nodes": [
{
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"url": "https://status.hosting.example",
"state": "outage",
"label": "Ausfall",
"tone": "critical",
"summary": "Rechenzentrum offline",
"since": "2026-05-14T09:12:00+00:00",
"disrupted": true
}
],
"impact": {
"total": 2,
"processes": [
"Auftragsabwicklung"
],
"affected": [
"n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20"
],
"edges": [
"e_9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47"
]
}
}
GET /company/data-flows/api/outages/ Historique des perturbations des fournisseurs, les plus récentes d’abord ; ?open=1 seulement celles en cours ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/outages/
{
"outages": [
{
"url": "https://status.hosting.example",
"source": "Hosting AG Status",
"state": "outage",
"label": "Ausfall",
"summary": "Rechenzentrum offline",
"started_at": "2026-05-14T09:12:00+00:00",
"ended_at": null,
"open": true,
"duration_minutes": null,
"affected": [
"Hosting AG"
]
}
]
}
GET/PUT /company/data-flows/api/layout/ Lire et définir la position des nœuds ▶
curl -X PUT https://portal.cybertell.io/company/data-flows/api/layout/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"positions": {"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26": {"x": 0, "y": 160}}}'
{
"ok": true,
"updated": 1
}
Sauvegarde & restauration
1 EndpointGET /company/backups/api/mobile/ Plans de sauvegarde avec tests de restauration et actifs non protégés ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/backups/api/mobile/
{
"is_admin": true,
"kpi": {
"active": 1,
"tests_overdue": 0,
"not_resilient": 0,
"unprotected": 1,
"exempted": 0
},
"plans": [
{
"id": "3b5d7f91-2c4e-4a68-8d0b-1f3a5c7e9b02",
"name": "Fileserver täglich",
"scope": "Alle Freigaben",
"status": "active",
"status_display": "Aktiv",
"frequency": "daily",
"frequency_display": "Täglich",
"weekdays": [],
"schedule_display": "Täglich",
"location": "cloud",
"location_display": "Cloud",
"location_detail": "",
"tool": "Veeam",
"template_key": "",
"retention_days": 30,
"rpo_hours": 24,
"rpo_gap": false,
"has_offline_copy": true,
"is_immutable": false,
"is_encrypted": true,
"is_monitored": true,
"is_ransomware_resilient": true,
"owner": "Alma Admin",
"test_interval_months": 6,
"next_test_due": "2026-11-12",
"test_overdue": false,
"asset_names": ["Fileserver"],
"tips": [],
"tests": [
{
"id": "9e1a3c5b-7d2f-4b46-8a80-2c4e6f8a0b13",
"tested_on": "2026-05-12",
"scope": "file",
"scope_display": "Einzelne Dateien",
"result": "success",
"result_display": "Erfolgreich",
"duration_minutes": 45,
"tested_by": "Alma Admin",
"findings": ""
}
]
}
],
"unprotected_assets": [
{
"id": "4c6e8a02-3d5f-4b79-9e1c-2a4b6d8f0c14",
"name": "ERP",
"criticality": "critical",
"criticality_display": "Kritisch"
}
],
"exempted_assets": []
}
Surface d'attaque
1 EndpointGET /company/attack-surface/api/mobile/ Indicateurs, dernière analyse, constats ouverts et actifs ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/attack-surface/api/mobile/
{
"is_admin": true,
"stats": {
"hosts": 3,
"ips": 2,
"open_ports": 5,
"cves": 1,
"open_findings": 1,
"by_severity": {"critical": 0, "high": 1, "medium": 0, "low": 0, "info": 0}
},
"budget": {"limit": 200, "used": 26, "remaining": 174, "blocked": false},
"scan": {
"id": "8a0c2e4a-7b9d-4f13-8a2b-6c8d0e2f4a57",
"domain": "beispiel.ch",
"status": "done",
"status_display": "Abgeschlossen",
"created_at": "2026-05-16T07:00:00+00:00",
"completed_at": "2026-05-16T07:02:10+00:00",
"new_assets": 1,
"new_findings": 1,
"changes": {"new_assets": 1, "new_ports": 2},
"error": ""
},
"findings": [
{
"id": "0c2e4a6c-9d1f-4b35-9c4d-8e0f2a4b6c79",
"kind": "risky_port",
"kind_display": "Riskanter Port",
"severity": "high",
"severity_display": "Hoch",
"subject": "203.0.113.5:3389",
"domain": "beispiel.ch",
"status": "open",
"status_display": "Offen",
"first_seen_at": "2026-05-16T07:02:00+00:00",
"last_seen_at": "2026-05-16T07:02:00+00:00",
"note": "Hoster informiert",
"asset_id": "2e4a6c8e-1f3b-4d57-8e6f-0a2b4c6d8e91",
"risk": {"id": "4a6c8e0a-3b5d-4f79-8a8b-2c4d6e8f0a13", "title": "RDP offen", "level": "high", "status": "assessed"}
}
],
"assets": [
{
"id": "2e4a6c8e-1f3b-4d57-8e6f-0a2b4c6d8e91",
"kind": "ip",
"kind_display": "IP-Adresse",
"value": "203.0.113.5",
"domain": "beispiel.ch",
"ports": [443, 3389],
"vuln_count": 1,
"last_seen": "2026-05-16T07:02:00+00:00",
"technologies": ["nginx 1.24.0"],
"note": "",
"excluded": false,
"shared": false,
"register_asset": null
}
]
}
Interdictions d'accès
3 EndpointsGET /company/banning-orders/api/list/ Lister les interdictions d'accès (les 100 plus récentes) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/banning-orders/api/list/
{
"hausverbote": [
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"firstname": "Unbekannt",
"lastname": "männlich",
"status": "aktiv",
"reason": "Hausfriedensbruch",
"location": "Filiale Tannenhof",
"ban_date": "2026-05-16",
"ban_until": "2027-05-16",
"photo_url": null,
"violation_count": 0
}
]
}
POST /company/banning-orders/api/create/ Créer une interdiction d'accès ▶
curl -X POST https://portal.cybertell.io/company/banning-orders/api/create/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "firstname=Unbekannt" \ -F "lastname=männlich" \ -F "reason=Hausfriedensbruch" \ -F "location=Filiale Tannenhof" \ -F "ban_date=2026-05-16" \ -F "ban_until=2027-05-16" \ -F "[email protected]"
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"status": "ok"
}
GET/PATCH/PUT/DEL /company/banning-orders/api/<uuid>/ Détail de l'interdiction d'accès ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/banning-orders/api/8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60/
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"firstname": "Unbekannt",
"lastname": "männlich",
"date_of_birth": null,
"photo_url": null,
"description": "",
"street": "",
"postal_code": "",
"city": "",
"country": "",
"reason": "Hausfriedensbruch",
"location": "Filiale Tannenhof",
"ban_date": "2026-05-16",
"ban_until": "2027-05-16",
"status": "aktiv",
"notes": "",
"violations": [
{
"id": "0a2c4e68-1b3d-4f75-9c18-5e7a9c1d3f60",
"date": "2026-06-01",
"description": "Erneut im Laden",
"reported_to_police": true,
"notes": ""
}
],
"can_edit": true,
"can_manage": true
}
Exercices sur table
6 EndpointsGET /company/tabletop/api/scenarios/ Lister les scénarios ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/scenarios/
{
"scenarios": [
{
"id": "1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02",
"title": "Ransomware Krisenfall",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "hard",
"difficulty_display": "Schwer",
"narrative": "Montagmorgen, 07:15 Uhr …",
"duration_min": 90,
"target_roles": "Geschäftsleitung, IT",
"phase_count": 6,
"created_at": "2026-05-02T09:00:00+00:00"
}
]
}
POST /company/tabletop/api/scenarios/generate/ Générer un scénario (IA) ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/scenarios/generate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"scenario_type": "ransomware", "difficulty": "hard", "extra_context": "", "phase_count": 8}'
{
"job_id": "6d8f0a24-5c7e-4b91-8a36-2f4a6c8e0d51",
"status": "generating"
}
GET /company/tabletop/api/scenarios/<uuid>/ Détail du scénario ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/scenarios/1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02/
{
"id": "1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02",
"title": "Ransomware Krisenfall",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "hard",
"narrative": "Montagmorgen, 07:15 Uhr …",
"duration_min": 90,
"target_roles": "Geschäftsleitung, IT",
"learning_goals": "Entscheidungswege unter Zeitdruck üben",
"phases": [
{
"id": "2b4d6f80-3c5e-4a91-8b27-3e5a7c9e1b02",
"order": 1,
"title": "Erste Meldung",
"situation": "Der Fileserver antwortet nicht mehr.",
"time_pressure": "15 Minuten",
"discussion_question": "Wer wird sofort informiert?",
"choices": [
{ "label": "A", "text": "IT-Leitung informieren", "consequence": "…", "is_recommended": true }
]
}
]
}
GET /company/tabletop/api/negotiations/ Lister les négociations ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/negotiations/
{
"negotiations": [
{
"id": "7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "medium",
"status": "active",
"initial_ransom": 250000,
"current_ransom": 125000,
"trust_level": 40,
"threat_level": 70,
"score": null,
"outcome": "",
"message_count": 6,
"started_at": "2026-05-16T09:00:00+00:00",
"completed_at": null
}
]
}
GET /company/tabletop/api/negotiations/<uuid>/ Détail de la négociation ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/
{
"id": "7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24",
"scenario_type": "ransomware",
"scenario_briefing": "Ihre Server sind verschlüsselt …",
"difficulty": "medium",
"status": "active",
"initial_ransom": 250000,
"current_ransom": 125000,
"deadline_hours": 48,
"trust_level": 40,
"threat_level": 70,
"score": null,
"outcome": "",
"ai_feedback": "",
"messages": [
{ "role": "attacker", "content": "Sie haben 48 Stunden.", "timestamp": "2026-05-16T09:00:00+00:00" }
],
"started_at": "2026-05-16T09:00:00+00:00"
}
POST /company/tabletop/api/negotiations/<uuid>/message/ Envoyer un message ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/message/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"message": "Wir benötigen mehr Zeit."}'
{
"message": "Sie haben 24 Stunden.",
"current_ransom": 125000,
"trust_level": 35,
"threat_level": 75,
"status": "active",
"outcome": ""
}
SOC, parc d'appareils & rapport de menaces
8 EndpointsGET /company/api/soc/status/ Statut du hub SOC (pare-feu configuré) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/status/
{
"firewalla": true,
"sophos": false,
"defender": false,
"pfsense": false,
"waf": true
}
GET/POST /company/api/threat-reports/config/ Lire / enregistrer la configuration du rapport de menaces (role_id en UUID ou entier interne) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/threat-reports/config/
{
"configs": [
{
"id": 3,
"role_id": 12,
"role_uuid": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"role_name": "Geschäftsleitung",
"frequency": "monthly",
"send_hour": 8,
"send_weekday": 0,
"send_day": 1,
"sections": ["lage_schweiz", "eigene_vorfaelle"],
"is_active": true,
"include_ai_summary": true
}
],
"available_sections": [
{ "key": "lage_schweiz", "label": "Lage Schweiz" }
]
}
GET /company/api/soc/<provider>/live/ Données en direct d'un fournisseur SOC (provider = firewalla, pfsense, sophos, defender, graylog ; fenêtre ?start_ts=&end_ts=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/firewalla/live/?start_ts=1778914800&end_ts=1778918400
{
"provider": "firewalla",
"capabilities": { "label": "Firewalla", "device_assignments": true },
"soc_stats": {
"threat_level": "medium",
"alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
"total_alarms": 7,
"boxes_online": 2,
"boxes_total": 2,
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880
},
"flow_map": [
{ "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
],
"recent_blocked": [
{ "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
],
"suspicious": [
{ "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
],
"company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
"blocked_countries": ["RU", "KP"]
}
GET /company/api/soc/<provider>/device-flows/ Flux agrégés d'un appareil sur la dernière heure (?device= obligatoire, ?region= facultatif) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/firewalla/device-flows/?device=WS-042
{
"device": "WS-042",
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880,
"filter_region": "",
"top_domains": [
{ "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
],
"top_regions": [
{ "region": "CH", "count": 640, "blocked": 0 }
]
}
GET/POST/DEL /company/api/soc/<provider>/device-assignments/ Attribuer des appareils aux collaborateurs (admin ; mitarbeiter_id en UUID ou entier interne) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/device-assignments/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"device_key": "AA:BB:CC:DD:EE:FF", "device_name": "WS-042", "context_id": "0a1b2c3d", "mitarbeiter_id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "notes": ""}'
{
"ok": true,
"created": true,
"assignment": {
"id": 7,
"provider": "firewalla",
"device_key": "AA:BB:CC:DD:EE:FF",
"device_name": "WS-042",
"context_id": "0a1b2c3d",
"mitarbeiter_id": 42,
"mitarbeiter_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"mitarbeiter_name": "Max Muster",
"assigned_at": "2026-05-16T08:10:00+00:00",
"notes": ""
}
}
POST /company/api/soc/<provider>/alarm-ai/ Analyse IA d'une alarme (champs de formulaire ; aussi sous /company/api/firewalla/alarm-ai/) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/alarm-ai/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'alarm_type=Abnormal Upload' \ --data-urlencode 'severity=high' \ --data-urlencode 'device=NAS-Buero' \ --data-urlencode 'target=203.0.113.50' \ --data-urlencode 'message=2.1 GB in 10 min' \ --data-urlencode 'timestamp=2026-05-16T07:40:00Z'
{
"analysis": "ZUSAMMENFASSUNG: …"
}
POST /company/api/soc/<provider>/suspicious-analyse/ Vérifier une destination suspecte (action=vt|ai|both ; aussi sous /company/api/firewalla/suspicious-analyse/) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/suspicious-analyse/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'action=both' \ --data-urlencode 'type=blocked_flow' \ --data-urlencode 'title=Blockiertes Ziel' \ --data-urlencode 'detail=WS-042 nach RU' \ --data-urlencode 'domains=198.51.100.7' \ --data-urlencode 'severity=low' \ --data-urlencode 'region=RU'
{
"vt": [
{ "url": "198.51.100.7", "verdict": "malicious", "source": "ipsum", "score": 4 }
],
"ai": "ZUSAMMENFASSUNG: …"
}
GET /company/api/threat-report/latest/ Dernier rapport de situation ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/threat-report/latest/
{
"report": {
"sent_at": "2026-05-01T06:00:00+00:00",
"recipient_count": 3,
"ai_summary": "Im April dominierten QR-Phishing und Rechnungsbetrug.",
"sections": ["lage_schweiz", "eigene_vorfaelle"],
"role": "Geschäftsleitung"
}
}
Intégration Firewalla
13 EndpointsGET /company/api/firewalla/overview/ Vue d'ensemble du tableau de bord ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/overview/
{
"stats": {
"box_count": 2,
"online_count": 2,
"offline_count": 0,
"alarm_count": 7,
"alarm_severity": { "high": 1, "medium": 2, "info": 4 },
"rule_count": 64,
"block_rule_count": 40,
"allow_rule_count": 24,
"target_list_count": 3,
"blocked_domain_count": 12
},
"boxes": [
{
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
}
],
"recent_alarms": [
{
"id": "a-901",
"type": "Sicherheitsaktivität",
"message": "Verbindung zu bekannter Malware-Domain",
"device": "WS-042",
"target": "boese-domain.example",
"timestamp": "16.05.2026 08:05",
"severity": "high",
"box_id": "0a1b2c3d"
}
],
"rules": [
{
"id": "55",
"type": "dns",
"target": "boese-domain.example",
"action": "block",
"direction": "outbound",
"protocol": "",
"scope": "",
"expire": 0,
"created_at": "10.05.2026 09:00",
"paused": false
}
],
"target_lists": [
{ "id": "TL-1", "name": "CyberTell Blocklist", "target_count": 12, "owner": "" }
],
"blocked_domains": ["boese-domain.example"]
}
GET /company/api/firewalla/boxes/ Lister les appareils (boxes) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/
{
"boxes": [
{
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
}
]
}
GET /company/api/firewalla/boxes/<box_id>/ Détail de la box ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/
{
"box_id": "0a1b2c3d",
"box": {
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
},
"alarms": [
{
"id": "a-901",
"type": "Sicherheitsaktivität",
"message": "Verbindung zu bekannter Malware-Domain",
"device": "WS-042",
"target": "boese-domain.example",
"timestamp": "16.05.2026 08:05",
"severity": "high",
"box_id": "0a1b2c3d"
}
],
"rules": [
{
"id": "55",
"type": "dns",
"target": "boese-domain.example",
"action": "block",
"direction": "outbound",
"protocol": "",
"scope": "",
"expire": 0,
"created_at": "10.05.2026 09:00",
"paused": false
}
],
"devices": [
{
"id": "AA:BB:CC:DD:EE:FF",
"mac": "AA:BB:CC:DD:EE:FF",
"mac_vendor": "Dell",
"ip": "10.0.0.42",
"name": "WS-042",
"online": true,
"last_seen": "16.05.2026 08:00",
"total_download": 41984000,
"total_upload": 5242880,
"assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
}
]
}
GET /company/api/firewalla/boxes/<box_id>/devices/ Appareils d'une box ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/devices/
{
"box_id": "0a1b2c3d",
"devices": [
{
"id": "AA:BB:CC:DD:EE:FF",
"mac": "AA:BB:CC:DD:EE:FF",
"mac_vendor": "Dell",
"ip": "10.0.0.42",
"name": "WS-042",
"online": true,
"last_seen": "16.05.2026 08:00",
"total_download": 41984000,
"total_upload": 5242880,
"assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
}
],
"count": 1
}
GET /company/api/firewalla/flows/ Flux de trafic (?query=, ?groupBy=, ?sortBy=, ?cursor=, ?limit= 50 par défaut, max. 500) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/flows/?limit=200
{
"flows": [
{
"ts": "16.05.2026 08:00",
"ts_epoch": 1778918400.0,
"protocol": "tcp",
"dport": "443",
"sport": "",
"direction": "outbound",
"download": 10240,
"upload": 2048,
"category": "",
"region": "US",
"device": "WS-042",
"device_ip": "10.0.0.42",
"source": "",
"destination": "example.com",
"dest_ip": "93.184.216.34",
"blocked": false,
"duration": 0.4,
"count": 1
}
],
"count": 1,
"next_cursor": ""
}
GET /company/api/firewalla/device-flows/ Trafic d'un appareil (?device= obligatoire, ?region= facultatif) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/device-flows/?device=WS-042
{
"device": "WS-042",
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880,
"filter_region": "",
"top_domains": [
{ "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
],
"top_regions": [
{ "region": "CH", "count": 640, "blocked": 0 }
]
}
GET /company/api/firewalla/stats/ Statistiques de la fleet ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/stats/
{
"stats": { "onlineBoxes": 2, "offlineBoxes": 0, "alarms": 7, "rules": 64 }
}
GET /company/api/firewalla/soc-live/ Flux SOC en direct ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/soc-live/
{
"provider": "firewalla",
"capabilities": { "label": "Firewalla", "device_assignments": true },
"soc_stats": {
"threat_level": "medium",
"alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
"total_alarms": 7,
"boxes_online": 2,
"boxes_total": 2,
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880
},
"flow_map": [
{ "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
],
"recent_blocked": [
{ "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
],
"suspicious": [
{ "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
],
"company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
"blocked_countries": ["RU", "KP"]
}
GET/POST/DEL /company/api/firewalla/blocked-countries/ Pays bloqués ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/blocked-countries/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"country_code": "RU"}'
{
"success": true,
"country_code": "RU",
"action": "blocked"
}
GET/POST/DEL /company/api/firewalla/blocked-domains/ Gérer les domaines bloqués ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/blocked-domains/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"domain": "boese-domain.example"}'
{
"ok": true,
"message": "boese-domain.example blockiert."
}
GET/POST/DEL /company/api/firewalla/device-assignments/ Gérer les attributions d'appareils (mitarbeiter_id en UUID ou entier interne) ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/device-assignments/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"mac": "AA:BB:CC:DD:EE:FF", "device_name": "WS-042", "box_id": "0a1b2c3d", "mitarbeiter_id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "notes": ""}'
{
"ok": true,
"created": true,
"assignment": {
"id": 7,
"device_mac": "AA:BB:CC:DD:EE:FF",
"device_name": "WS-042",
"box_id": "0a1b2c3d",
"mitarbeiter_id": 42,
"mitarbeiter_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"mitarbeiter_name": "Max Muster"
}
}
POST /company/api/firewalla/rules/<rule_id>/pause/ Mettre la règle en pause ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/pause/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"message": "Regel 55 pausiert."
}
POST /company/api/firewalla/rules/<rule_id>/resume/ Reprendre la règle ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/resume/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"message": "Regel 55 fortgesetzt."
}
Playbooks (réponse aux incidents)
14 EndpointsGET /company/playbooks/api/list/ Lister les playbooks ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/list/
{
"playbooks": [
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"description": "Sofortmassnahmen bei Verschlüsselung",
"topic": "ransomware",
"topic_display": "Ransomware-Angriff",
"version": "1.0",
"updated_at": "2026-05-02T10:00:00+00:00",
"scope": "standard",
"has_steps": true
}
]
}
POST /company/playbooks/api/create/ Créer un playbook (optionnellement avec contenu IA, ai_generate) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware Response", "topic": "ransomware", "version": "1.0", "description": "Sofortmassnahmen bei Verschlüsselung", "scope": "standard", "ai_generate": true}'
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response"
}
GET /company/playbooks/api/<uuid>/ Détail du playbook ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"description": "Sofortmassnahmen bei Verschlüsselung",
"topic": "ransomware",
"topic_display": "Ransomware-Angriff",
"version": "1.0",
"updated_at": "2026-05-02T10:00:00+00:00",
"scope": "standard",
"has_steps": true,
"sections": [
{
"id": "4a6c8e02-1b3d-4f59-9c87-2e5a7d1f3b06",
"title": "Sofortmassnahmen",
"content": "Betroffene Hosts isolieren …",
"order": 0,
"intro": "",
"preparation": "",
"condition": "",
"block_key": "",
"has_steps": true,
"steps": [
{ "id": "e4b8c2d6-1a3f-4c57-9e80-2b4d6f8a0c13", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Incident Lead", "time_mark": "", "condition": "", "module_key": "", "order": 0 }
]
}
],
"roles": [
{ "id": "5b7d9f21-3c4e-4a86-9b05-1d3f5a7c9e20", "role_type": "intern", "name": "Max Muster", "role_title": "Incident Lead", "email": "[email protected]", "phone": "", "notes": "" }
]
}
GET /company/playbooks/api/<uuid>/pdf/ Playbook en PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o playbook.pdf https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="playbook.pdf" %PDF-1.7 …
GET /company/playbooks/api/runs/ Lister les exécutions (?status=laufend|finished|abgeschlossen|abgebrochen, ?kind=drill|incident) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/?status=laufend
{
"runs": [
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"playbook_id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"kind": "incident", "kind_display": "Ernstfall",
"status": "laufend", "status_display": "Laufend", "is_running": true,
"started_at": "2026-10-11T08:15:00+00:00",
"warroom": { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" },
"ticket": null,
"counts": { "done": 2, "open": 5, "skipped": 0, "na": 1, "visible": 7, "percent": 29 }
}
]
}
GET /company/playbooks/api/runs/options/ Options pour l’activation : playbooks avec questions de vérification, systèmes, prestataires, war rooms, tickets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/options/
{
"playbooks": [ { "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response", "topic": "ransomware", "questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ] } ],
"asset_groups": [ { "key": "system", "label": "System", "assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster" } ] } ],
"supplier_groups": [ { "key": "it_infrastructure", "label": "IT-Infrastruktur", "assets": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "criticality": "active", "criticality_label": "Aktiv", "owner": "" } ] } ],
"warrooms": [ { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" } ],
"tickets": [ { "id": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "title": "Verschlüsselte Dateien", "short_code": "T-0481" } ],
"can_pick_assets": true
}
POST /company/playbooks/api/runs/activate/ Démarrer une exécution (exercice ou incident) avec systèmes, prestataires, lien et vérification du cas ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/activate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"playbook": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "kind": "incident", "link": "ticket", "ticket": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "assets": ["a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91"], "suppliers": ["b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02"], "answers": {"ransom_demand": true, "data_exfiltrated": null}}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"title": "Ransomware Response", "kind": "incident", "status": "laufend", "is_running": true,
"answers": { "ransom_demand": true },
"questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ],
"sections": [ { "index": 0, "title": "Sofortmassnahmen", "intro": "Erste Stunde.", "preparation": "", "condition": "", "block_key": "", "state": null, "hidden": false,
"steps": [ { "id": "e4b8c2d6-1f3a-4e59-9b07-2c6d8a0f4e12", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Technischer IR-Lead", "time_mark": "0–15 min", "condition": "", "module_key": "warroom", "module": { "key": "warroom", "label": "War Room", "url": "/company/incidents/warroom/" }, "state": "offen", "applicable": true, "open_question": false, "assignee": null, "done_by": null, "done_at": null, "note": "", "ticket": null, "asset_hint": "", "can_change": true } ] } ],
"assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "asset_type_label": "System", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster", "supplier": "Hosting AG", "backup_plans": [], "no_backup": true, "open_findings": [], "url": "/company/asset-register/a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91/" } ],
"suppliers": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "category_label": "IT-Infrastruktur", "status": "active", "status_label": "Aktiv", "contact_name": "", "contact_email": "[email protected]", "contact_phone": "", "data_access": true, "scope": "", "contingency": "Hotline 24/7", "url": "/company/suppliers/b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02/" } ],
"counts": { "done": 0, "open": 7, "skipped": 0, "na": 0, "visible": 7, "percent": 0 },
"permissions": { "can_operate": true, "can_finish": true, "can_delete": true, "can_edit_assets": true }
}
GET /company/playbooks/api/runs/<uuid>/ Détail d’une exécution : sections et étapes avec état, vérification du cas, systèmes et prestataires concernés, droits ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"title": "Ransomware Response", "status": "laufend",
"sections": [], "assets": [], "suppliers": [],
"permissions": { "can_operate": true, "can_finish": true, "can_delete": false, "can_edit_assets": true }
}
POST /company/playbooks/api/runs/<uuid>/assets/ Remplacer les systèmes et prestataires concernés (sans la clé suppliers, les prestataires restent inchangés) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/assets/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"assets": ["a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91"], "suppliers": ["b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02"]}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"assets": [], "suppliers": []
}
POST /company/playbooks/api/runs/<uuid>/answers/ Définir les réponses de la vérification du cas (true, false ou null = ouvert) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/answers/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"answers": {"ransom_demand": true, "data_exfiltrated": false, "customers_affected": null}}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"answers": { "ransom_demand": true, "data_exfiltrated": false },
"sections": []
}
POST /company/playbooks/api/runs/<uuid>/steps/<uuid>/state/ Cocher, ignorer ou rouvrir une étape (offen|erledigt|uebersprungen), avec note facultative ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/steps/e4b8c2d6-1f3a-4e59-9b07-2c6d8a0f4e12/state/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"state": "erledigt", "note": "Kabel gezogen, 08:21"}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"counts": { "done": 1, "open": 6, "skipped": 0, "na": 0, "visible": 7, "percent": 14 },
"sections": []
}
POST /company/playbooks/api/runs/<uuid>/finish/ Terminer ou interrompre une exécution (action=finish|abort), note de clôture, revue facultative ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/finish/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"action": "finish", "notes": "Wiederanlauf um 14:30 abgeschlossen.", "create_review": true}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"status": "abgeschlossen", "is_running": false,
"review": { "id": "5a3c7e91-2d4f-4b68-8c17-9e1b3d5f7a20", "status": "entwurf" }
}
POST/DEL /company/playbooks/api/runs/<uuid>/delete/ Supprimer une exécution (administrateur de l’entreprise uniquement) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/delete/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true
}
GET /company/playbooks/api/runs/<uuid>/pdf/ Exécution en PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o playbook-lauf.pdf https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="playbook-lauf.pdf" %PDF-1.7 …
Politique de sécurité
3 EndpointsLes 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 ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/policy/api/
{
"version": "4",
"published_at": "2026-04-30T12:00:00+00:00",
"sections": [
{ "key": "password", "title": "Passwort-Richtlinien", "extra": "", "icon": "Key", "sort_order": 1, "is_custom": false,
"body_html": "<ul><li>Passwörter haben mindestens 12 Zeichen.</li></ul>" }
],
"pw_rules": { "min_length": 12, "require_uppercase": true, "require_numbers": true, "require_special": false, "expiry_days": 0, "no_reuse": true },
"incident_contact": { "name": "Max Muster", "email": "[email protected]", "phone": "+41 31 000 00 00" },
"acknowledged": false,
"acknowledged_at": null,
"acknowledged_version": null
}
POST /company/policy/api/acknowledge/ Confirmer la politique (collaborateur) ▶
curl -X POST https://portal.cybertell.io/company/policy/api/acknowledge/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "ok"
}
GET /company/policy/api/mobile/pdf/ Directive en PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o sicherheitsrichtlinie.pdf https://portal.cybertell.io/company/policy/api/mobile/pdf/?lang=de
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="sicherheitsrichtlinie.pdf" %PDF-1.7 …
Documents sécurisés
1 EndpointGET /company/api/documents/ Documents d’entreprise partagés ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/documents/
{
"documents": [
{
"id": "2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02",
"title": "Notfallkonzept",
"description": "",
"category": "Notfall",
"filename": "notfallkonzept.pdf",
"size": 284120,
"download_url": "/secure-file/2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02/",
"can_read": true,
"uploaded_at": "2026-04-02T10:00:00+00:00"
}
]
}
Points
1 EndpointGET /company/api/points/me/ Points personnels et classement ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/points/me/
{
"points": {
"total": 1840,
"this_month": 260,
"this_month_chf": 26.0,
"monthly_budget_chf": 50.0,
"enabled": true,
"level": "Wachsam",
"level_progress": 0.6,
"next_level_points": 2000,
"my_rank": 3,
"leaderboard": [
{ "rank": 1, "name": "Erika Muster", "points": 2410, "is_me": false },
{ "rank": 3, "name": "Max Muster", "points": 1840, "is_me": true }
]
}
}
Feuille de route
2 EndpointsGET /company/roadmap/api/mobile/ Phases, progression et prochaines étapes ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/roadmap/api/mobile/
{
"progress": 35,
"phases": [
{
"key": "grundschutz",
"label": "Grundschutz",
"desc": "…",
"done": 6,
"total": 12,
"items": [
{
"key": "module:incidents",
"label": "Vorfall-Meldung aktivieren",
"desc": "…",
"icon": "Shield",
"status": "done",
"cadence": "",
"recurring": false,
"last_done": "2026-05-02T09:00:00+00:00",
"snoozed_until": null,
"planned_date": null,
"overdue": false
}
]
}
],
"next_steps": []
}
POST /company/roadmap/api/mobile/action/ Terminer ou reporter une étape ▶
curl -X POST https://portal.cybertell.io/company/roadmap/api/mobile/action/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'action=done' \ --data-urlencode 'item_key=module:incidents'
{
"ok": true,
"progress": 38
}
DMARC
2 EndpointsGET /company/dmarc/api/mobile/ Indicateurs et rapports DMARC ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/dmarc/api/mobile/
{
"pass_rate": 96,
"failing_sources": 2,
"reporters": 5,
"total_messages": 18240,
"reports": [
{
"uuid": "7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91",
"policy_domain": "murmelibach-ag.ch",
"org_name": "google.com",
"date_begin": "2026-05-14T00:00:00+00:00",
"date_end": "2026-05-15T00:00:00+00:00",
"total_count": 420,
"pass_count": 404,
"pass_rate": 96
}
]
}
GET /company/dmarc/api/mobile/<uuid>/ Rapport avec alignement et sources en échec ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/dmarc/api/mobile/7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91/
{
"uuid": "7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91",
"policy_domain": "murmelibach-ag.ch",
"org_name": "google.com",
"date_begin": "2026-05-14T00:00:00+00:00",
"date_end": "2026-05-15T00:00:00+00:00",
"total_count": 420,
"pass_count": 404,
"pass_rate": 96,
"pol_p": "quarantine",
"pol_sp": "",
"pol_pct": 100,
"pol_adkim": "r",
"pol_aspf": "r",
"alignment": { "both": 390, "dkim_only": 10, "spf_only": 4, "none": 16 },
"failing_records": [
{
"source_ip": "203.0.113.7",
"count": 16,
"disposition": "quarantine",
"dkim_result": "fail",
"spf_result": "fail",
"dkim_aligned": false,
"spf_aligned": false,
"header_from": "murmelibach-ag.ch"
}
]
}
Réponse aux incidents
1 EndpointGET /company/api/mobile/incident-response/ Investigations et indicateurs (?severity=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/mobile/incident-response/?status=aktiv
{
"investigations": [
{
"id": "1d3f5a79-2b4c-4e86-9a01-7c9e1b3d5f40",
"title": "Kompromittiertes Notebook",
"description": "",
"status": "aktiv",
"status_display": "Aktiv",
"severity": "hoch",
"severity_display": "Hoch",
"lead": "Max Muster",
"created_at": "2026-05-15T14:00:00+00:00"
}
],
"stats": { "active": 1, "critical": 0, "indicators": 24, "draft_rules": 2 }
}
Journal d’audit
1 EndpointGET /company/tickets/api/audit-log/ Journal d'audit de l'entreprise (100 derniers événements, administrateurs uniquement) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/audit-log/
{
"events": [
{
"id": 9001,
"action": "login",
"success": true,
"actor_email": "[email protected]",
"target_label": "B2B-Portal",
"ip_address": "203.0.113.10",
"ip_country": "CH",
"ip_city": "Bern",
"user_agent": "Safari 18 · macOS",
"failure_reason": "",
"created_at": "2026-05-16T07:02:00+00:00",
"lat": 46.95,
"lng": 7.45,
"location_precision": "city"
}
]
}
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 EndpointsGET /individual/api/dashboard/ Vue d'ensemble du tableau de bord (courses_* compte les tentatives d'examen) ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/dashboard/
{
"dashboard": {
"leak_checks": 3,
"total_breaches": 5,
"verified_emails": 2,
"incidents": 1,
"canary_tokens": 2,
"canary_hits": 0,
"simulations": 4,
"courses_total": 5,
"courses_passed": 2
}
}
GET /individual/api/profile/ Données du profil ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/profile/
{
"profile": {
"id": "3d4e5f6a-9b1c-4d46-8e72-8c0d2f4a6e79",
"firstname": "Max",
"lastname": "Muster",
"email": "[email protected]",
"phone": "+41790000000",
"plan": "family",
"subscription_status": "active",
"language": "de",
"created_at": "2026-01-12T09:00:00+00:00",
"family": { "is_owner": true, "member_count": 2, "members": [ { "id": "9e1c3a57-2b4d-4f86-8a09-3c5e7a9b1d40", "name": "Erika Muster", "email": "[email protected]" } ] }
}
}
Vérifications de fuites d'e-mail
2 EndpointsGET /individual/api/leak-checks/ Liste des vérifications de fuites ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/leak-checks/
{
"leak_checks": [
{
"id": "d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92",
"email": "[email protected]",
"breach_count": 3,
"risk_level": "high",
"checked_at": "2026-05-15T20:00:00+00:00"
}
],
"verified_emails": [
{ "id": "8b0d2f46-1a3c-4e75-9b18-5d7f9a1c3e60", "email": "[email protected]", "verified_at": "2026-01-12T09:05:00+00:00" }
]
}
GET /individual/api/leak-checks/<uuid>/ Détail avec les fuites ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/leak-checks/d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92/
{
"leak_check": {
"id": "d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92",
"email": "[email protected]",
"breach_count": 3,
"risk_level": "high",
"checked_at": "2026-05-15T20:00:00+00:00",
"breaches": [
{ "name": "ExampleBreach2024", "date": "2024-11-02", "domain": "example.com", "pwn_count": 1420000, "data_classes": ["E-Mail-Adressen", "Passwörter"], "description": "…", "logo_path": "" }
]
}
}
Cours
1 EndpointGET /individual/api/courses/ Cours de la personne avec progression (même sélection que /individual/courses/api/certifications/) ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/courses/
{
"courses": [
{
"id": "4e5f6a7b-0c2d-4e57-9f83-9d1e3f5a7b80",
"title": "Phishing erkennen",
"topic_count": 4,
"content_count": 12,
"completed_count": 7,
"progress_pct": 58,
"exam": { "id": "2c4e6a80-1b3d-4f57-9a29-6d8f0b2d4e61", "passed": true, "score": "14/16", "finished_at": "2026-05-16T09:00:00+00:00" }
}
]
}
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 EndpointGET /reseller/api/dashboard/ Vue d'ensemble ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/dashboard/
{
"dashboard": {
"type": "reseller",
"company_count": 12,
"active_companies": 10,
"total_employees": 240,
"open_tickets": 5,
"sponsored_persons": 0
}
}
Entreprises
6 EndpointsGET /reseller/api/companies/ Lister les entreprises gérées ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/
{
"companies": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"email": "[email protected]",
"industry": "finance",
"plan": "tier_10",
"subscription_status": "active",
"employee_count": 24,
"open_tickets": 1,
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
GET /reseller/api/companies/<uuid>/ Détail de l'entreprise ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"email": "[email protected]",
"industry": "finance",
"company_size": "11-50",
"plan": "tier_10",
"subscription_status": "active",
"country": "Schweiz",
"employees": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]", "is_admin": true }
]
}
}
GET /reseller/api/companies/security/ Situation de sécurité de tous les clients ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/
{
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"own_company": false,
"migrated": false,
"assets": 42,
"assets_critical": 3,
"systems": 12,
"cves": 9,
"findings": {
"critical": 2,
"high": 4,
"medium": 5,
"low": 1
},
"kev": 1,
"support_expired": 1,
"support_ending": 2,
"surface_findings": 4,
"surface_severe": 1,
"last_run_at": "2026-11-15T02:30:00+00:00"
}
],
"totals": {
"companies": 8,
"with_radar": 5,
"attention": 2,
"assets": 214,
"systems": 61,
"cves": 37,
"kev": 2,
"kev_companies": 2,
"critical_companies": 3,
"support_expired": 2,
"support_ending": 5
},
"shared_cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"kev": true,
"cvss": 9.8,
"companies": 3,
"systems": 4,
"customer_names": [
"Murmelibach AG",
"Seeblick GmbH"
]
}
]
}
GET /reseller/api/companies/security/cves/ CVE ouvertes de tous les clients ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/cves/?kev=1
{
"cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"cvss": 9.8,
"kev": true,
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG"
}
],
"systems": 2,
"findings": 2,
"products": [
"Fortinet FortiOS"
],
"fixed_in": [
"7.4.9"
],
"first_seen_at": "2026-11-02T02:31:00+00:00"
}
],
"truncated": false,
"kev_total": 1
}
GET /reseller/api/companies/security/assets/ Assets actifs de tous les clients ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/assets/?criticality=critical
{
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Firewall Hauptsitz",
"asset_type": "network",
"asset_type_display": "Netzwerk",
"criticality": "critical",
"criticality_display": "Kritisch",
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"open_cves": 2
}
]
}
GET /reseller/api/companies/<uuid>/security/ Situation de sécurité d'un client ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/security/
{
"security": {
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"migrated": false,
"radar": {
"systems": 12,
"cves": 9,
"open_findings": 12,
"findings_by_severity": {
"critical": 2,
"high": 4,
"medium": 5,
"low": 1
},
"kev": 1,
"support_expired": 1,
"packages": 0,
"last_run_at": "2026-11-15T02:30:00+00:00",
"cve_total": 9,
"affected_systems": 5,
"system_total": 12,
"open_cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"kev": true,
"cvss": 9.8,
"findings": 2,
"products": [
"Fortinet FortiOS"
],
"fixed_in": [
"7.4.9"
]
}
],
"system_list": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"name": "Firewall Hauptsitz",
"kind": "firewall",
"kind_display": "Firewall",
"product": "Fortinet FortiOS",
"version": "7.4.3",
"open_findings": 2,
"support_end": "2027-09-30",
"support_stage": ""
}
]
},
"assets": {
"total": 42,
"critical": 3,
"items": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Firewall Hauptsitz",
"asset_type": "network",
"asset_type_display": "Netzwerk",
"criticality": "critical",
"criticality_display": "Kritisch",
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"open_cves": 2
}
]
},
"attack_surface": null
}
}
Facturation
6 EndpointsFactures 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 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/
{
"billing": {
"model": "it_partner",
"currency": "CHF",
"discount_percent": 30.0,
"invoices": {
"count": 12,
"open_count": 1,
"overdue_count": 0,
"gross_total_chf": 29760.0,
"discount_total_chf": 8928.0,
"net_total_chf": 20832.0,
"open_net_chf": 1736.0,
"overdue_net_chf": 0.0,
"latest_id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24"
},
"current_period": {
"period_start": "2026-11-01",
"period_end": "2026-11-30",
"priced": true,
"customer_count": 8,
"line_count": 9,
"gross_chf": 2565.0,
"discount_chf": 769.5,
"net_chf": 1795.5
},
"sponsor": null
}
}
GET /reseller/api/billing/customers/ Clients avec collaborateurs, plan, abonnement et coûts de la période en cours ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/customers/?include_own=0
{
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 24,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"active_employee_count": 22,
"subscription_plan": "tier_50",
"billing_cycle": "yearly",
"subscription_status": "active"
}
],
"totals": { "priced": true, "gross_chf": 2565.0, "discount_chf": 769.5, "net_chf": 1795.5 }
}
GET /reseller/api/billing/customers/<uuid>/ Client avec état actuel, abonnement et historique des factures ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/customers/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"customer": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"own_company": false,
"billed": true,
"current": {
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 24,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main"
},
"active_employee_count": 22,
"subscription_plan": "tier_50",
"billing_cycle": "yearly",
"subscription_status": "active",
"history": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 22,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"invoice_id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"invoice_status": "sent"
}
]
}
}
GET /reseller/api/billing/invoices/ Factures avec clients et total des collaborateurs, filtrables par statut ; ?include=lines ajoute les positions ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/invoices/?status=open
{
"invoices": [
{
"id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"gross_chf": 2480.0,
"discount_chf": 744.0,
"net_chf": 1736.0,
"currency": "CHF",
"status": "sent",
"status_display": "Gesendet",
"line_count": 9,
"customer_count": 8,
"employee_total": 186,
"companies": [
{ "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "company_name": "Murmelibach AG", "own_company": false }
],
"has_pdf": true,
"issued_at": "2026-11-01T05:00:00+00:00",
"due_at": "2026-12-01T05:00:00+00:00",
"paid_at": null
}
]
}
GET /reseller/api/billing/invoices/<uuid>/ Facture avec toutes les positions par client ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/
{
"invoice": {
"id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"gross_chf": 2480.0,
"discount_chf": 744.0,
"net_chf": 1736.0,
"currency": "CHF",
"status": "sent",
"status_display": "Gesendet",
"line_count": 9,
"customer_count": 8,
"employee_total": 186,
"companies": [
{ "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "company_name": "Murmelibach AG", "own_company": false }
],
"has_pdf": true,
"issued_at": "2026-11-01T05:00:00+00:00",
"due_at": "2026-12-01T05:00:00+00:00",
"paid_at": null,
"lines": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 22,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"period_start": "2026-10-01",
"period_end": "2026-10-31"
}
]
}
}
GET /reseller/api/billing/invoices/<uuid>/pdf/ Facture en PDF ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o rechnung.pdf https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="CT-202610-0042.pdf" %PDF-1.7 …
developers.api.group.r-eng.title
24 Endpointsdevelopers.api.group.r-eng.desc
GET /reseller/api/engagements/ developers.api.ep.r-eng.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/
{
"items": [
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/ developers.api.ep.r-eng.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest ERP 2026", "company": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "pentest_type": "internal", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-2026-17"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.2 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
PATCH /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.3 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"testing_hours": "Mo-Fr 08-18 Uhr"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
DELETE /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.4 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
{
"ok": true,
"result": "deleted"
}
POST /reseller/api/engagements/<uuid>/complete-definition/ developers.api.ep.r-eng.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/complete-definition/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
PUT /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.7 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest ERP 2026 v2", "company": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "pentest_type": "internal", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-2026-17"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
PATCH/DELETE /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.8 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"testing_hours": "Mo-Fr 08-18 Uhr"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/assets/ developers.api.ep.r-eng.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/
{
"items": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/assets/ developers.api.ep.r-eng.11 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"kind": "ip_range", "label": "Server-LAN", "value": "10.0.0.0/24", "scope_keys": ["internal_pentest"]}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
GET /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
PATCH /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.13 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"label": "Server-LAN Süd"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
DELETE /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.14 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
{
"ok": true,
"result": "deleted",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
PUT /reseller/api/engagements/<uuid>/assets/by-ref/<ref>/ developers.api.ep.r-eng.15 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"kind": "ip_range", "label": "Server-LAN", "value": "10.0.0.0/24", "scope_keys": ["internal_pentest"]}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/assets/by-ref/<ref>/ developers.api.ep.r-eng.16 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/by-ref/erp-2026-17/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
POST /reseller/api/engagements/<uuid>/rules/apply-template/ developers.api.ep.r-eng.17 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/apply-template/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
PATCH /reseller/api/engagements/<uuid>/rules/categories/<cat_uuid>/ developers.api.ep.r-eng.18 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"relevant": true}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
PUT /reseller/api/engagements/<uuid>/rules/items/<item_uuid>/ developers.api.ep.r-eng.19 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/items/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"answer": "yes"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
POST /reseller/api/engagements/<uuid>/rules/compile/ developers.api.ep.r-eng.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/compile/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
POST /reseller/api/engagements/<uuid>/provision/ developers.api.ep.r-eng.21 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/provision/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "provisioned",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "delivery",
"signature_state": "signed",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
POST /reseller/api/engagements/<uuid>/cancel/ developers.api.ep.r-eng.22 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/cancel/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"reason": "Auftrag zurückgezogen"}'
{
"ok": true,
"result": "cancelled",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "cancelled",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/document/pdf/ developers.api.ep.r-eng.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o roe.pdf https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="roe.pdf" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/<uuid>/document/docx/ developers.api.ep.r-eng.24 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o roe.docx https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="roe.docx" X-Content-Type-Options: nosniff
developers.api.group.r-eng-runs.title
16 Endpointsdevelopers.api.group.r-eng-runs.desc
GET /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/
{
"items": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "ERP-Server", "pentest_type": "internal", "pentester": "Max Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-pt-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
PUT /reseller/api/engagements/<uuid>/pentests/by-ref/<ref>/ developers.api.ep.r-eng-runs.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "ERP-Server", "pentest_type": "internal", "pentester": "Max Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-pt-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/pentests/by-ref/<ref>/ developers.api.ep.r-eng-runs.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/by-ref/erp-2026-17/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
GET /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
PATCH /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.5 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"end_date": "2026-12-20"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
DELETE /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.6 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
POST /reseller/api/engagements/pentests/<run_uuid>/status/ developers.api.ep.r-eng-runs.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "active"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "active",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET /reseller/api/engagements/<uuid>/audits/ developers.api.ep.r-eng-runs.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/
{
"items": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/audits/ developers.api.ep.r-eng-runs.9 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "IKT-Audit ERP", "scope": "ERP und Anbindungen", "language": "de", "lead": "Erika Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-au-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
PUT /reseller/api/engagements/<uuid>/audits/by-ref/<ref>/ developers.api.ep.r-eng-runs.10 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "IKT-Audit ERP", "scope": "ERP und Anbindungen", "language": "de", "lead": "Erika Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-au-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/audits/by-ref/<ref>/ developers.api.ep.r-eng-runs.11 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/by-ref/erp-2026-17/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
GET /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
PATCH /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.13 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"end_date": "2026-12-20"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
DELETE /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.14 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
POST /reseller/api/engagements/audits/<run_uuid>/status/ developers.api.ep.r-eng-runs.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "preparing"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "preparing",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
developers.api.group.r-eng-plan.title
26 Endpointsdevelopers.api.group.r-eng-plan.desc
POST /reseller/api/engagements/pentests/<run_uuid>/apply-methodology/ developers.api.ep.r-eng-plan.0 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/apply-methodology/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
]
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/categories/ developers.api.ep.r-eng-plan.1 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
{
"items": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/categories/ developers.api.ep.r-eng-plan.2 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Authentisierung", "external_ref": "athn"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.3 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Authentisierung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/ developers.api.ep.r-eng-plan.5 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
GET /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/
{
"items": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwörter prüfen", "severity_default": "high", "external_ref": "wstg-athn-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.8 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwörter prüfen"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/ developers.api.ep.r-eng-plan.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
PUT /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/result/ developers.api.ep.r-eng-plan.11 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/result/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "vulnerable", "note": "Anmeldung mit admin/admin möglich"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
POST /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/raise-finding/ developers.api.ep.r-eng-plan.12 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/raise-finding/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": null,
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open"
}
}
POST /reseller/api/engagements/audits/<run_uuid>/apply-template/ developers.api.ep.r-eng-plan.13 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/apply-template/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
]
}
}
GET /reseller/api/engagements/audits/<run_uuid>/categories/ developers.api.ep.r-eng-plan.14 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
{
"items": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/categories/ developers.api.ep.r-eng-plan.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Zugriffssteuerung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.16 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Zugriffssteuerung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.17 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/ developers.api.ep.r-eng-plan.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
GET /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.19 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/
{
"items": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Rollenkonzept vorhanden"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.21 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Rollenkonzept vorhanden"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.22 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/topics/<topic_uuid>/ developers.api.ep.r-eng-plan.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
POST /reseller/api/engagements/audits/<run_uuid>/topics/<topic_uuid>/raise-finding/ developers.api.ep.r-eng-plan.24 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/raise-finding/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": null,
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/questionnaire/pdf/ developers.api.ep.r-eng-plan.25 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o fragebogen.pdf https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/questionnaire/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="fragebogen.pdf" X-Content-Type-Options: nosniff
developers.api.group.r-eng-findings.title
24 Endpointsdevelopers.api.group.r-eng-findings.desc
GET /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
{
"items": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwort aktiv", "severity": "high", "affected": "erp.murmelibach.example", "external_ref": "f-erp-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwort aktiv", "severity": "high", "affected": "erp.murmelibach.example", "external_ref": "f-erp-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/ developers.api.ep.r-eng-findings.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/status/ developers.api.ep.r-eng-findings.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "fixed"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "fixed",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/ developers.api.ep.r-eng-findings.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
{
"items": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/ developers.api.ep.r-eng-findings.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Kein Rollenkonzept"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.8 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Kein Rollenkonzept"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/ developers.api.ep.r-eng-findings.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/status/ developers.api.ep.r-eng-findings.11 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "accepted"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "accepted",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.13 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske" \ -F "external_ref=login-png"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.14 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.15 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/ developers.api.ep.r-eng-findings.16 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/file/ developers.api.ep.r-eng-findings.17 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o login.png https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/
HTTP/1.1 200 OK Content-Type: image/png Content-Disposition: attachment; filename="login.png" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.19 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske" \ -F "external_ref=login-png"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.21 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/ developers.api.ep.r-eng-findings.22 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/file/ developers.api.ep.r-eng-findings.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o login.png https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/
HTTP/1.1 200 OK Content-Type: image/png Content-Disposition: attachment; filename="login.png" X-Content-Type-Options: nosniff
developers.api.group.r-eng-reports.title
26 Endpointsdevelopers.api.group.r-eng-reports.desc
GET /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
{
"items": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
GET /reseller/api/engagements/audits/<run_uuid>/reports/ developers.api.ep.r-eng-reports.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
{
"items": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/reports/ developers.api.ep.r-eng-reports.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.6 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.7 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
GET /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
PATCH /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.9 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Report ERP, Fassung 2"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
DELETE /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.10 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
GET /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.11 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/
{
"items": [
{
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.12 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"heading": "Management Summary", "body": "<p>Text</p>"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/reports/<report_uuid>/sections/<section_uuid>/ developers.api.ep.r-eng-reports.13 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82/
{
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
POST /reseller/api/engagements/reports/<report_uuid>/finalize/ developers.api.ep.r-eng-reports.14 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/finalize/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "final",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/unfinalize/ developers.api.ep.r-eng-reports.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/unfinalize/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/deliver/ developers.api.ep.r-eng-reports.16 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/deliver/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"delivered_to": "[email protected]", "delivered_at": "2026-11-18", "note": "Per verschlüsselter Mail"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "delivered",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "[email protected]",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/undeliver/ developers.api.ep.r-eng-reports.17 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/undeliver/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "final",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET /reseller/api/engagements/reports/<report_uuid>/files/docx/ developers.api.ep.r-eng-reports.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report.docx https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="report.docx" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/reports/<report_uuid>/files/pdf/ developers.api.ep.r-eng-reports.19 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report.pdf https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="report.pdf" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/reports/<report_uuid>/versions/ developers.api.ep.r-eng-reports.20 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/
{
"items": [
{
"id": "7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13",
"sha256": "9f2c…e41a",
"status_at_time": "final",
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"created_by": "Integration ERP",
"created_at": "2026-11-17T08:00:00+00:00",
"docx": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13/docx/"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/reports/<report_uuid>/versions/<version_uuid>/docx/ developers.api.ep.r-eng-reports.21 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report-v1.docx https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="report-v1.docx" X-Content-Type-Options: nosniff
POST /reseller/api/engagements/<uuid>/ai-draft/ developers.api.ep.r-eng-reports.22 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ai-draft/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
POST /reseller/api/engagements/reports/<report_uuid>/sections/<section_uuid>/ai-text/ developers.api.ep.r-eng-reports.23 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82/ai-text/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "body", "instruction": "Kürzer und für die Geschäftsleitung formulieren"}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
POST /reseller/api/engagements/reports/<report_uuid>/generate/ developers.api.ep.r-eng-reports.24 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/generate/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
GET /reseller/api/engagements/jobs/<job_uuid>/ developers.api.ep.r-eng-reports.25 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/jobs/0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53/
{
"ok": true,
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "done",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": {
"docx": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/docx/",
"pdf": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/pdf/"
},
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
developers.api.group.r-eng-library.title
10 Endpointsdevelopers.api.group.r-eng-library.desc
GET /reseller/api/engagements/library/roe-templates/ developers.api.ep.r-eng-library.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Interner Pentest",
"description": "",
"pentest_type": "internal",
"translations": {}
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/roe-templates/<uuid>/ developers.api.ep.r-eng-library.1 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Interner Pentest",
"description": "",
"pentest_type": "internal",
"translations": {}
}
GET /reseller/api/engagements/library/methodologies/ developers.api.ep.r-eng-library.2 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/methodologies/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/methodologies/<uuid>/ developers.api.ep.r-eng-library.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/methodologies/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
GET /reseller/api/engagements/library/audit-templates/ developers.api.ep.r-eng-library.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/audit-templates/<uuid>/ developers.api.ep.r-eng-library.5 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
GET /reseller/api/engagements/library/report-templates/ developers.api.ep.r-eng-library.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/report-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Pentest-Report Standard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/report-templates/<uuid>/ developers.api.ep.r-eng-library.7 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/report-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Pentest-Report Standard",
"description": ""
}
GET /reseller/api/engagements/library/vulnerabilities/ developers.api.ep.r-eng-library.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"title": "Standardkennwörter",
"severity": "high",
"cwe": "CWE-1392",
"cvss_score": "9.1"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/vulnerabilities/<uuid>/ developers.api.ep.r-eng-library.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"title": "Standardkennwörter",
"severity": "high",
"cwe": "CWE-1392",
"cvss_score": "9.1"
}
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.
Limites de débit & remarques.
- 100 requêtes / min par jeton. En cas de dépassement, un
429avec en-têteRetry-Afterest 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_sizedans la spécification OpenAPI prennent en charge?page=et?page_size=(50 par défaut, max. 200). Avec pagination, la réponse contient en pluspage,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.
Questions techniques sur l'API. Réponse en règle générale dans un jour ouvrable.
Ventes, démos, demandes de partenariat. Réponse en règle générale dans un jour ouvrable.