Panoramica.
CyberTell mette a disposizione un'API REST completa, organizzata in tre portali. Ogni portale ha la propria autenticazione e i propri endpoint. Tutte le risposte sono in JSON. Tutti i timestamp sono in UTC (ISO 8601).
Autenticazione.
Tutti e tre i portali si autenticano allo stesso modo: con una chiave API come token Bearer. Ogni portale ha le proprie chiavi e ogni chiave vale solo per gli ambiti scelti al momento della creazione.
Crea una chiave API nel rispettivo portale: azienda in Profilo → Chiavi API, rivenditore in API → Chiavi API (solo amministratori), privati in Profilo → Chiavi API. La chiave ha la forma ctk_<id>_<secret> e viene mostrata una sola volta. Inviala a ogni chiamata come Authorization: Bearer <chiave>.
# Usa la chiave API dal tuo profilo curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/employees/
Ambiti: le chiavi aziendali vengono abilitate per moduli, le chiavi rivenditore per clienti e fatturazione, le chiavi dei privati per profilo, fughe di dati, incidenti e corsi. Un endpoint fuori dall’ambito risponde 403, una chiave non valida, scaduta o disattivata 401.
Azienda: anche gli endpoint di amministrazione come campagne, flotta, ruoli e sedi verificano l’abilitazione del modulo della chiave. Fatturazione e corporate design (/company/api/billing/, /company/api/layout/) richiedono l’ambito Account aziendale, che solo gli amministratori dell’azienda possono assegnare a una chiave.
Chiavi aziendali precedenti: le coppie di chiavi di accesso (Authorization: CTAK <id>:<secret>) e le chiavi statiche di 64 caratteri esadecimali funzionano ancora per ora. L’intestazione X-Company-UUID non è più necessaria; se la invii, deve indicare l’azienda giusta. Le nuove chiavi sono sempre chiavi ctk_.
Le aziende con una propria istanza sostituiscono l'host con l'indirizzo della loro istanza – i percorsi restano invariati.
API Azienda (B2B)
Tutti gli endpoint richiedono una chiave API aziendale nell’intestazione Authorization (Bearer ctk_…), abilitata per il modulo dell’endpoint.
Autenticazione & login
2 EndpointsGET /company/tickets/api/me/ Utente corrente ▶
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/ Cambiare la lingua dell’account ▶
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"
}
Dipendenti & amministrazione
14 EndpointsGET /company/api/employees/ Elenca tutti i dipendenti ▶
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/ Crea dipendente ▶
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>/ Leggere, modificare o disattivare un collaboratore (DELETE imposta 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/ Invia invito ▶
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/ Elencare / creare ruoli ▶
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>/ Modificare o eliminare un ruolo ▶
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/ Elenca le sedi ▶
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/ Crea sede ▶
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>/ Dettaglio sede ▶
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/ Tipi di sede ▶
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/ Informazioni di fatturazione ▶
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/ Layout dei documenti (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/ Leggere il profilo aziendale (con elenchi di scelta) ▶
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/ Aggiornare il profilo aziendale ▶
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": []
}
Campagne di phishing
3 EndpointsGET /company/api/campaigns/ Elenca le campagne ▶
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/ Crea campagna come bozza (avvio nel portale 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/ Modelli & opzioni ▶
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" }
]
}
Incidenti & ticket
11 EndpointsGET /company/tickets/api/list/ Elenco ticket (filtro: ?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/ Crea 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/ Elenchi di scelta per i nuovi ticket ▶
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>/ Dettaglio 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/ Invia risposta ▶
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/ Modifica stato ▶
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/ Modifica 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/ Assegnare un ticket a una persona (admin; vuoto = rimuovere l'assegnazione) ▶
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/ Modificare titolo/descrizione o un proprio messaggio (con 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/ Cercare persone per le menzioni @ (?q=, senza indirizzi 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/ Statistiche della dashboard ▶
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/ Tattiche con tecniche e copertura tramite ticket e notizie dell'azienda ▶
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>/ Una tecnica con ticket e notizie collegati (al massimo 20 ciascuno) ▶
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/ Elenca le war room ▶
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/ Crea 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>/ Dettaglio 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/ Recupera messaggi (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/ Invia messaggio ▶
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/ Leggere, invitare o rimuovere partecipanti ▶
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
}
Monitoraggio del Dark Web
4 EndpointsGET /company/tickets/api/darkweb/ Panoramica delle scansioni ▶
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/ Avvia scansione (solo domini verificati) ▶
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>/ Dettaglio scansione ▶
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/ Domini aziendali per la scansione ▶
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
}
]
}
Analisi di phishing (EML)
2 EndpointsPOST /company/tickets/analysis/api/upload/ Carica file 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/ Elenco analisi ▶
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 Mail (indicatori di phishing)
3 EndpointsAPI per il plugin di Apple Mail per il rilevamento automatico del phishing. Gli indicatori vengono estratti dalle analisi di phishing confermate.
GET /company/tickets/api/mail-plugin/indicators/ Recupera indicatori di 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/ Verifica l'e-mail rispetto agli indicatori ▶
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>/ Dettaglio analisi per il 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"
}
Video di awareness
7 EndpointsGET /company/videos/api/list/ Elenco video ▶
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/ Genera video di awareness (IA; opzionali: 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>/ Dettaglio del video con le diapositive ▶
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/ Riavviare il rendering ▶
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/ Scaricare l’MP4 per il player ▶
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/ Eliminare il video ▶
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/ Segnalare i secondi visti (rilevamento del completamento) ▶
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
}
Registro degli asset
5 EndpointsLettura con il modulo abilitato sulla chiave; creazione, modifica ed eliminazione solo per gli amministratori dell’azienda.
GET /company/assets/api/list/ Asset con valutazione del rischio ▶
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/ Crea asset ▶
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>/ Dettaglio asset ▶
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/ Elencare o creare i rischi di un asset ▶
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>/ Leggere, modificare o eliminare un rischio; accepted: true lo accetta ▶
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"
}
Terze parti (fornitori)
3 EndpointsLettura con il modulo abilitato sulla chiave; creazione, modifica ed eliminazione solo per gli amministratori dell’azienda.
GET /company/suppliers/api/list/ Elenca i fornitori ▶
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/ Crea fornitore ▶
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>/ Dettaglio fornitore ▶
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"
}
Valutazione ICT
7 EndpointsLettura con il modulo abilitato sulla chiave; creazione, modifica ed eliminazione solo per gli amministratori dell’azienda.
GET /company/ict/api/list/ Elenca le valutazioni (?include_auto=1 include il riflesso 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/ Catalogo dei requisiti di uno standard (funzioni, categorie, requisiti; ?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/ Crea valutazione ▶
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>/ Dettaglio valutazione ▶
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/ Salva risposta ▶
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/ Standard di conformità disponibili ▶
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/ Rapporto di conformità in 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 …
Valutazione AD
3 EndpointsLettura con il modulo abilitato sulla chiave; creazione, modifica ed eliminazione solo per gli amministratori dell’azienda.
GET /company/ad/api/list/ Elenca i dump 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/ Carica 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>/ Dettaglio 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"
}
Assessment Microsoft 365
3 EndpointsLettura con il modulo abilitato sulla chiave; creazione, modifica ed eliminazione solo per gli amministratori dell’azienda.
GET /company/azure/api/list/ Elenca i dump 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/ Carica 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>/ Dettaglio 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"
}
Gestione dei rischi
2 EndpointsGET /company/risk/api/list/ Elenca i rischi ▶
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/ Crea rischio ▶
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"
}
Dipendenze e interruzione
16 EndpointsLettura e simulazione richiedono l’abilitazione del modulo sulla chiave; solo gli amministratori aziendali modificano mappa, processi, gruppi e scenari.
GET /company/data-flows/api/mobile/ Indicatori, single point of failure e scenari di interruzione ▶
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/ Mappa: tutti i nodi, flussi e gruppi ▶
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/ Mettere sulla mappa un fornitore, un asset o un processo (idempotente) ▶
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>/ Togliere un nodo e i suoi flussi dalla mappa; fornitore, asset o processo restano ▶
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/ Creare un flusso tra due nodi ▶
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>/ Modificare un flusso (solo i campi inviati) o eliminarlo ▶
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/ Elencare o creare processi aziendali (subito sulla mappa) ▶
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>/ Leggere, modificare o eliminare un processo aziendale ▶
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/ Elencare o creare gruppi ▶
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>/ Rinominare un gruppo, impostare (nodes), aggiungere (add) o togliere (remove) nodi, o eliminare il gruppo ▶
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/ Simulare un’interruzione senza salvare nulla (innesco per nodo o per fornitore, asset, processo) ▶
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/ Elencare gli scenari salvati o salvare una simulazione come scenario ▶
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>/ Leggere uno scenario con il risultato o eliminarlo ▶
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/ Stato delle pagine di stato per nodo ed effetto dei disservizi in corso ▶
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/ Cronologia dei disservizi dei fornitori, i più recenti prima; ?open=1 solo quelli in corso ▶
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/ Leggere e impostare la posizione dei nodi ▶
curl -X PUT https://portal.cybertell.io/company/data-flows/api/layout/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"positions": {"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26": {"x": 0, "y": 160}}}'
{
"ok": true,
"updated": 1
}
Backup e ripristino
1 EndpointGET /company/backups/api/mobile/ Piani di backup con test di ripristino e asset non protetti ▶
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": []
}
Superficie d'attacco
1 EndpointGET /company/attack-surface/api/mobile/ Indicatori, ultima scansione, rilevamenti aperti e asset ▶
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
}
]
}
Divieti di accesso
3 EndpointsGET /company/banning-orders/api/list/ Elenca i divieti di accesso (i 100 più recenti) ▶
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/ Crea divieto di accesso ▶
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>/ Dettaglio divieto di accesso ▶
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
}
Esercitazioni tabletop
6 EndpointsGET /company/tabletop/api/scenarios/ Elenca gli scenari ▶
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/ Genera scenario (AI) ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/scenarios/generate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"scenario_type": "ransomware", "difficulty": "hard", "extra_context": "", "phase_count": 8}'
{
"job_id": "6d8f0a24-5c7e-4b91-8a36-2f4a6c8e0d51",
"status": "generating"
}
GET /company/tabletop/api/scenarios/<uuid>/ Dettaglio scenario ▶
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/ Elenca le negoziazioni ▶
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>/ Dettaglio negoziazione ▶
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/ Invia messaggio ▶
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, parco dispositivi & threat report
8 EndpointsGET /company/api/soc/status/ Stato dell’hub SOC (firewall configurato) ▶
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/ Leggere / salvare la configurazione del threat report (role_id come UUID o intero interno) ▶
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/ Dati in tempo reale di un provider SOC (provider = firewalla, pfsense, sophos, defender, graylog; finestra ?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/ Flussi aggregati di un dispositivo nell'ultima ora (?device= obbligatorio, ?region= facoltativo) ▶
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/ Assegnare dispositivi ai collaboratori (admin; mitarbeiter_id come UUID o intero interno) ▶
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/ Analisi IA di un allarme (campi del modulo; anche sotto /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/ Verificare una destinazione sospetta (action=vt|ai|both; anche sotto /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/ Ultimo rapporto sulla situazione ▶
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"
}
}
Integrazione Firewalla
13 EndpointsGET /company/api/firewalla/overview/ Panoramica della dashboard ▶
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/ Elenca i dispositivi (box) ▶
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>/ Dettaglio 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/ Dispositivi di una 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/ Flussi di traffico (?query=, ?groupBy=, ?sortBy=, ?cursor=, ?limit= predefinito 50, max. 500) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/flows/?limit=200
{
"flows": [
{
"ts": "16.05.2026 08:00",
"ts_epoch": 1778918400.0,
"protocol": "tcp",
"dport": "443",
"sport": "",
"direction": "outbound",
"download": 10240,
"upload": 2048,
"category": "",
"region": "US",
"device": "WS-042",
"device_ip": "10.0.0.42",
"source": "",
"destination": "example.com",
"dest_ip": "93.184.216.34",
"blocked": false,
"duration": 0.4,
"count": 1
}
],
"count": 1,
"next_cursor": ""
}
GET /company/api/firewalla/device-flows/ Traffico del dispositivo (?device= obbligatorio, ?region= facoltativo) ▶
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/ Statistiche della 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/ Feed SOC in tempo reale ▶
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/ Paesi bloccati ▶
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/ Gestisci i domini bloccati ▶
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/ Gestisci le assegnazioni dei dispositivi (mitarbeiter_id come UUID o intero interno) ▶
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/ Metti in pausa la regola ▶
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/ Riprendi la regola ▶
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."
}
Playbook (incident response)
14 EndpointsGET /company/playbooks/api/list/ Elenca i playbook ▶
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/ Crea playbook (facoltativamente con contenuti 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>/ Dettaglio 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 in 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/ Elenca le esecuzioni (?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/ Opzioni per l’attivazione: playbook con domande di verifica, sistemi, fornitori, war room, ticket ▶
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/ Avvia un’esecuzione (esercitazione o incidente) con sistemi, fornitori, collegamento e verifica del caso ▶
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>/ Dettaglio esecuzione: sezioni e passi con stato, verifica del caso, sistemi e fornitori coinvolti, permessi ▶
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/ Sostituisce sistemi e fornitori coinvolti (senza la chiave suppliers i fornitori restano invariati) ▶
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/ Imposta le risposte della verifica del caso (true, false o null = aperto) ▶
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/ Spunta, salta o riapre un passo (offen|erledigt|uebersprungen), con nota facoltativa ▶
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/ Conclude o interrompe un’esecuzione (action=finish|abort), nota finale, revisione facoltativa ▶
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/ Elimina un’esecuzione (solo amministratore dell’azienda) ▶
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/ Esecuzione come 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 …
Policy di sicurezza
3 EndpointsI dipendenti consultano la policy di sicurezza attuale e la confermano. Le conferme vengono registrate come prova di conformità.
GET /company/policy/api/ Recupera la policy attuale ▶
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/ Conferma la policy (dipendente) ▶
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/ Direttiva in 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 …
Documenti sicuri
1 EndpointGET /company/api/documents/ Documenti aziendali condivisi ▶
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"
}
]
}
Punti
1 EndpointGET /company/api/points/me/ Punti personali e classifica ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/points/me/
{
"points": {
"total": 1840,
"this_month": 260,
"this_month_chf": 26.0,
"monthly_budget_chf": 50.0,
"enabled": true,
"level": "Wachsam",
"level_progress": 0.6,
"next_level_points": 2000,
"my_rank": 3,
"leaderboard": [
{ "rank": 1, "name": "Erika Muster", "points": 2410, "is_me": false },
{ "rank": 3, "name": "Max Muster", "points": 1840, "is_me": true }
]
}
}
Roadmap
2 EndpointsGET /company/roadmap/api/mobile/ Fasi, avanzamento e prossimi passi ▶
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/ Completare o rinviare un passo ▶
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/ Indicatori e rapporti 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>/ Rapporto con allineamento e sorgenti non conformi ▶
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"
}
]
}
Risposta agli incidenti
1 EndpointGET /company/api/mobile/incident-response/ Indagini e indicatori (?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 }
}
Registro di audit
1 EndpointGET /company/tickets/api/audit-log/ Registro di audit dell'azienda (ultimi 100 eventi, solo amministratori) ▶
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 Privati.
Tutti gli endpoint richiedono una chiave API privata nell’intestazione Authorization (Bearer ctk_…). Una chiave vede solo i dati della persona che l’ha creata.
Dashboard & profilo
2 EndpointsGET /individual/api/dashboard/ Panoramica della dashboard (courses_* conta i tentativi d'esame) ▶
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/ Dati del profilo ▶
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]" } ] }
}
}
Controlli di leak e-mail
2 EndpointsGET /individual/api/leak-checks/ Elenco dei controlli di leak ▶
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>/ Dettaglio con i breach ▶
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": "" }
]
}
}
Corsi
1 EndpointGET /individual/api/courses/ Corsi della persona con avanzamento (stessa selezione di /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" }
}
]
}
Rivenditore / API assicurazione.
Tutti gli endpoint richiedono una chiave API rivenditore nell’intestazione Authorization (Bearer ctk_…). La fatturazione richiede inoltre che la chiave sia stata creata da un amministratore che lo è ancora.
Dashboard
1 EndpointGET /reseller/api/dashboard/ Panoramica ▶
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
}
}
Aziende
6 EndpointsGET /reseller/api/companies/ Elenca le aziende gestite ▶
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>/ Dettaglio azienda ▶
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/ Situazione di sicurezza di tutti i clienti ▶
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 aperte di tutti i clienti ▶
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/ Asset attivi di tutti i clienti ▶
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/ Situazione di sicurezza di un cliente ▶
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
}
}
Fatturazione
6 EndpointsFatture cumulative e costi per cliente per la propria contabilità. Ogni posizione indica l’azienda cliente, il numero di collaboratori, il piano, quantità e unità, il prezzo di listino, lo sconto partner e l’importo netto. Richiede una chiave API con l’ambito «Fatturazione» creata da un amministratore del partner; i costi per cliente sono disponibili solo per i partner IT. Senza prezzo di listino (on-premises) gli importi del periodo corrente sono null; le fatture meno recenti restituiscono i nuovi campi come null.
GET /reseller/api/billing/ Panoramica con totali, importi aperti e periodo in corso ▶
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/ Clienti con collaboratori, piano, abbonamento e costi del periodo corrente ▶
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>/ Cliente con stato attuale, abbonamento e storico delle fatture ▶
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/ Fatture con clienti e totale collaboratori, filtrabili per stato; ?include=lines aggiunge le posizioni ▶
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>/ Fattura con tutte le posizioni per cliente ▶
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/ Fattura in 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"
}
Formato di risposta.
Tutte le risposte dell'API vengono restituite in JSON. Le richieste riuscite contengono i dati direttamente, gli errori restituiscono un oggetto di errore strutturato:
Risposta riuscita
{
"employees": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Mueller",
"email": "[email protected]"
}
]
}
Risposta di errore
{
"error": "Non autenticato",
"code": 401
}
Gli oggetti di errore delle API dei portali contengono error (un messaggio leggibile nella lingua dell’account) e code (lo stato HTTP come numero); gli errori imprevisti del server (500) restituiscono solo error. Un 403 si verifica tipicamente quando la chiave API non ha l’ambito dell’endpoint — modifica l’ambito della chiave nel portale in Chiavi API.
Codici di stato HTTP.
Limiti di frequenza & note.
- 100 richieste / min per token. In caso di superamento viene restituito un
429con headerRetry-After. - Tutti i timestamp sono in UTC (formato ISO 8601).
- L'API è fornita tramite HTTPS.
- URL di base: Azienda (B2B), Rivenditore / assicurazione:
https://portal.cybertell.io· Privati:https://app.cybertell.io. Le aziende con una propria istanza sostituiscono l'host con l'indirizzo della loro istanza – i percorsi restano invariati. - Paginazione: gli endpoint di elenco che riportano i parametri
page/page_sizenella specifica OpenAPI supportano?page=e?page_size=(predefinito 50, max. 200). Con la paginazione la risposta contiene inoltrepage,page_size,total,total_pages. Senza parametri di paginazione alcuni elenchi restituiscono solo le 50–200 voci più recenti; per elenchi completi usa sempre?page=.
Contatto & supporto.
Domande sull'integrazione API? Rispondiamo per e-mail, di regola entro un giorno lavorativo.
Domande tecniche sull'API. Risposta di regola entro un giorno lavorativo.
Vendite, demo, richieste partner. Risposta di regola entro un giorno lavorativo.