Developer & API. Integra CyberTell nella tua infrastruttura.

API REST e specifica OpenAPI per le operazioni di sicurezza. Tre portali, un vocabolario — azienda, privati, rivenditore.

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

Azienda(B2B)

Piattaforma di Security Operations per le aziende — tutti i moduli attivati per l'azienda tramite un'unica API.

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

Privati

Portale di cyber security individuale — account, controlli e contenuti didattici tramite un'unica API.

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

Rivenditore/ Assicurazione

Portale di gestione partner per rivenditori, assicurazioni e comuni. Gestione di tutte le aziende e di tutti i privati assegnati.

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

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.

API Key Azienda · Rivenditore · Privati Bearer

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 Endpoints
GET /company/tickets/api/me/ Utente corrente ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/me/
Response
{
  "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
  "first_name": "Max",
  "last_name": "Muster",
  "email": "[email protected]",
  "is_admin": true,
  "company_name": "Murmelibach AG",
  "company_uuid": "2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02",
  "language": "de",
  "modules": ["incidents", "phishing_analysis", "courses"],
  "has_firewalla": true,
  "gamification_enabled": true,
  "profile_image_url": null,
  "company_logo_url": "https://cybertell.io/media/logos/murmelibach.png"
}
POST /company/tickets/api/me/language/ Cambiare la lingua dell’account ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/me/language/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"language": "fr"}'
Response
{
  "ok": true,
  "language": "fr"
}

Dipendenti & amministrazione

14 Endpoints
GET /company/api/employees/ Elenca tutti i dipendenti ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/employees/
Response
{
  "employees": [
    {
      "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "firstname": "Anna",
      "lastname": "Müller",
      "email": "[email protected]",
      "status": "active",
      "status_display": "Aktiv",
      "is_company_admin": false,
      "language": "de",
      "roles": [{"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d", "name": "Mitarbeiter"}],
      "last_login": "2026-06-10T08:15:00+00:00",
      "created_at": "2026-01-12T09:00:00+00:00"
    }
  ]
}
POST /company/api/employees/create/ Crea dipendente ▶
Request
curl -X POST https://portal.cybertell.io/company/api/employees/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"firstname": "Anna", "lastname": "Müller", "email": "[email protected]", "language": "de", "is_company_admin": false, "role_ids": ["a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d"], "send_invite_now": true}'
Response
{
  "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
  "firstname": "Anna",
  "lastname": "Müller",
  "email": "[email protected]",
  "status": "active",
  "is_company_admin": false,
  "invitation_sent": true
}
GET/PATCH/PUT/DEL /company/api/employees/<uuid>/ Leggere, modificare o disattivare un collaboratore (DELETE imposta status=inactive) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/
Response
{
  "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
  "firstname": "Anna",
  "lastname": "Müller",
  "email": "[email protected]",
  "status": "active",
  "status_display": "Aktiv",
  "is_company_admin": false,
  "language": "de",
  "phone": "",
  "department": "",
  "position": "",
  "roles": [{"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d", "name": "Mitarbeiter"}],
  "certifications": [{"id": "3b9d1f72-8c4a-4e15-9a6b-2d7e0c1f5a83", "title": "Security Awareness Basis"}],
  "totp_enabled": false,
  "passkey_enabled": true,
  "last_login": "2026-06-10T08:15:00+00:00",
  "private_email": "",
  "company_mobile": "",
  "private_mobile": "",
  "country": "ch"
}
POST /company/api/employees/<uuid>/invite/ Invia invito ▶
Request
curl -X POST https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/invite/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
  "invitation_sent": true
}
GET/POST /company/api/roles/ Elencare / creare ruoli ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/roles/
Response
{
  "roles": [
    {
      "id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
      "name": "Werkstatt",
      "is_default": false,
      "is_external": false,
      "modules": [{"id": 3, "key": "incidents", "name": "Vorfälle"}],
      "member_count": 8
    }
  ]
}
PATCH/DELETE /company/api/roles/<uuid>/ Modificare o eliminare un ruolo ▶
Request
curl -X PATCH https://portal.cybertell.io/company/api/roles/b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Werkstatt", "is_external": false, "module_ids": [3]}'
Response
{
  "id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
  "name": "Werkstatt",
  "is_default": false,
  "is_external": false
}
GET /company/api/locations/ Elenca le sedi ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/locations/
Response
{
  "locations": [
    {
      "id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
      "name": "Hauptsitz Murmelibach",
      "street": "Dorfstrasse 12",
      "address": "Dorfstrasse 12",
      "zip_code": "3000",
      "city": "Murmelibach",
      "country_code": "ch",
      "country": "ch",
      "location_types": [{"id": 1, "name": "Büro", "key": "office"}],
      "ai_risk_level": "",
      "ai_risk_analysis": "",
      "created_at": "2026-01-12T09:00:00+00:00"
    }
  ]
}
POST /company/api/locations/create/ Crea sede ▶
Request
curl -X POST https://portal.cybertell.io/company/api/locations/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Filiale Tannenhof", "street": "Bahnhofstrasse 3", "zip_code": "3011", "city": "Bern", "country_code": "ch", "employee_count": 6, "location_type_ids": [1]}'
Response
{
  "id": "e7f9a1c3-5b2d-4c84-9e16-7a3c5e9b1d40",
  "name": "Filiale Tannenhof"
}
GET/PATCH/PUT/DEL /company/api/locations/<uuid>/ Dettaglio sede ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/locations/a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d/
Response
{
  "id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
  "name": "Hauptsitz Murmelibach",
  "street": "Dorfstrasse 12",
  "zip_code": "3000",
  "city": "Murmelibach",
  "country_code": "ch",
  "description": "",
  "notes": "",
  "location_types": [{"id": 1, "name": "Büro", "key": "office"}],
  "employee_count": 24,
  "has_servers": true,
  "has_network_infrastructure": true,
  "has_physical_security": true,
  "has_backup_power": false,
  "has_fire_suppression": false,
  "has_access_control": true,
  "ai_risk_level": "",
  "ai_risk_analysis": "",
  "created_at": "2026-01-12T09:00:00+00:00",
  "updated_at": "2026-05-02T10:00:00+00:00"
}
GET /company/api/location-types/ Tipi di sede ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/location-types/
Response
{
  "types": [
    { "id": 1, "name": "Büro", "key": "office" },
    { "id": 2, "name": "Rechenzentrum", "key": "datacenter" }
  ]
}
GET /company/api/billing/ Informazioni di fatturazione ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/billing/
Response
{
  "plan": "tier_10",
  "billed_via": "direct",
  "reseller": null,
  "employee_count": 8,
  "billing_cycle": "yearly",
  "subscription_status": "active",
  "trial_ends_at": null,
  "stripe_current_period_end": "2027-01-12T09:00:00+00:00"
}
GET /company/api/layout/ Layout dei documenti (logo / CI) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/layout/
Response
{
  "accent_color": "#1f6f4a",
  "font_family": "",
  "heading_font_family": "",
  "confidentiality_text": "Vertraulich",
  "footer_text": "",
  "cover_variant": "classic",
  "accent_line": "left",
  "logo_position": "right",
  "watermark_text": "",
  "margin_preset": "normal",
  "show_toc": true,
  "show_changelog": true,
  "updated_at": "2026-04-02T10:00:00+00:00"
}
GET /company/tabletop/api/company-profile/ Leggere il profilo aziendale (con elenchi di scelta) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/company-profile/
Response
{
  "company_title": "Murmelibach AG",
  "industry": "finance",
  "industry_label": "Finanzdienstleistung",
  "company_size": "11-50",
  "company_size_label": "11–50 Mitarbeiter",
  "description": "",
  "it_landscape": "Microsoft 365, Fileserver",
  "critical_assets": "Kundendaten, Zahlungsverkehr",
  "compliance_notes": "",
  "country": "Schweiz",
  "country_code": "ch",
  "country_label": "Schweiz",
  "website": "https://murmelibach-ag.example",
  "default_language": "de",
  "logo_url": "/media/logos/murmelibach.png",
  "domains": [
    { "domain": "murmelibach-ag.ch", "is_primary": true, "notes": "" }
  ],
  "industry_choices": [
    { "value": "finance", "label": "Finanzdienstleistung" }
  ],
  "company_size_choices": [
    { "value": "11-50", "label": "11–50 Mitarbeiter" }
  ],
  "country_choices": [
    { "value": "ch", "label": "Schweiz" }
  ],
  "language_choices": [
    { "value": "de", "label": "Deutsch" }
  ]
}
POST /company/tabletop/api/company-profile/update/ Aggiornare il profilo aziendale ▶
Request
curl -X POST https://portal.cybertell.io/company/tabletop/api/company-profile/update/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"company_title": "Murmelibach AG", "industry": "finance", "company_size": "11-50", "critical_assets": "Kundendaten, Zahlungsverkehr", "default_language": "de", "country_code": "ch"}'
Response
{
  "company_title": "Murmelibach AG",
  "industry": "finance",
  "industry_label": "Finanzdienstleistung",
  "company_size": "11-50",
  "company_size_label": "11–50 Mitarbeiter",
  "description": "",
  "it_landscape": "",
  "critical_assets": "Kundendaten, Zahlungsverkehr",
  "compliance_notes": "",
  "country": "Schweiz",
  "country_code": "ch",
  "country_label": "Schweiz",
  "website": "",
  "default_language": "de",
  "logo_url": "",
  "domains": [],
  "industry_choices": [],
  "company_size_choices": [],
  "country_choices": [],
  "language_choices": []
}

Campagne di phishing

3 Endpoints
GET /company/api/campaigns/ Elenca le campagne ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/campaigns/
Response
{
  "campaigns": [
    {
      "id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
      "name": "Q2 Awareness",
      "status": "Wird gesendet",
      "created_date": "2026-05-02T09:00:00+00:00",
      "stats": { "sent": 120, "opened": 61, "clicked": 14 }
    }
  ]
}
POST /company/api/campaigns/create/ Crea campagna come bozza (avvio nel portale web) ▶
Request
curl -X POST https://portal.cybertell.io/company/api/campaigns/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q2 Awareness", "template_id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "smtp_profile_id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "landing_page_id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24"}'
Response
{
  "id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
  "name": "Q2 Awareness"
}
GET /company/api/campaigns/options/ Modelli & opzioni ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/campaigns/options/
Response
{
  "templates": [
    { "id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "name": "Paket-Benachrichtigung" }
  ],
  "smtp_profiles": [
    { "id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "name": "Standard-SMTP" }
  ],
  "landing_pages": [
    { "id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24", "name": "Login-Seite" }
  ]
}

Incidenti & ticket

11 Endpoints
GET /company/tickets/api/list/ Elenco ticket (filtro: ?status=, ?category=, ?type=employee|incident, ?q=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/list/?status=offen&category=phishing
Response
{
  "tickets": [
    {
      "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
      "title": "Verdächtige E-Mail",
      "category": "phishing",
      "category_display": "Phishing-Verdacht",
      "ticket_type": "meldung",
      "type_display": "Meldung",
      "status": "offen",
      "status_display": "Offen",
      "priority": "hoch",
      "priority_display": "Hoch",
      "is_serious_incident": false,
      "created_at": "2026-05-15T09:30:00+00:00",
      "updated_at": "2026-05-16T07:10:00+00:00",
      "message_count": 2
    }
  ],
  "total_count": 1
}
POST /company/tickets/api/create/ Crea ticket ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"category": "phishing", "title": "Verdächtige E-Mail", "description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.", "priority": "hoch", "ticket_type": "meldung"}'
Response
{
  "ticket_id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
  "message": "Ticket erstellt."
}
GET /company/tickets/api/options/ Elenchi di scelta per i nuovi ticket ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/options/
Response
{
  "categories": [
    { "value": "frage", "label": "Frage" },
    { "value": "phishing", "label": "Phishing-Verdacht" },
    { "value": "sonstiges", "label": "Sonstiges" }
  ],
  "ticket_types": [
    { "value": "meldung", "label": "Meldung" },
    { "value": "vorfall", "label": "Vorfall" }
  ],
  "priorities": [
    { "value": "niedrig", "label": "Niedrig" },
    { "value": "mittel", "label": "Mittel" },
    { "value": "hoch", "label": "Hoch" },
    { "value": "kritisch", "label": "Kritisch" }
  ],
  "defaults": { "category": "sonstiges", "ticket_type": "meldung", "priority": "mittel" }
}
GET /company/tickets/api/<uuid>/ Dettaglio ticket ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/
Response
{
  "ticket": {
    "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
    "title": "Verdächtige E-Mail",
    "description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.",
    "category": "phishing",
    "category_display": "Phishing-Verdacht",
    "ticket_type": "meldung",
    "type_display": "Meldung",
    "status": "offen",
    "status_display": "Offen",
    "priority": "hoch",
    "priority_display": "Hoch",
    "is_serious_incident": false,
    "created_by": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "email": "[email protected]" },
    "assigned_to": null,
    "participants": [],
    "description_edited_at": null,
    "can_edit": true,
    "escalated_by": null,
    "created_at": "2026-05-15T09:30:00+00:00",
    "updated_at": "2026-05-16T07:10:00+00:00",
    "closed_at": null,
    "escalated_at": null,
    "messages": [
      {
        "id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
        "author": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]" },
        "body": "Bitte E-Mail nicht öffnen, wir prüfen.",
        "is_internal": false,
        "created_at": "2026-05-16T07:10:00+00:00",
        "edited_at": null,
        "mentioned": [],
        "attachments": []
      }
    ],
    "attachments": []
  }
}
POST /company/tickets/api/<uuid>/reply/ Invia risposta ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/reply/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"body": "Bitte E-Mail nicht öffnen, wir prüfen.", "mentions": []}'
Response
{
  "message_id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
  "message": "Antwort gespeichert."
}
POST /company/tickets/api/<uuid>/status/ Modifica stato ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/status/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"status": "in_bearbeitung"}'
Response
{
  "message": "Status aktualisiert."
}
POST /company/tickets/api/<uuid>/priority/ Modifica priorità ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/priority/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"priority": "kritisch"}'
Response
{
  "message": "Priorität aktualisiert."
}
POST /company/tickets/api/<uuid>/assign/ Assegnare un ticket a una persona (admin; vuoto = rimuovere l'assegnazione) ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/assign/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"assigned_to": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"}'
Response
{
  "changed": true,
  "assigned_to": {
    "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
    "name": "Anna Müller",
    "email": "[email protected]"
  }
}
POST /company/tickets/api/<uuid>/edit/ Modificare titolo/descrizione o un proprio messaggio (con message_id) ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/edit/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Verdächtige E-Mail mit Rechnungsanhang"}'
Response
{
  "changed": ["title"]
}
GET /company/tickets/api/<uuid>/mentionable/ Cercare persone per le menzioni @ (?q=, senza indirizzi e-mail) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/mentionable/?q=an
Response
{
  "results": [
    { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "is_admin": false }
  ]
}
GET /company/tickets/api/dashboard/ Statistiche della dashboard ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/dashboard/
Response
{
  "total_tickets": 46,
  "open_tickets": 3,
  "closed_tickets": 41,
  "serious_incidents": 1,
  "by_category": [
    { "category": "phishing", "category_display": "Phishing-Verdacht", "count": 18 }
  ],
  "by_priority": [
    { "priority": "hoch", "priority_display": "Hoch", "count": 7 }
  ],
  "by_status": [
    { "status": "offen", "status_display": "Offen", "count": 3 }
  ],
  "recent_tickets": [
    {
      "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
      "title": "Verdächtige E-Mail",
      "category": "phishing",
      "category_display": "Phishing-Verdacht",
      "ticket_type": "meldung",
      "type_display": "Meldung",
      "status": "offen",
      "status_display": "Offen",
      "priority": "hoch",
      "priority_display": "Hoch",
      "is_serious_incident": false,
      "created_at": "2026-05-15T09:30:00+00:00",
      "updated_at": "2026-05-16T07:10:00+00:00",
      "message_count": 2
    }
  ]
}

MITRE ATT&CK

2 Endpoints
GET /company/tickets/mitre/api/mobile/ Tattiche con tecniche e copertura tramite ticket e notizie dell'azienda ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/mitre/api/mobile/
Response
{
  "tactics": [
    {
      "tactic_id": "TA0001",
      "name": "Initial Access",
      "technique_count": 1,
      "techniques": [
        { "technique_id": "T1566", "name": "Phishing", "is_subtechnique": false, "ticket_count": 3, "news_count": 12 }
      ]
    }
  ],
  "technique_total": 211,
  "technique_covered": 18
}
GET /company/tickets/mitre/api/mobile/<technique_id>/ Una tecnica con ticket e notizie collegati (al massimo 20 ciascuno) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/mitre/api/mobile/T1566/
Response
{
  "technique_id": "T1566",
  "name": "Phishing",
  "description": "…",
  "is_subtechnique": false,
  "parent_id": "",
  "tactics": ["Initial Access"],
  "assets": ["E-Mail"],
  "tickets": [
    { "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen", "priority": "hoch", "priority_display": "Hoch", "created_at": "2026-05-15T09:30:00+00:00" }
  ],
  "news": [
    { "id": "4812", "title": "Neue Phishing-Welle gegen KMU", "url": "https://www.ncsc.admin.ch/…", "published_at": "2026-05-14T06:00:00+00:00" }
  ]
}

War Rooms

6 Endpoints
GET /company/tickets/api/warrooms/ Elenca le war room ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/warrooms/?status=aktiv
Response
{
  "warrooms": [
    {
      "id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
      "title": "Ransomware-Vorfall",
      "description": "Fileserver FS01 verschlüsselt.",
      "status": "aktiv",
      "status_display": "Aktiv",
      "external_link": "",
      "external_link_label": "Video-Call",
      "participant_count": 5,
      "message_count": 12,
      "created_at": "2026-05-16T09:00:00+00:00",
      "closed_at": null
    }
  ]
}
POST /company/tickets/api/warrooms/create/ Crea war room ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Ransomware-Vorfall", "description": "Fileserver FS01 verschlüsselt.", "external_link": "", "external_link_label": "Video-Call"}'
Response
{
  "id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
  "title": "Ransomware-Vorfall",
  "description": "Fileserver FS01 verschlüsselt.",
  "status": "aktiv",
  "status_display": "Aktiv",
  "external_link": "",
  "external_link_label": "Video-Call",
  "participant_count": 1,
  "message_count": 0,
  "created_at": "2026-05-16T09:00:00+00:00",
  "closed_at": null
}
GET /company/tickets/api/warrooms/<uuid>/ Dettaglio war room ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/
Response
{
  "id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
  "title": "Ransomware-Vorfall",
  "description": "Fileserver FS01 verschlüsselt.",
  "status": "aktiv",
  "status_display": "Aktiv",
  "external_link": "",
  "external_link_label": "Video-Call",
  "participants": [
    { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "initials": "MM", "is_admin": true }
  ],
  "tickets": [
    { "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen" }
  ],
  "playbooks": [
    { "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response" }
  ],
  "messages": [
    {
      "id": 501,
      "author_id": 42,
      "author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "author_name": "Max Muster",
      "author_initials": "MM",
      "author_avatar_url": "",
      "body": "Systeme isoliert.",
      "created_at": "16.05.2026 10:00",
      "created_at_iso": "2026-05-16T10:00:00+00:00",
      "attachments": []
    }
  ],
  "created_at": "2026-05-16T09:00:00+00:00",
  "closed_at": null
}
GET /company/tickets/warroom/<uuid>/api/messages/ Recupera messaggi (polling) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/messages/?after=500
Response
{
  "messages": [
    {
      "id": 501,
      "author_id": 42,
      "author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "author_name": "Max Muster",
      "author_initials": "MM",
      "author_avatar_url": "",
      "body": "Systeme isoliert.",
      "created_at": "16.05.2026 10:00",
      "attachments": []
    }
  ]
}
POST /company/tickets/warroom/<uuid>/api/send/ Invia messaggio ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/send/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"body": "Backups werden geprüft."}'
Response
{
  "id": 502,
  "author_id": 42,
  "author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
  "author_name": "Max Muster",
  "author_initials": "MM",
  "author_avatar_url": "",
  "body": "Backups werden geprüft.",
  "created_at": "16.05.2026 10:05",
  "attachments": []
}
GET/POST /company/tickets/api/warrooms/<uuid>/participants/ Leggere, invitare o rimuovere partecipanti ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/participants/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"add": ["c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"], "remove": [], "add_groups": []}'
Response
{
  "participants": [
    {
      "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "name": "Max Muster",
      "initials": "MM",
      "is_admin": true
    }
  ],
  "employees": [
    {
      "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "name": "Max Muster",
      "initials": "MM",
      "is_admin": true,
      "is_participant": true,
      "group_ids": ["b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01"]
    }
  ],
  "groups": [
    { "id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01", "name": "Werkstatt" }
  ],
  "can_manage": true
}

Monitoraggio del Dark Web

4 Endpoints
GET /company/tickets/api/darkweb/ Panoramica delle scansioni ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/darkweb/
Response
{
  "scans": [
    {
      "id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
      "domain": "murmelibach-ag.ch",
      "total_credentials": 7,
      "unique_emails": 5,
      "breach_count": 3,
      "has_plaintext_pw": true,
      "risk_level": "high",
      "sources_queried": "Dehashed, HIBP, LeakCheck",
      "created_at": "2026-05-15T02:00:00+00:00"
    }
  ]
}
POST /company/tickets/api/darkweb/scan/ Avvia scansione (solo domini verificati) ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/darkweb/scan/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"domain": "murmelibach-ag.ch", "run_dehashed": true, "run_hibp": true, "run_leakcheck": true}'
Response
{
  "id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
  "domain": "murmelibach-ag.ch"
}
GET /company/tickets/api/darkweb/<uuid>/ Dettaglio scansione ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/darkweb/7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e/
Response
{
  "id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
  "domain": "murmelibach-ag.ch",
  "total_credentials": 7,
  "unique_emails": 5,
  "breach_count": 3,
  "has_plaintext_pw": true,
  "risk_level": "high",
  "sources_queried": "Dehashed, HIBP, LeakCheck",
  "created_at": "2026-05-15T02:00:00+00:00",
  "stats": { "dehashed_count": 4, "hibp_count": 3, "leakcheck_count": 3 },
  "findings": [
    {
      "source": "Dehashed",
      "email": "[email protected]",
      "username": "",
      "password": "Sommer2024!",
      "hashed_password": "",
      "name": "",
      "database": "combolist-2025",
      "url": ""
    }
  ],
  "findings_total": 7,
  "breaches": [
    {
      "name": "ExampleBreach2024",
      "date": "2024-11-02",
      "pwn_count": 1420000,
      "data_classes": ["Email addresses", "Passwords"],
      "description": "…",
      "domain": "example.com"
    }
  ]
}
GET /company/tickets/api/darkweb/domains/ Domini aziendali per la scansione ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/darkweb/domains/
Response
{
  "domains": [
    {
      "domain": "murmelibach-ag.ch",
      "is_primary": true,
      "is_verified": true
    }
  ]
}

Analisi di phishing (EML)

2 Endpoints
POST /company/tickets/analysis/api/upload/ Carica file EML ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/analysis/api/upload/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -F "[email protected]"
Response
{
  "analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
  "detail_url": "https://cybertell.io/company/tickets/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/",
  "message": "E-Mail erfolgreich analysiert."
}
GET /company/tickets/analysis/api/list/ Elenco analisi ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/analysis/api/list/
Response
{
  "analyses": [
    {
      "id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
      "subject": "Ihr Konto wurde gesperrt",
      "sender": "[email protected]",
      "risk_score": 85,
      "vt_status": "done",
      "ai_status": "done",
      "created_at": "2026-05-15T18:20:00+00:00"
    }
  ]
}

Plugin Mail (indicatori di phishing)

3 Endpoints

API 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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/mail-plugin/indicators/?since=2026-05-01T00:00:00Z
Response
{
  "indicators": [
    {
      "id": 12,
      "type": "sender_domain",
      "value": "paypa1.com",
      "risk_level": "high",
      "description": "Gefälschter Absender",
      "analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
      "hit_count": 3,
      "created_at": "2026-05-15T18:25:00+00:00",
      "expires_at": null
    }
  ],
  "count": 1,
  "last_updated": "2026-05-16T08:00:00+00:00"
}
POST /company/tickets/api/mail-plugin/check/ Verifica l'e-mail rispetto agli indicatori ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/mail-plugin/check/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"sender": "[email protected]", "subject": "Konto gesperrt", "urls": ["https://paypa1.com/login"]}'
Response
{
  "is_phishing": true,
  "risk_level": "high",
  "matches": [
    { "type": "sender_domain", "value": "paypa1.com", "risk_level": "high", "analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13" }
  ],
  "analysis_url": "https://cybertell.io/company/tickets/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/"
}
GET /company/tickets/api/mail-plugin/analysis/<uuid>/ Dettaglio analisi per il popup ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/mail-plugin/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/
Response
{
  "id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
  "sender": "[email protected]",
  "subject": "Ihr Konto wurde gesperrt",
  "risk_score": 85,
  "risk_label": "Hoch",
  "spf": "fail",
  "dkim": "none",
  "dmarc": "fail",
  "malicious_urls": ["https://paypa1.com/login"],
  "ai_category": "Phishing",
  "ai_assessment": "KATEGORIE: Phishing\n- Domain 2 Tage alt\nEMPFEHLUNG: Nicht öffnen.",
  "ai_indicators": ["Domain 2 Tage alt"],
  "ai_recommendation": "Nicht öffnen.",
  "analysed_at": "2026-05-15T18:20:00+00:00",
  "analysed_by": "Max Muster"
}

Video di awareness

7 Endpoints
GET /company/videos/api/list/ Elenco video ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/videos/api/list/
Response
{
  "videos": [
    {
      "id": "e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24",
      "title": "Phishing in 90 Sekunden",
      "language": "de",
      "status": "completed",
      "status_display": "Fertig",
      "slide_count": 8,
      "duration_seconds": 92,
      "render_progress": 100,
      "source": "generated",
      "completed_by_me": false,
      "release_status": "publiziert",
      "release_status_display": "Publiziert",
      "is_published": true,
      "is_current": true,
      "valid_from": null,
      "valid_until": null,
      "created_at": "2026-05-10T09:00:00+00:00"
    }
  ]
}
POST /company/videos/api/generate/ Genera video di awareness (IA; opzionali: tone, address_form, length_preset, slide_count, style_template, setting, tts_voice, tts_speed) ▶
Request
curl -X POST https://portal.cybertell.io/company/videos/api/generate/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Sicheres Homeoffice", "language": "de", "enable_tts": false, "video_format": "landscape", "extra_notes": ""}'
Response
{
  "job_id": "f7b9d1e3-5d7a-4f02-9c38-4e6a8b0d2f35",
  "status": "generating"
}
GET /company/videos/api/<uuid>/ Dettaglio del video con le diapositive ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/
Response
{
  "id": "e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24",
  "title": "Phishing in 90 Sekunden",
  "extra_notes": "",
  "language": "de",
  "video_format": "landscape",
  "status": "completed",
  "status_display": "Fertig",
  "slide_count": 8,
  "duration_seconds": 92,
  "render_progress": 100,
  "render_error": "",
  "enable_tts": false,
  "has_video": true,
  "video_url": "/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/",
  "source": "generated",
  "completed_by_me": false,
  "release_status": "publiziert",
  "release_status_display": "Publiziert",
  "is_published": true,
  "is_current": true,
  "valid_from": null,
  "valid_until": null,
  "created_at": "2026-05-10T09:00:00+00:00",
  "slides": [
    {
      "id": "0b2d4f68-1a3c-4e75-9b18-5d7f9a1c3e60",
      "order": 1,
      "slide_type": "intro",
      "title": "Was ist Phishing?",
      "bullets": ["Gefälschter Absender", "Zeitdruck"],
      "speaker_notes": "",
      "narration": "",
      "illustration_key": "mail",
      "duration_sec": 12
    }
  ]
}
POST /company/videos/api/<uuid>/render/ Riavviare il rendering ▶
Request
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/render/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "status": "rendering",
  "phase": "waiting",
  "position": 1,
  "status_display": "In Warteschlange"
}
GET /company/videos/api/<uuid>/video/ Scaricare l’MP4 per il player ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o awareness.mp4 https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/
Response
HTTP/1.1 200 OK
Content-Type: video/mp4
Accept-Ranges: bytes
Content-Length: 4821004

<MP4-Datenstrom>
POST/DEL /company/videos/api/<uuid>/delete/ Eliminare il video ▶
Request
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/delete/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "status": "deleted"
}
POST /company/videos/api/<uuid>/progress/ Segnalare i secondi visti (rilevamento del completamento) ▶
Request
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/progress/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"watched": 73, "duration": 92, "ended": false}'
Response
{
  "progress_pct": 79,
  "completed": false
}

Registro degli asset

5 Endpoints

Lettura 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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/assets/api/list/
Response
{
  "assets": [
    {
      "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
      "name": "Fileserver FS01",
      "asset_type": "system",
      "asset_type_display": "System / Server",
      "status": "active",
      "status_display": "Aktiv",
      "criticality": "high",
      "criticality_display": "Hoch",
      "confidentiality": "high",
      "integrity": "medium",
      "availability": "high",
      "owner_name": "Max Muster",
      "owner_email": "[email protected]",
      "supplier": {
        "id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
        "name": "Wolkensoftware Eidgenossenschaft"
      },
      "status_page_url": "",
      "provider_status": {
        "state": "degraded",
        "label": "Beeinträchtigt",
        "summary": "Verzögerte Zustellung",
        "disrupted": true,
        "since": "2026-05-02T09:40:00+00:00",
        "checked_at": "2026-05-02T10:00:00+00:00"
      },
      "renews_on": "2027-01-31",
      "renewal_state": "ok",
      "auto_renew": true,
      "payment_method": "invoice",
      "payment_method_display": "Rechnung",
      "risk_count": 2,
      "updated_at": "2026-05-02T10:00:00+00:00"
    }
  ]
}
POST /company/assets/api/create/ Crea asset ▶
Request
curl -X POST https://portal.cybertell.io/company/assets/api/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Fileserver FS01", "asset_type": "system", "criticality": "high", "supplier": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "owner_email": "[email protected]"}'
Response
{
  "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
  "name": "Fileserver FS01"
}
GET/PATCH/PUT/DEL /company/assets/api/<uuid>/ Dettaglio asset ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
Response
{
  "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
  "name": "Fileserver FS01",
  "asset_type": "system",
  "asset_type_display": "System / Server",
  "status": "active",
  "status_display": "Aktiv",
  "criticality": "high",
  "criticality_display": "Hoch",
  "confidentiality": "high",
  "integrity": "medium",
  "availability": "high",
  "owner_name": "Max Muster",
  "owner_email": "[email protected]",
  "supplier": {
    "id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
    "name": "Wolkensoftware Eidgenossenschaft"
  },
  "status_page_url": "",
  "provider_status": {
    "state": "degraded",
    "label": "Beeinträchtigt",
    "summary": "Verzögerte Zustellung",
    "disrupted": true,
    "since": "2026-05-02T09:40:00+00:00",
    "checked_at": "2026-05-02T10:00:00+00:00"
  },
  "renews_on": "2027-01-31",
  "renewal_state": "ok",
  "auto_renew": true,
  "payment_method": "invoice",
  "payment_method_display": "Rechnung",
  "description": "Zentraler Dateiserver",
  "notes": "",
  "renewal_cycle": "yearly",
  "renewal_cycle_display": "Jährlich",
  "payment_note": "",
  "provider_account": "",
  "risks": [],
  "updated_at": "2026-05-02T10:00:00+00:00"
}
GET/POST /company/assets/api/<uuid>/risks/ Elencare o creare i rischi di un asset ▶
Request
curl -X POST https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/risks/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Ausfall Rechenzentrum", "likelihood": 2, "impact": 4, "target_likelihood": 1, "target_impact": 4, "contingency": "Failover ausl\u00f6sen"}'
Response
{
  "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "asset_id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
  "title": "Ausfall Rechenzentrum",
  "threat": "Stromausfall",
  "vulnerability": "Kein Zweitstandort",
  "likelihood": 2,
  "impact": 4,
  "risk_score": 8,
  "risk_level": "high",
  "target_likelihood": 1,
  "target_impact": 4,
  "target_score": 4,
  "target_level": "medium",
  "status": "assessed",
  "treatment": "Replikation ins Zweit-RZ",
  "contingency": "Failover auslösen",
  "accepted": false,
  "accepted_by": "",
  "accepted_at": null,
  "accepted_justification": "",
  "review_date": "2027-03-31",
  "ai_generated": false,
  "updated_at": "2026-05-02T10:00:00+00:00"
}
GET/PATCH/DEL /company/assets/api/risks/<uuid>/ Leggere, modificare o eliminare un rischio; accepted: true lo accetta ▶
Request
curl -X PATCH https://portal.cybertell.io/company/assets/api/risks/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"accepted": true, "accepted_justification": "Kosten stehen in keinem Verh\u00e4ltnis"}'
Response
{
  "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "asset_id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
  "title": "Ausfall Rechenzentrum",
  "threat": "Stromausfall",
  "vulnerability": "Kein Zweitstandort",
  "likelihood": 2,
  "impact": 4,
  "risk_score": 8,
  "risk_level": "high",
  "target_likelihood": 1,
  "target_impact": 4,
  "target_score": 4,
  "target_level": "medium",
  "status": "assessed",
  "treatment": "Replikation ins Zweit-RZ",
  "contingency": "Failover auslösen",
  "accepted": false,
  "accepted_by": "",
  "accepted_at": null,
  "accepted_justification": "",
  "review_date": "2027-03-31",
  "ai_generated": false,
  "updated_at": "2026-05-02T10:00:00+00:00"
}

Terze parti (fornitori)

3 Endpoints

Lettura con il modulo abilitato sulla chiave; creazione, modifica ed eliminazione solo per gli amministratori dell’azienda.

GET /company/suppliers/api/list/ Elenca i fornitori ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/suppliers/api/list/
Response
{
  "suppliers": [
    {
      "id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
      "name": "Wolkensoftware Eidgenossenschaft",
      "category": "cloud_saas",
      "category_display": "Cloud / SaaS",
      "status": "active",
      "status_display": "Aktiv",
      "risk_level": "high",
      "likelihood": 3,
      "impact": 4,
      "risk_score": 12,
      "ai_risk_level": "",
      "country_code": "ch",
      "website": "https://wolkensoftware.example",
      "contact_name": "Erika Muster",
      "contact_email": "[email protected]",
      "data_access": true,
      "system_access": false,
      "status_page_url": "https://status.wolkensoftware.example",
      "status_sources": [
        "https://status.wolkensoftware.example/history.rss"
      ],
      "provider_status": {
        "state": "degraded",
        "label": "Beeinträchtigt",
        "summary": "Verzögerte Zustellung",
        "disrupted": true,
        "since": "2026-05-02T09:40:00+00:00",
        "checked_at": "2026-05-02T10:00:00+00:00"
      },
      "sla": {
        "target": 99.9,
        "claim_days": 30
      },
      "document_count": 1,
      "created_at": "2026-02-01T09:00:00+00:00",
      "updated_at": "2026-05-02T10:00:00+00:00"
    }
  ]
}
POST /company/suppliers/api/create/ Crea fornitore ▶
Request
curl -X POST https://portal.cybertell.io/company/suppliers/api/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Wolkensoftware Eidgenossenschaft", "category": "cloud_saas", "risk_level": "high", "likelihood": 3, "impact": 4, "contingency": "Zweitanbieter aktivieren", "status_page_url": "https://status.wolkensoftware.example", "status_sources": ["https://status.wolkensoftware.example/history.rss"], "data_access": true, "sla_target": 99.9, "sla_claim_days": 30}'
Response
{
  "id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
  "name": "Wolkensoftware Eidgenossenschaft"
}
GET/PATCH/PUT/DEL /company/suppliers/api/<uuid>/ Dettaglio fornitore ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/suppliers/api/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/
Response
{
  "id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
  "name": "Wolkensoftware Eidgenossenschaft",
  "category": "cloud_saas",
  "category_display": "Cloud / SaaS",
  "status": "active",
  "status_display": "Aktiv",
  "risk_level": "high",
  "likelihood": 3,
  "impact": 4,
  "risk_score": 12,
  "ai_risk_level": "",
  "country_code": "ch",
  "website": "https://wolkensoftware.example",
  "contact_name": "Erika Muster",
  "contact_email": "[email protected]",
  "data_access": true,
  "system_access": false,
  "status_page_url": "https://status.wolkensoftware.example",
  "status_sources": [
    "https://status.wolkensoftware.example/history.rss"
  ],
  "provider_status": {
    "state": "degraded",
    "label": "Beeinträchtigt",
    "summary": "Verzögerte Zustellung",
    "disrupted": true,
    "since": "2026-05-02T09:40:00+00:00",
    "checked_at": "2026-05-02T10:00:00+00:00"
  },
  "sla": {
    "target": 99.9,
    "claim_days": 30
  },
  "document_count": 1,
  "contact_phone": "",
  "language": "de",
  "description": "Mail und Ablage",
  "notes": "",
  "contingency": "Zweitanbieter aktivieren, Kunden informieren",
  "ai_risk_analysis": "",
  "backup_strategy": "Tägliche Sicherung im Zweit-RZ",
  "backup_last_tested_at": "2026-10-01",
  "backup_test_result": "Rücksicherung in 2 h",
  "documents": [],
  "compliance_requests": [],
  "assets": [
    {
      "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
      "name": "Fileserver FS01"
    }
  ],
  "sla_breaches": [
    {
      "id": "8c1e3a57-9d2b-4f60-a8e4-2b7d5c9f1a36",
      "month": "2026-10",
      "target": 99.9,
      "achieved": 99.583,
      "outage_minutes": 180,
      "claim_deadline": "2026-11-30",
      "claim_sent_at": null
    }
  ],
  "created_at": "2026-02-01T09:00:00+00:00",
  "updated_at": "2026-05-02T10:00:00+00:00"
}

Valutazione ICT

7 Endpoints

Lettura 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) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/list/
Response
{
  "assessments": [
    {
      "id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
      "title": "IKT-Minimalstandard 2026",
      "version": "1.0",
      "standard_slug": "ikt",
      "standard_name": "IKT-Minimalstandard",
      "rating_max": 4,
      "overall_score": 2.1,
      "completion_percent": 40,
      "maturity_label": "Wiederholbar",
      "created_at": "2026-04-02T10:00:00+00:00",
      "created_by": "Max Muster",
      "is_auto": false,
      "read_only": false
    }
  ]
}
GET /company/ict/api/catalog/ Catalogo dei requisiti di uno standard (funzioni, categorie, requisiti; ?standard=ikt|isms|vvt|tom|din27076|nistcsf2) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/catalog/?standard=ikt
Response
{
  "standard_slug": "ikt",
  "standard_name": "IKT-Minimalstandard",
  "rating_max": 4,
  "rating_choices": [
    { "value": "na", "label": "Nicht anwendbar" },
    { "value": "0", "label": "0 – Nicht umgesetzt" }
  ],
  "functions": [
    {
      "code": "ID",
      "short_code": "ID",
      "name": "Identifizieren",
      "description": "…",
      "categories": [
        {
          "code": "ID.AM",
          "short_code": "AM",
          "name": "Asset Management",
          "items": [
            {
              "id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
              "uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
              "code": "ID.AM-1",
              "title": "Inventar der Geräte",
              "description": "…",
              "priority": 1
            }
          ]
        }
      ]
    }
  ]
}
POST /company/ict/api/new/ Crea valutazione ▶
Request
curl -X POST https://portal.cybertell.io/company/ict/api/new/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"standard": "ikt", "title": "IKT-Minimalstandard 2026"}'
Response
{
  "id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
  "prefilled": 0,
  "title": "IKT-Minimalstandard 2026",
  "version": "1.0",
  "standard_slug": "ikt"
}
GET/DEL /company/ict/api/<uuid>/ Dettaglio valutazione ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/
Response
{
  "id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
  "title": "IKT-Minimalstandard 2026",
  "version": "1.0",
  "standard_slug": "ikt",
  "rating_max": 4,
  "overall_score": 2.1,
  "completion_percent": 40,
  "maturity_label": "Wiederholbar",
  "is_complete": false,
  "is_auto": false,
  "read_only": false,
  "created_at": "2026-04-02T10:00:00+00:00",
  "functions": [
    {
      "code": "ID",
      "short_code": "ID",
      "name": "Identifizieren",
      "description": "…",
      "score": 2.4,
      "categories": [
        {
          "code": "ID.AM",
          "short_code": "AM",
          "name": "Asset Management",
          "score": 2.0,
          "items": [
            {
              "id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
              "uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
              "code": "ID.AM-1",
              "title": "Inventar der Geräte",
              "priority": 1,
              "rating": "3",
              "comment": "Inventar in Asset-Register"
            }
          ]
        }
      ]
    }
  ]
}
POST /company/ict/api/<uuid>/save-response/ Salva risposta ▶
Request
curl -X POST https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/save-response/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"item_id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20", "rating": "3", "comment": "MFA aktiv"}'
Response
{
  "ok": true,
  "completion_percent": 42,
  "overall_score": 2.2,
  "review_status": "",
  "transferred": []
}
GET /company/ict/api/standards/ Standard di conformità disponibili ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/standards/
Response
{
  "standards": [
    {
      "slug": "ikt",
      "name": "IKT-Minimalstandard",
      "description": "Bundesamt für wirtschaftliche Landesversorgung",
      "rating_max": 4,
      "is_status_scale": false
    }
  ]
}
GET /company/ict/api/<uuid>/pdf/ Rapporto di conformità in PDF ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o compliance-report.pdf https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="compliance-report.pdf"

%PDF-1.7 …

Valutazione AD

3 Endpoints

Lettura 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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ad/api/list/
Response
{
  "dumps": [
    {
      "id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
      "filename": "ad_dump.json",
      "status": "analysed",
      "risk_score": 62,
      "risk_level": "Hoch",
      "risk_color": "warning",
      "user_count": 140,
      "computer_count": 96,
      "has_ai_recommendations": true,
      "created_at": "2026-05-10T09:00:00+00:00",
      "uploaded_by": "Max Muster"
    }
  ]
}
POST /company/ad/api/upload/ Carica dump AD ▶
Request
curl -X POST https://portal.cybertell.io/company/ad/api/upload/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -F "dump_file=@ad_dump.json"
Response
{
  "id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
  "status": "analysed"
}
GET /company/ad/api/<uuid>/ Dettaglio dump ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ad/api/3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74/
Response
{
  "id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
  "filename": "ad_dump.json",
  "status": "analysed",
  "risk_score": 62,
  "risk_level": "Hoch",
  "risk_color": "warning",
  "ai_recommendations": "…",
  "user_count": 140,
  "computer_count": 96,
  "group_count": 31,
  "risks": [
    { "severity": "high", "title": "Kerberoastable accounts" }
  ],
  "password_policy": { "min_length": 8 },
  "domain_info": { "name": "murmelibach.local" },
  "created_at": "2026-05-10T09:00:00+00:00"
}

Assessment Microsoft 365

3 Endpoints

Lettura 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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/azure/api/list/
Response
{
  "dumps": [
    {
      "id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
      "filename": "azure_export.json",
      "status": "analysed",
      "risk_score": 45,
      "risk_level": "Mittel",
      "risk_color": "warning",
      "user_count": 140,
      "has_ai_recommendations": true,
      "created_at": "2026-05-10T09:00:00+00:00",
      "uploaded_by": "Max Muster"
    }
  ]
}
POST /company/azure/api/upload/ Carica dump Azure ▶
Request
curl -X POST https://portal.cybertell.io/company/azure/api/upload/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -F "dump_file=@azure_export.json"
Response
{
  "id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
  "status": "analysed"
}
GET /company/azure/api/<uuid>/ Dettaglio dump ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/azure/api/2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60/
Response
{
  "id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
  "filename": "azure_export.json",
  "status": "analysed",
  "risk_score": 45,
  "risk_level": "Mittel",
  "risk_color": "warning",
  "ai_recommendations": "…",
  "user_count": 140,
  "role_count": 12,
  "app_count": 27,
  "risks": [
    { "severity": "medium", "title": "Legacy auth aktiv" }
  ],
  "security_defaults": { "enabled": false },
  "conditional_access": [],
  "checks": [
    { "id": "M365.AAD.02", "workload": "entra", "status": "fail", "severity": "critical", "title": "Conditional-Access-Richtlinie vorhanden", "evidence": "…", "fix": "…", "refs": ["CIS 5.2.2.1"] }
  ],
  "workloads": [
    { "key": "entra", "label": "Entra ID", "collected": true, "skip_reason": "", "passed": 18, "failed": 4, "skipped": 0 }
  ],
  "created_at": "2026-05-10T09:00:00+00:00"
}

Gestione dei rischi

2 Endpoints
GET /company/risk/api/list/ Elenca i rischi ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/risk/api/list/
Response
{
  "risks": [
    {
      "id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
      "title": "Ransomware",
      "category": "technical",
      "category_display": "Technisch",
      "likelihood": 3,
      "impact": 4,
      "risk_score": 12,
      "risk_level": "high",
      "risk_level_display": "Hoch",
      "target_likelihood": 1,
      "target_impact": 4,
      "target_score": 4,
      "target_level": "medium",
      "treatment": "Offline-Backups einführen",
      "treatment_display": "Offline-Backups einführen",
      "owner": "Max Muster",
      "updated_at": "2026-05-02T10:00:00+00:00"
    }
  ]
}
POST /company/risk/api/create/ Crea rischio ▶
Request
curl -X POST https://portal.cybertell.io/company/risk/api/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Ransomware", "category": "technical", "threat": "Verschlüsselung", "vulnerability": "Kein Offline-Backup", "likelihood": 3, "impact": 4, "target_likelihood": 1, "target_impact": 4, "owner": "Max Muster", "treatment": "Offline-Backups einführen"}'
Response
{
  "id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
  "title": "Ransomware",
  "target_likelihood": 1,
  "target_impact": 4,
  "target_score": 4,
  "target_level": "medium"
}

Dipendenze e interruzione

16 Endpoints

Lettura 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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/mobile/
Response
{
  "node_count": 14,
  "edge_count": 22,
  "process_count": 5,
  "spof": [],
  "scenarios": []
}
GET /company/data-flows/api/map/ Mappa: tutti i nodi, flussi e gruppi ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/map/
Response
{
  "nodes": [
    {
      "id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
      "uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
      "kind": "supplier",
      "label": "Hosting AG",
      "criticality": "high"
    }
  ],
  "edges": [
    {
      "uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
      "source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
      "target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
      "flow_type": "service",
      "direction": "forward",
      "is_redundant": false,
      "impacts_target": true,
      "impacts_source": false,
      "data_categories": [
        "customer"
      ],
      "description": "Hosting des Shops"
    }
  ],
  "groups": [
    {
      "id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
      "uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
      "name": "Hosting",
      "nodes": [
        "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
      ]
    }
  ]
}
POST /company/data-flows/api/nodes/ Mettere sulla mappa un fornitore, un asset o un processo (idempotente) ▶
Request
curl -X POST https://portal.cybertell.io/company/data-flows/api/nodes/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82"}'
Response
{
  "ok": true,
  "node": {
    "id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
    "uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
    "kind": "supplier",
    "label": "Hosting AG",
    "criticality": "high"
  }
}
DEL /company/data-flows/api/nodes/<uuid>/ Togliere un nodo e i suoi flussi dalla mappa; fornitore, asset o processo restano ▶
Request
curl -X DELETE https://portal.cybertell.io/company/data-flows/api/nodes/5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…"
Response
{
  "ok": true
}
POST /company/data-flows/api/edges/ Creare un flusso tra due nodi ▶
Request
curl -X POST https://portal.cybertell.io/company/data-flows/api/edges/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"source": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26", "target": "8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20", "flow_type": "service", "data_categories": ["customer"]}'
Response
{
  "ok": true,
  "edge": {
    "uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
    "source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
    "target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
    "flow_type": "service",
    "direction": "forward",
    "is_redundant": false,
    "impacts_target": true,
    "impacts_source": false,
    "data_categories": [
      "customer"
    ],
    "description": "Hosting des Shops"
  }
}
PATCH/DEL /company/data-flows/api/edges/<uuid>/ Modificare un flusso (solo i campi inviati) o eliminarlo ▶
Request
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/edges/9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"is_redundant": true}'
Response
{
  "ok": true,
  "edge": {
    "uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
    "source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
    "target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
    "flow_type": "service",
    "direction": "forward",
    "is_redundant": false,
    "impacts_target": true,
    "impacts_source": false,
    "data_categories": [
      "customer"
    ],
    "description": "Hosting des Shops"
  }
}
GET/POST /company/data-flows/api/processes/ Elencare o creare processi aziendali (subito sulla mappa) ▶
Request
curl -X POST https://portal.cybertell.io/company/data-flows/api/processes/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Auftragsabwicklung", "criticality": "high", "rto_hours": 8, "mtpd_hours": 24}'
Response
{
  "process": {
    "uuid": "2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82",
    "name": "Auftragsabwicklung",
    "description": "",
    "criticality": "high",
    "rto_hours": 8,
    "mtpd_hours": 24,
    "rpo_hours": 4,
    "owner_email": "[email protected]"
  }
}
GET/PATCH/DEL /company/data-flows/api/processes/<uuid>/ Leggere, modificare o eliminare un processo aziendale ▶
Request
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/processes/2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"rpo_hours": 4}'
Response
{
  "process": {
    "uuid": "2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82",
    "name": "Auftragsabwicklung",
    "description": "",
    "criticality": "high",
    "rto_hours": 8,
    "mtpd_hours": 24,
    "rpo_hours": 4,
    "owner_email": "[email protected]"
  }
}
GET/POST /company/data-flows/api/groups/ Elencare o creare gruppi ▶
Request
curl -X POST https://portal.cybertell.io/company/data-flows/api/groups/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Hosting", "nodes": ["5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"]}'
Response
{
  "ok": true,
  "group": {
    "id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
    "uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
    "name": "Hosting",
    "nodes": [
      "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
    ]
  }
}
GET/PATCH/DEL /company/data-flows/api/groups/<uuid>/ Rinominare un gruppo, impostare (nodes), aggiungere (add) o togliere (remove) nodi, o eliminare il gruppo ▶
Request
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/groups/4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"add": ["8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20"]}'
Response
{
  "ok": true,
  "group": {
    "id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
    "uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
    "name": "Hosting",
    "nodes": [
      "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
    ]
  }
}
POST /company/data-flows/api/simulation/ Simulare un’interruzione senza salvare nulla (innesco per nodo o per fornitore, asset, processo) ▶
Request
curl -X POST https://portal.cybertell.io/company/data-flows/api/simulation/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "outage_hours": 24}'
Response
{
  "ok": true,
  "outage_hours": 24,
  "counts": {
    "total": 2,
    "critical": 1,
    "high": 1,
    "mtpd_breached": 0,
    "rto_breached": 1
  },
  "affected": [
    {
      "id": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
      "label": "Auftragsabwicklung",
      "kind": "process",
      "via_rule": "single",
      "via_source_label": "Hosting AG"
    }
  ],
  "processes": [
    {
      "label": "Auftragsabwicklung",
      "rto": 8,
      "mtpd": 24,
      "rto_breached": true
    }
  ],
  "affected_edges": [
    "e_9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47"
  ]
}
GET/POST /company/data-flows/api/scenarios/ Elencare gli scenari salvati o salvare una simulazione come scenario ▶
Request
curl -X POST https://portal.cybertell.io/company/data-flows/api/scenarios/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "outage_hours": 24, "name": "Hoster 24 h weg"}'
Response
{
  "ok": true,
  "scenario": {
    "uuid": "2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81",
    "name": "Hoster 24 h weg",
    "trigger_label": "Hosting AG",
    "trigger_kind": "supplier",
    "trigger_node": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
    "outage_hours": 24,
    "counts": {
      "total": 2,
      "mtpd_breached": 0
    },
    "has_assessment": false,
    "result": {},
    "ai_assessment": "",
    "ai_assessed_at": null,
    "created_at": "2026-05-14T10:00:00+00:00"
  }
}
GET/DEL /company/data-flows/api/scenarios/<uuid>/ Leggere uno scenario con il risultato o eliminarlo ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/scenarios/2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81/
Response
{
  "ok": true,
  "scenario": {
    "uuid": "2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81",
    "name": "Hoster 24 h weg",
    "trigger_label": "Hosting AG",
    "trigger_kind": "supplier",
    "trigger_node": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
    "outage_hours": 24,
    "counts": {
      "total": 2,
      "mtpd_breached": 0
    },
    "has_assessment": false,
    "result": {},
    "ai_assessment": "",
    "ai_assessed_at": null,
    "created_at": "2026-05-14T10:00:00+00:00"
  }
}
GET /company/data-flows/api/status/ Stato delle pagine di stato per nodo ed effetto dei disservizi in corso ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/status/
Response
{
  "ok": true,
  "nodes": [
    {
      "id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
      "url": "https://status.hosting.example",
      "state": "outage",
      "label": "Ausfall",
      "tone": "critical",
      "summary": "Rechenzentrum offline",
      "since": "2026-05-14T09:12:00+00:00",
      "disrupted": true
    }
  ],
  "impact": {
    "total": 2,
    "processes": [
      "Auftragsabwicklung"
    ],
    "affected": [
      "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20"
    ],
    "edges": [
      "e_9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47"
    ]
  }
}
GET /company/data-flows/api/outages/ Cronologia dei disservizi dei fornitori, i più recenti prima; ?open=1 solo quelli in corso ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/data-flows/api/outages/
Response
{
  "outages": [
    {
      "url": "https://status.hosting.example",
      "source": "Hosting AG Status",
      "state": "outage",
      "label": "Ausfall",
      "summary": "Rechenzentrum offline",
      "started_at": "2026-05-14T09:12:00+00:00",
      "ended_at": null,
      "open": true,
      "duration_minutes": null,
      "affected": [
        "Hosting AG"
      ]
    }
  ]
}
GET/PUT /company/data-flows/api/layout/ Leggere e impostare la posizione dei nodi ▶
Request
curl -X PUT https://portal.cybertell.io/company/data-flows/api/layout/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"positions": {"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26": {"x": 0, "y": 160}}}'
Response
{
  "ok": true,
  "updated": 1
}

Backup e ripristino

1 Endpoint
GET /company/backups/api/mobile/ Piani di backup con test di ripristino e asset non protetti ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/backups/api/mobile/
Response
{
  "is_admin": true,
  "kpi": {
    "active": 1,
    "tests_overdue": 0,
    "not_resilient": 0,
    "unprotected": 1,
    "exempted": 0
  },
  "plans": [
    {
      "id": "3b5d7f91-2c4e-4a68-8d0b-1f3a5c7e9b02",
      "name": "Fileserver täglich",
      "scope": "Alle Freigaben",
      "status": "active",
      "status_display": "Aktiv",
      "frequency": "daily",
      "frequency_display": "Täglich",
      "weekdays": [],
      "schedule_display": "Täglich",
      "location": "cloud",
      "location_display": "Cloud",
      "location_detail": "",
      "tool": "Veeam",
      "template_key": "",
      "retention_days": 30,
      "rpo_hours": 24,
      "rpo_gap": false,
      "has_offline_copy": true,
      "is_immutable": false,
      "is_encrypted": true,
      "is_monitored": true,
      "is_ransomware_resilient": true,
      "owner": "Alma Admin",
      "test_interval_months": 6,
      "next_test_due": "2026-11-12",
      "test_overdue": false,
      "asset_names": ["Fileserver"],
      "tips": [],
      "tests": [
        {
          "id": "9e1a3c5b-7d2f-4b46-8a80-2c4e6f8a0b13",
          "tested_on": "2026-05-12",
          "scope": "file",
          "scope_display": "Einzelne Dateien",
          "result": "success",
          "result_display": "Erfolgreich",
          "duration_minutes": 45,
          "tested_by": "Alma Admin",
          "findings": ""
        }
      ]
    }
  ],
  "unprotected_assets": [
    {
      "id": "4c6e8a02-3d5f-4b79-9e1c-2a4b6d8f0c14",
      "name": "ERP",
      "criticality": "critical",
      "criticality_display": "Kritisch"
    }
  ],
  "exempted_assets": []
}

Superficie d'attacco

1 Endpoint
GET /company/attack-surface/api/mobile/ Indicatori, ultima scansione, rilevamenti aperti e asset ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/attack-surface/api/mobile/
Response
{
  "is_admin": true,
  "stats": {
    "hosts": 3,
    "ips": 2,
    "open_ports": 5,
    "cves": 1,
    "open_findings": 1,
    "by_severity": {"critical": 0, "high": 1, "medium": 0, "low": 0, "info": 0}
  },
  "budget": {"limit": 200, "used": 26, "remaining": 174, "blocked": false},
  "scan": {
    "id": "8a0c2e4a-7b9d-4f13-8a2b-6c8d0e2f4a57",
    "domain": "beispiel.ch",
    "status": "done",
    "status_display": "Abgeschlossen",
    "created_at": "2026-05-16T07:00:00+00:00",
    "completed_at": "2026-05-16T07:02:10+00:00",
    "new_assets": 1,
    "new_findings": 1,
    "changes": {"new_assets": 1, "new_ports": 2},
    "error": ""
  },
  "findings": [
    {
      "id": "0c2e4a6c-9d1f-4b35-9c4d-8e0f2a4b6c79",
      "kind": "risky_port",
      "kind_display": "Riskanter Port",
      "severity": "high",
      "severity_display": "Hoch",
      "subject": "203.0.113.5:3389",
      "domain": "beispiel.ch",
      "status": "open",
      "status_display": "Offen",
      "first_seen_at": "2026-05-16T07:02:00+00:00",
      "last_seen_at": "2026-05-16T07:02:00+00:00",
      "note": "Hoster informiert",
      "asset_id": "2e4a6c8e-1f3b-4d57-8e6f-0a2b4c6d8e91",
      "risk": {"id": "4a6c8e0a-3b5d-4f79-8a8b-2c4d6e8f0a13", "title": "RDP offen", "level": "high", "status": "assessed"}
    }
  ],
  "assets": [
    {
      "id": "2e4a6c8e-1f3b-4d57-8e6f-0a2b4c6d8e91",
      "kind": "ip",
      "kind_display": "IP-Adresse",
      "value": "203.0.113.5",
      "domain": "beispiel.ch",
      "ports": [443, 3389],
      "vuln_count": 1,
      "last_seen": "2026-05-16T07:02:00+00:00",
      "technologies": ["nginx 1.24.0"],
      "note": "",
      "excluded": false,
      "shared": false,
      "register_asset": null
    }
  ]
}

Divieti di accesso

3 Endpoints
GET /company/banning-orders/api/list/ Elenca i divieti di accesso (i 100 più recenti) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/banning-orders/api/list/
Response
{
  "hausverbote": [
    {
      "id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
      "firstname": "Unbekannt",
      "lastname": "männlich",
      "status": "aktiv",
      "reason": "Hausfriedensbruch",
      "location": "Filiale Tannenhof",
      "ban_date": "2026-05-16",
      "ban_until": "2027-05-16",
      "photo_url": null,
      "violation_count": 0
    }
  ]
}
POST /company/banning-orders/api/create/ Crea divieto di accesso ▶
Request
curl -X POST https://portal.cybertell.io/company/banning-orders/api/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -F "firstname=Unbekannt" \
  -F "lastname=männlich" \
  -F "reason=Hausfriedensbruch" \
  -F "location=Filiale Tannenhof" \
  -F "ban_date=2026-05-16" \
  -F "ban_until=2027-05-16" \
  -F "[email protected]"
Response
{
  "id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
  "status": "ok"
}
GET/PATCH/PUT/DEL /company/banning-orders/api/<uuid>/ Dettaglio divieto di accesso ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/banning-orders/api/8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60/
Response
{
  "id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
  "firstname": "Unbekannt",
  "lastname": "männlich",
  "date_of_birth": null,
  "photo_url": null,
  "description": "",
  "street": "",
  "postal_code": "",
  "city": "",
  "country": "",
  "reason": "Hausfriedensbruch",
  "location": "Filiale Tannenhof",
  "ban_date": "2026-05-16",
  "ban_until": "2027-05-16",
  "status": "aktiv",
  "notes": "",
  "violations": [
    {
      "id": "0a2c4e68-1b3d-4f75-9c18-5e7a9c1d3f60",
      "date": "2026-06-01",
      "description": "Erneut im Laden",
      "reported_to_police": true,
      "notes": ""
    }
  ],
  "can_edit": true,
  "can_manage": true
}

Esercitazioni tabletop

6 Endpoints
GET /company/tabletop/api/scenarios/ Elenca gli scenari ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/scenarios/
Response
{
  "scenarios": [
    {
      "id": "1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02",
      "title": "Ransomware Krisenfall",
      "scenario_type": "ransomware",
      "scenario_type_display": "Ransomware",
      "difficulty": "hard",
      "difficulty_display": "Schwer",
      "narrative": "Montagmorgen, 07:15 Uhr …",
      "duration_min": 90,
      "target_roles": "Geschäftsleitung, IT",
      "phase_count": 6,
      "created_at": "2026-05-02T09:00:00+00:00"
    }
  ]
}
POST /company/tabletop/api/scenarios/generate/ Genera scenario (AI) ▶
Request
curl -X POST https://portal.cybertell.io/company/tabletop/api/scenarios/generate/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"scenario_type": "ransomware", "difficulty": "hard", "extra_context": "", "phase_count": 8}'
Response
{
  "job_id": "6d8f0a24-5c7e-4b91-8a36-2f4a6c8e0d51",
  "status": "generating"
}
GET /company/tabletop/api/scenarios/<uuid>/ Dettaglio scenario ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/scenarios/1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02/
Response
{
  "id": "1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02",
  "title": "Ransomware Krisenfall",
  "scenario_type": "ransomware",
  "scenario_type_display": "Ransomware",
  "difficulty": "hard",
  "narrative": "Montagmorgen, 07:15 Uhr …",
  "duration_min": 90,
  "target_roles": "Geschäftsleitung, IT",
  "learning_goals": "Entscheidungswege unter Zeitdruck üben",
  "phases": [
    {
      "id": "2b4d6f80-3c5e-4a91-8b27-3e5a7c9e1b02",
      "order": 1,
      "title": "Erste Meldung",
      "situation": "Der Fileserver antwortet nicht mehr.",
      "time_pressure": "15 Minuten",
      "discussion_question": "Wer wird sofort informiert?",
      "choices": [
        { "label": "A", "text": "IT-Leitung informieren", "consequence": "…", "is_recommended": true }
      ]
    }
  ]
}
GET /company/tabletop/api/negotiations/ Elenca le negoziazioni ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/negotiations/
Response
{
  "negotiations": [
    {
      "id": "7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24",
      "scenario_type": "ransomware",
      "scenario_type_display": "Ransomware",
      "difficulty": "medium",
      "status": "active",
      "initial_ransom": 250000,
      "current_ransom": 125000,
      "trust_level": 40,
      "threat_level": 70,
      "score": null,
      "outcome": "",
      "message_count": 6,
      "started_at": "2026-05-16T09:00:00+00:00",
      "completed_at": null
    }
  ]
}
GET /company/tabletop/api/negotiations/<uuid>/ Dettaglio negoziazione ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/
Response
{
  "id": "7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24",
  "scenario_type": "ransomware",
  "scenario_briefing": "Ihre Server sind verschlüsselt …",
  "difficulty": "medium",
  "status": "active",
  "initial_ransom": 250000,
  "current_ransom": 125000,
  "deadline_hours": 48,
  "trust_level": 40,
  "threat_level": 70,
  "score": null,
  "outcome": "",
  "ai_feedback": "",
  "messages": [
    { "role": "attacker", "content": "Sie haben 48 Stunden.", "timestamp": "2026-05-16T09:00:00+00:00" }
  ],
  "started_at": "2026-05-16T09:00:00+00:00"
}
POST /company/tabletop/api/negotiations/<uuid>/message/ Invia messaggio ▶
Request
curl -X POST https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/message/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"message": "Wir benötigen mehr Zeit."}'
Response
{
  "message": "Sie haben 24 Stunden.",
  "current_ransom": 125000,
  "trust_level": 35,
  "threat_level": 75,
  "status": "active",
  "outcome": ""
}

SOC, parco dispositivi & threat report

8 Endpoints
GET /company/api/soc/status/ Stato dell’hub SOC (firewall configurato) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/soc/status/
Response
{
  "firewalla": true,
  "sophos": false,
  "defender": false,
  "pfsense": false,
  "waf": true
}
GET/POST /company/api/threat-reports/config/ Leggere / salvare la configurazione del threat report (role_id come UUID o intero interno) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/threat-reports/config/
Response
{
  "configs": [
    {
      "id": 3,
      "role_id": 12,
      "role_uuid": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
      "role_name": "Geschäftsleitung",
      "frequency": "monthly",
      "send_hour": 8,
      "send_weekday": 0,
      "send_day": 1,
      "sections": ["lage_schweiz", "eigene_vorfaelle"],
      "is_active": true,
      "include_ai_summary": true
    }
  ],
  "available_sections": [
    { "key": "lage_schweiz", "label": "Lage Schweiz" }
  ]
}
GET /company/api/soc/<provider>/live/ Dati in tempo reale di un provider SOC (provider = firewalla, pfsense, sophos, defender, graylog; finestra ?start_ts=&end_ts=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/soc/firewalla/live/?start_ts=1778914800&end_ts=1778918400
Response
{
  "provider": "firewalla",
  "capabilities": { "label": "Firewalla", "device_assignments": true },
  "soc_stats": {
    "threat_level": "medium",
    "alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
    "total_alarms": 7,
    "boxes_online": 2,
    "boxes_total": 2,
    "total_flows": 812,
    "blocked_flows": 14,
    "blocked_ratio": 1.72,
    "total_download": 41984000,
    "total_upload": 5242880
  },
  "flow_map": [
    { "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
  ],
  "recent_blocked": [
    { "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
  ],
  "suspicious": [
    { "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
  ],
  "company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
  "blocked_countries": ["RU", "KP"]
}
GET /company/api/soc/<provider>/device-flows/ Flussi aggregati di un dispositivo nell'ultima ora (?device= obbligatorio, ?region= facoltativo) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/soc/firewalla/device-flows/?device=WS-042
Response
{
  "device": "WS-042",
  "total_flows": 812,
  "blocked_flows": 14,
  "blocked_ratio": 1.72,
  "total_download": 41984000,
  "total_upload": 5242880,
  "filter_region": "",
  "top_domains": [
    { "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
  ],
  "top_regions": [
    { "region": "CH", "count": 640, "blocked": 0 }
  ]
}
GET/POST/DEL /company/api/soc/<provider>/device-assignments/ Assegnare dispositivi ai collaboratori (admin; mitarbeiter_id come UUID o intero interno) ▶
Request
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/device-assignments/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"device_key": "AA:BB:CC:DD:EE:FF", "device_name": "WS-042", "context_id": "0a1b2c3d", "mitarbeiter_id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "notes": ""}'
Response
{
  "ok": true,
  "created": true,
  "assignment": {
    "id": 7,
    "provider": "firewalla",
    "device_key": "AA:BB:CC:DD:EE:FF",
    "device_name": "WS-042",
    "context_id": "0a1b2c3d",
    "mitarbeiter_id": 42,
    "mitarbeiter_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
    "mitarbeiter_name": "Max Muster",
    "assigned_at": "2026-05-16T08:10:00+00:00",
    "notes": ""
  }
}
POST /company/api/soc/<provider>/alarm-ai/ Analisi IA di un allarme (campi del modulo; anche sotto /company/api/firewalla/alarm-ai/) ▶
Request
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/alarm-ai/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  --data-urlencode 'alarm_type=Abnormal Upload' \
  --data-urlencode 'severity=high' \
  --data-urlencode 'device=NAS-Buero' \
  --data-urlencode 'target=203.0.113.50' \
  --data-urlencode 'message=2.1 GB in 10 min' \
  --data-urlencode 'timestamp=2026-05-16T07:40:00Z'
Response
{
  "analysis": "ZUSAMMENFASSUNG: …"
}
POST /company/api/soc/<provider>/suspicious-analyse/ Verificare una destinazione sospetta (action=vt|ai|both; anche sotto /company/api/firewalla/suspicious-analyse/) ▶
Request
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/suspicious-analyse/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  --data-urlencode 'action=both' \
  --data-urlencode 'type=blocked_flow' \
  --data-urlencode 'title=Blockiertes Ziel' \
  --data-urlencode 'detail=WS-042 nach RU' \
  --data-urlencode 'domains=198.51.100.7' \
  --data-urlencode 'severity=low' \
  --data-urlencode 'region=RU'
Response
{
  "vt": [
    { "url": "198.51.100.7", "verdict": "malicious", "source": "ipsum", "score": 4 }
  ],
  "ai": "ZUSAMMENFASSUNG: …"
}
GET /company/api/threat-report/latest/ Ultimo rapporto sulla situazione ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/threat-report/latest/
Response
{
  "report": {
    "sent_at": "2026-05-01T06:00:00+00:00",
    "recipient_count": 3,
    "ai_summary": "Im April dominierten QR-Phishing und Rechnungsbetrug.",
    "sections": ["lage_schweiz", "eigene_vorfaelle"],
    "role": "Geschäftsleitung"
  }
}

Integrazione Firewalla

13 Endpoints
GET /company/api/firewalla/overview/ Panoramica della dashboard ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/overview/
Response
{
  "stats": {
    "box_count": 2,
    "online_count": 2,
    "offline_count": 0,
    "alarm_count": 7,
    "alarm_severity": { "high": 1, "medium": 2, "info": 4 },
    "rule_count": 64,
    "block_rule_count": 40,
    "allow_rule_count": 24,
    "target_list_count": 3,
    "blocked_domain_count": 12
  },
  "boxes": [
    {
      "id": "0a1b2c3d",
      "name": "Gold Murmelibach",
      "model": "gold",
      "version": "1.979",
      "license": "MSP",
      "ip": "203.0.113.20",
      "local_ip": "10.0.0.1",
      "mac": "AA:BB:CC:00:11:22",
      "mode": "router",
      "network_count": 3,
      "device_count": 38,
      "uptime": 864000,
      "last_active": "16.05.2026 08:00",
      "online": true,
      "location": "Murmelibach"
    }
  ],
  "recent_alarms": [
    {
      "id": "a-901",
      "type": "Sicherheitsaktivität",
      "message": "Verbindung zu bekannter Malware-Domain",
      "device": "WS-042",
      "target": "boese-domain.example",
      "timestamp": "16.05.2026 08:05",
      "severity": "high",
      "box_id": "0a1b2c3d"
    }
  ],
  "rules": [
    {
      "id": "55",
      "type": "dns",
      "target": "boese-domain.example",
      "action": "block",
      "direction": "outbound",
      "protocol": "",
      "scope": "",
      "expire": 0,
      "created_at": "10.05.2026 09:00",
      "paused": false
    }
  ],
  "target_lists": [
    { "id": "TL-1", "name": "CyberTell Blocklist", "target_count": 12, "owner": "" }
  ],
  "blocked_domains": ["boese-domain.example"]
}
GET /company/api/firewalla/boxes/ Elenca i dispositivi (box) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/
Response
{
  "boxes": [
    {
      "id": "0a1b2c3d",
      "name": "Gold Murmelibach",
      "model": "gold",
      "version": "1.979",
      "license": "MSP",
      "ip": "203.0.113.20",
      "local_ip": "10.0.0.1",
      "mac": "AA:BB:CC:00:11:22",
      "mode": "router",
      "network_count": 3,
      "device_count": 38,
      "uptime": 864000,
      "last_active": "16.05.2026 08:00",
      "online": true,
      "location": "Murmelibach"
    }
  ]
}
GET /company/api/firewalla/boxes/<box_id>/ Dettaglio box ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/
Response
{
  "box_id": "0a1b2c3d",
  "box": {
    "id": "0a1b2c3d",
    "name": "Gold Murmelibach",
    "model": "gold",
    "version": "1.979",
    "license": "MSP",
    "ip": "203.0.113.20",
    "local_ip": "10.0.0.1",
    "mac": "AA:BB:CC:00:11:22",
    "mode": "router",
    "network_count": 3,
    "device_count": 38,
    "uptime": 864000,
    "last_active": "16.05.2026 08:00",
    "online": true,
    "location": "Murmelibach"
  },
  "alarms": [
    {
      "id": "a-901",
      "type": "Sicherheitsaktivität",
      "message": "Verbindung zu bekannter Malware-Domain",
      "device": "WS-042",
      "target": "boese-domain.example",
      "timestamp": "16.05.2026 08:05",
      "severity": "high",
      "box_id": "0a1b2c3d"
    }
  ],
  "rules": [
    {
      "id": "55",
      "type": "dns",
      "target": "boese-domain.example",
      "action": "block",
      "direction": "outbound",
      "protocol": "",
      "scope": "",
      "expire": 0,
      "created_at": "10.05.2026 09:00",
      "paused": false
    }
  ],
  "devices": [
    {
      "id": "AA:BB:CC:DD:EE:FF",
      "mac": "AA:BB:CC:DD:EE:FF",
      "mac_vendor": "Dell",
      "ip": "10.0.0.42",
      "name": "WS-042",
      "online": true,
      "last_seen": "16.05.2026 08:00",
      "total_download": 41984000,
      "total_upload": 5242880,
      "assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
    }
  ]
}
GET /company/api/firewalla/boxes/<box_id>/devices/ Dispositivi di una box ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/devices/
Response
{
  "box_id": "0a1b2c3d",
  "devices": [
    {
      "id": "AA:BB:CC:DD:EE:FF",
      "mac": "AA:BB:CC:DD:EE:FF",
      "mac_vendor": "Dell",
      "ip": "10.0.0.42",
      "name": "WS-042",
      "online": true,
      "last_seen": "16.05.2026 08:00",
      "total_download": 41984000,
      "total_upload": 5242880,
      "assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
    }
  ],
  "count": 1
}
GET /company/api/firewalla/flows/ Flussi di traffico (?query=, ?groupBy=, ?sortBy=, ?cursor=, ?limit= predefinito 50, max. 500) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/flows/?limit=200
Response
{
  "flows": [
    {
      "ts": "16.05.2026 08:00",
      "ts_epoch": 1778918400.0,
      "protocol": "tcp",
      "dport": "443",
      "sport": "",
      "direction": "outbound",
      "download": 10240,
      "upload": 2048,
      "category": "",
      "region": "US",
      "device": "WS-042",
      "device_ip": "10.0.0.42",
      "source": "",
      "destination": "example.com",
      "dest_ip": "93.184.216.34",
      "blocked": false,
      "duration": 0.4,
      "count": 1
    }
  ],
  "count": 1,
  "next_cursor": ""
}
GET /company/api/firewalla/device-flows/ Traffico del dispositivo (?device= obbligatorio, ?region= facoltativo) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/device-flows/?device=WS-042
Response
{
  "device": "WS-042",
  "total_flows": 812,
  "blocked_flows": 14,
  "blocked_ratio": 1.72,
  "total_download": 41984000,
  "total_upload": 5242880,
  "filter_region": "",
  "top_domains": [
    { "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
  ],
  "top_regions": [
    { "region": "CH", "count": 640, "blocked": 0 }
  ]
}
GET /company/api/firewalla/stats/ Statistiche della fleet ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/stats/
Response
{
  "stats": { "onlineBoxes": 2, "offlineBoxes": 0, "alarms": 7, "rules": 64 }
}
GET /company/api/firewalla/soc-live/ Feed SOC in tempo reale ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/soc-live/
Response
{
  "provider": "firewalla",
  "capabilities": { "label": "Firewalla", "device_assignments": true },
  "soc_stats": {
    "threat_level": "medium",
    "alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
    "total_alarms": 7,
    "boxes_online": 2,
    "boxes_total": 2,
    "total_flows": 812,
    "blocked_flows": 14,
    "blocked_ratio": 1.72,
    "total_download": 41984000,
    "total_upload": 5242880
  },
  "flow_map": [
    { "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
  ],
  "recent_blocked": [
    { "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
  ],
  "suspicious": [
    { "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
  ],
  "company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
  "blocked_countries": ["RU", "KP"]
}
GET/POST/DEL /company/api/firewalla/blocked-countries/ Paesi bloccati ▶
Request
curl -X POST https://portal.cybertell.io/company/api/firewalla/blocked-countries/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"country_code": "RU"}'
Response
{
  "success": true,
  "country_code": "RU",
  "action": "blocked"
}
GET/POST/DEL /company/api/firewalla/blocked-domains/ Gestisci i domini bloccati ▶
Request
curl -X POST https://portal.cybertell.io/company/api/firewalla/blocked-domains/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"domain": "boese-domain.example"}'
Response
{
  "ok": true,
  "message": "boese-domain.example blockiert."
}
GET/POST/DEL /company/api/firewalla/device-assignments/ Gestisci le assegnazioni dei dispositivi (mitarbeiter_id come UUID o intero interno) ▶
Request
curl -X POST https://portal.cybertell.io/company/api/firewalla/device-assignments/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"mac": "AA:BB:CC:DD:EE:FF", "device_name": "WS-042", "box_id": "0a1b2c3d", "mitarbeiter_id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "notes": ""}'
Response
{
  "ok": true,
  "created": true,
  "assignment": {
    "id": 7,
    "device_mac": "AA:BB:CC:DD:EE:FF",
    "device_name": "WS-042",
    "box_id": "0a1b2c3d",
    "mitarbeiter_id": 42,
    "mitarbeiter_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
    "mitarbeiter_name": "Max Muster"
  }
}
POST /company/api/firewalla/rules/<rule_id>/pause/ Metti in pausa la regola ▶
Request
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/pause/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "message": "Regel 55 pausiert."
}
POST /company/api/firewalla/rules/<rule_id>/resume/ Riprendi la regola ▶
Request
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/resume/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "message": "Regel 55 fortgesetzt."
}

Playbook (incident response)

14 Endpoints
GET /company/playbooks/api/list/ Elenca i playbook ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/list/
Response
{
  "playbooks": [
    {
      "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
      "title": "Ransomware Response",
      "description": "Sofortmassnahmen bei Verschlüsselung",
      "topic": "ransomware",
      "topic_display": "Ransomware-Angriff",
      "version": "1.0",
      "updated_at": "2026-05-02T10:00:00+00:00",
      "scope": "standard",
      "has_steps": true
    }
  ]
}
POST /company/playbooks/api/create/ Crea playbook (facoltativamente con contenuti IA, ai_generate) ▶
Request
curl -X POST https://portal.cybertell.io/company/playbooks/api/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Ransomware Response", "topic": "ransomware", "version": "1.0", "description": "Sofortmassnahmen bei Verschlüsselung", "scope": "standard", "ai_generate": true}'
Response
{
  "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
  "title": "Ransomware Response"
}
GET /company/playbooks/api/<uuid>/ Dettaglio playbook ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/
Response
{
  "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
  "title": "Ransomware Response",
  "description": "Sofortmassnahmen bei Verschlüsselung",
  "topic": "ransomware",
  "topic_display": "Ransomware-Angriff",
  "version": "1.0",
  "updated_at": "2026-05-02T10:00:00+00:00",
  "scope": "standard",
  "has_steps": true,
  "sections": [
    {
      "id": "4a6c8e02-1b3d-4f59-9c87-2e5a7d1f3b06",
      "title": "Sofortmassnahmen",
      "content": "Betroffene Hosts isolieren …",
      "order": 0,
      "intro": "",
      "preparation": "",
      "condition": "",
      "block_key": "",
      "has_steps": true,
      "steps": [
        { "id": "e4b8c2d6-1a3f-4c57-9e80-2b4d6f8a0c13", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Incident Lead", "time_mark": "", "condition": "", "module_key": "", "order": 0 }
      ]
    }
  ],
  "roles": [
    { "id": "5b7d9f21-3c4e-4a86-9b05-1d3f5a7c9e20", "role_type": "intern", "name": "Max Muster", "role_title": "Incident Lead", "email": "[email protected]", "phone": "", "notes": "" }
  ]
}
GET /company/playbooks/api/<uuid>/pdf/ Playbook in PDF ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o playbook.pdf https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="playbook.pdf"

%PDF-1.7 …
GET /company/playbooks/api/runs/ Elenca le esecuzioni (?status=laufend|finished|abgeschlossen|abgebrochen, ?kind=drill|incident) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/runs/?status=laufend
Response
{
  "runs": [
    {
      "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
      "playbook_id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
      "title": "Ransomware Response",
      "kind": "incident", "kind_display": "Ernstfall",
      "status": "laufend", "status_display": "Laufend", "is_running": true,
      "started_at": "2026-10-11T08:15:00+00:00",
      "warroom": { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" },
      "ticket": null,
      "counts": { "done": 2, "open": 5, "skipped": 0, "na": 1, "visible": 7, "percent": 29 }
    }
  ]
}
GET /company/playbooks/api/runs/options/ Opzioni per l’attivazione: playbook con domande di verifica, sistemi, fornitori, war room, ticket ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/runs/options/
Response
{
  "playbooks": [ { "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response", "topic": "ransomware", "questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ] } ],
  "asset_groups": [ { "key": "system", "label": "System", "assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster" } ] } ],
  "supplier_groups": [ { "key": "it_infrastructure", "label": "IT-Infrastruktur", "assets": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "criticality": "active", "criticality_label": "Aktiv", "owner": "" } ] } ],
  "warrooms": [ { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" } ],
  "tickets": [ { "id": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "title": "Verschlüsselte Dateien", "short_code": "T-0481" } ],
  "can_pick_assets": true
}
POST /company/playbooks/api/runs/activate/ Avvia un’esecuzione (esercitazione o incidente) con sistemi, fornitori, collegamento e verifica del caso ▶
Request
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/activate/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"playbook": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "kind": "incident", "link": "ticket", "ticket": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "assets": ["a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91"], "suppliers": ["b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02"], "answers": {"ransom_demand": true, "data_exfiltrated": null}}'
Response
{
  "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
  "title": "Ransomware Response", "kind": "incident", "status": "laufend", "is_running": true,
  "answers": { "ransom_demand": true },
  "questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ],
  "sections": [ { "index": 0, "title": "Sofortmassnahmen", "intro": "Erste Stunde.", "preparation": "", "condition": "", "block_key": "", "state": null, "hidden": false,
      "steps": [ { "id": "e4b8c2d6-1f3a-4e59-9b07-2c6d8a0f4e12", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Technischer IR-Lead", "time_mark": "0–15 min", "condition": "", "module_key": "warroom", "module": { "key": "warroom", "label": "War Room", "url": "/company/incidents/warroom/" }, "state": "offen", "applicable": true, "open_question": false, "assignee": null, "done_by": null, "done_at": null, "note": "", "ticket": null, "asset_hint": "", "can_change": true } ] } ],
  "assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "asset_type_label": "System", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster", "supplier": "Hosting AG", "backup_plans": [], "no_backup": true, "open_findings": [], "url": "/company/asset-register/a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91/" } ],
  "suppliers": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "category_label": "IT-Infrastruktur", "status": "active", "status_label": "Aktiv", "contact_name": "", "contact_email": "[email protected]", "contact_phone": "", "data_access": true, "scope": "", "contingency": "Hotline 24/7", "url": "/company/suppliers/b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02/" } ],
  "counts": { "done": 0, "open": 7, "skipped": 0, "na": 0, "visible": 7, "percent": 0 },
  "permissions": { "can_operate": true, "can_finish": true, "can_delete": true, "can_edit_assets": true }
}
GET /company/playbooks/api/runs/<uuid>/ Dettaglio esecuzione: sezioni e passi con stato, verifica del caso, sistemi e fornitori coinvolti, permessi ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/
Response
{
  "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
  "title": "Ransomware Response", "status": "laufend",
  "sections": [], "assets": [], "suppliers": [],
  "permissions": { "can_operate": true, "can_finish": true, "can_delete": false, "can_edit_assets": true }
}
POST /company/playbooks/api/runs/<uuid>/assets/ Sostituisce sistemi e fornitori coinvolti (senza la chiave suppliers i fornitori restano invariati) ▶
Request
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/assets/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"assets": ["a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91"], "suppliers": ["b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02"]}'
Response
{
  "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
  "assets": [], "suppliers": []
}
POST /company/playbooks/api/runs/<uuid>/answers/ Imposta le risposte della verifica del caso (true, false o null = aperto) ▶
Request
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/answers/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"answers": {"ransom_demand": true, "data_exfiltrated": false, "customers_affected": null}}'
Response
{
  "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
  "answers": { "ransom_demand": true, "data_exfiltrated": false },
  "sections": []
}
POST /company/playbooks/api/runs/<uuid>/steps/<uuid>/state/ Spunta, salta o riapre un passo (offen|erledigt|uebersprungen), con nota facoltativa ▶
Request
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/steps/e4b8c2d6-1f3a-4e59-9b07-2c6d8a0f4e12/state/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"state": "erledigt", "note": "Kabel gezogen, 08:21"}'
Response
{
  "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
  "counts": { "done": 1, "open": 6, "skipped": 0, "na": 0, "visible": 7, "percent": 14 },
  "sections": []
}
POST /company/playbooks/api/runs/<uuid>/finish/ Conclude o interrompe un’esecuzione (action=finish|abort), nota finale, revisione facoltativa ▶
Request
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/finish/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"action": "finish", "notes": "Wiederanlauf um 14:30 abgeschlossen.", "create_review": true}'
Response
{
  "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
  "status": "abgeschlossen", "is_running": false,
  "review": { "id": "5a3c7e91-2d4f-4b68-8c17-9e1b3d5f7a20", "status": "entwurf" }
}
POST/DEL /company/playbooks/api/runs/<uuid>/delete/ Elimina un’esecuzione (solo amministratore dell’azienda) ▶
Request
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/delete/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true
}
GET /company/playbooks/api/runs/<uuid>/pdf/ Esecuzione come PDF ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o playbook-lauf.pdf https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="playbook-lauf.pdf"

%PDF-1.7 …

Policy di sicurezza

3 Endpoints

I 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 ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/policy/api/
Response
{
  "version": "4",
  "published_at": "2026-04-30T12:00:00+00:00",
  "sections": [
    { "key": "password", "title": "Passwort-Richtlinien", "extra": "", "icon": "Key", "sort_order": 1, "is_custom": false,
      "body_html": "<ul><li>Passwörter haben mindestens 12 Zeichen.</li></ul>" }
  ],
  "pw_rules": { "min_length": 12, "require_uppercase": true, "require_numbers": true, "require_special": false, "expiry_days": 0, "no_reuse": true },
  "incident_contact": { "name": "Max Muster", "email": "[email protected]", "phone": "+41 31 000 00 00" },
  "acknowledged": false,
  "acknowledged_at": null,
  "acknowledged_version": null
}
POST /company/policy/api/acknowledge/ Conferma la policy (dipendente) ▶
Request
curl -X POST https://portal.cybertell.io/company/policy/api/acknowledge/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "status": "ok"
}
GET /company/policy/api/mobile/pdf/ Direttiva in PDF ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o sicherheitsrichtlinie.pdf https://portal.cybertell.io/company/policy/api/mobile/pdf/?lang=de
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="sicherheitsrichtlinie.pdf"

%PDF-1.7 …

Documenti sicuri

1 Endpoint
GET /company/api/documents/ Documenti aziendali condivisi ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/documents/
Response
{
  "documents": [
    {
      "id": "2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02",
      "title": "Notfallkonzept",
      "description": "",
      "category": "Notfall",
      "filename": "notfallkonzept.pdf",
      "size": 284120,
      "download_url": "/secure-file/2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02/",
      "can_read": true,
      "uploaded_at": "2026-04-02T10:00:00+00:00"
    }
  ]
}

Punti

1 Endpoint
GET /company/api/points/me/ Punti personali e classifica ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/points/me/
Response
{
  "points": {
    "total": 1840,
    "this_month": 260,
    "this_month_chf": 26.0,
    "monthly_budget_chf": 50.0,
    "enabled": true,
    "level": "Wachsam",
    "level_progress": 0.6,
    "next_level_points": 2000,
    "my_rank": 3,
    "leaderboard": [
      { "rank": 1, "name": "Erika Muster", "points": 2410, "is_me": false },
      { "rank": 3, "name": "Max Muster", "points": 1840, "is_me": true }
    ]
  }
}

Roadmap

2 Endpoints
GET /company/roadmap/api/mobile/ Fasi, avanzamento e prossimi passi ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/roadmap/api/mobile/
Response
{
  "progress": 35,
  "phases": [
    {
      "key": "grundschutz",
      "label": "Grundschutz",
      "desc": "…",
      "done": 6,
      "total": 12,
      "items": [
        {
          "key": "module:incidents",
          "label": "Vorfall-Meldung aktivieren",
          "desc": "…",
          "icon": "Shield",
          "status": "done",
          "cadence": "",
          "recurring": false,
          "last_done": "2026-05-02T09:00:00+00:00",
          "snoozed_until": null,
          "planned_date": null,
          "overdue": false
        }
      ]
    }
  ],
  "next_steps": []
}
POST /company/roadmap/api/mobile/action/ Completare o rinviare un passo ▶
Request
curl -X POST https://portal.cybertell.io/company/roadmap/api/mobile/action/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  --data-urlencode 'action=done' \
  --data-urlencode 'item_key=module:incidents'
Response
{
  "ok": true,
  "progress": 38
}

DMARC

2 Endpoints
GET /company/dmarc/api/mobile/ Indicatori e rapporti DMARC ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/dmarc/api/mobile/
Response
{
  "pass_rate": 96,
  "failing_sources": 2,
  "reporters": 5,
  "total_messages": 18240,
  "reports": [
    {
      "uuid": "7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91",
      "policy_domain": "murmelibach-ag.ch",
      "org_name": "google.com",
      "date_begin": "2026-05-14T00:00:00+00:00",
      "date_end": "2026-05-15T00:00:00+00:00",
      "total_count": 420,
      "pass_count": 404,
      "pass_rate": 96
    }
  ]
}
GET /company/dmarc/api/mobile/<uuid>/ Rapporto con allineamento e sorgenti non conformi ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/dmarc/api/mobile/7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91/
Response
{
  "uuid": "7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91",
  "policy_domain": "murmelibach-ag.ch",
  "org_name": "google.com",
  "date_begin": "2026-05-14T00:00:00+00:00",
  "date_end": "2026-05-15T00:00:00+00:00",
  "total_count": 420,
  "pass_count": 404,
  "pass_rate": 96,
  "pol_p": "quarantine",
  "pol_sp": "",
  "pol_pct": 100,
  "pol_adkim": "r",
  "pol_aspf": "r",
  "alignment": { "both": 390, "dkim_only": 10, "spf_only": 4, "none": 16 },
  "failing_records": [
    {
      "source_ip": "203.0.113.7",
      "count": 16,
      "disposition": "quarantine",
      "dkim_result": "fail",
      "spf_result": "fail",
      "dkim_aligned": false,
      "spf_aligned": false,
      "header_from": "murmelibach-ag.ch"
    }
  ]
}

Risposta agli incidenti

1 Endpoint
GET /company/api/mobile/incident-response/ Indagini e indicatori (?severity=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/mobile/incident-response/?status=aktiv
Response
{
  "investigations": [
    {
      "id": "1d3f5a79-2b4c-4e86-9a01-7c9e1b3d5f40",
      "title": "Kompromittiertes Notebook",
      "description": "",
      "status": "aktiv",
      "status_display": "Aktiv",
      "severity": "hoch",
      "severity_display": "Hoch",
      "lead": "Max Muster",
      "created_at": "2026-05-15T14:00:00+00:00"
    }
  ],
  "stats": { "active": 1, "critical": 0, "indicators": 24, "draft_rules": 2 }
}

Registro di audit

1 Endpoint
GET /company/tickets/api/audit-log/ Registro di audit dell'azienda (ultimi 100 eventi, solo amministratori) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/audit-log/
Response
{
  "events": [
    {
      "id": 9001,
      "action": "login",
      "success": true,
      "actor_email": "[email protected]",
      "target_label": "B2B-Portal",
      "ip_address": "203.0.113.10",
      "ip_country": "CH",
      "ip_city": "Bern",
      "user_agent": "Safari 18 · macOS",
      "failure_reason": "",
      "created_at": "2026-05-16T07:02:00+00:00",
      "lat": 46.95,
      "lng": 7.45,
      "location_precision": "city"
    }
  ]
}

API 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 Endpoints
GET /individual/api/dashboard/ Panoramica della dashboard (courses_* conta i tentativi d'esame) ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/dashboard/
Response
{
  "dashboard": {
    "leak_checks": 3,
    "total_breaches": 5,
    "verified_emails": 2,
    "incidents": 1,
    "canary_tokens": 2,
    "canary_hits": 0,
    "simulations": 4,
    "courses_total": 5,
    "courses_passed": 2
  }
}
GET /individual/api/profile/ Dati del profilo ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/profile/
Response
{
  "profile": {
    "id": "3d4e5f6a-9b1c-4d46-8e72-8c0d2f4a6e79",
    "firstname": "Max",
    "lastname": "Muster",
    "email": "[email protected]",
    "phone": "+41790000000",
    "plan": "family",
    "subscription_status": "active",
    "language": "de",
    "created_at": "2026-01-12T09:00:00+00:00",
    "family": { "is_owner": true, "member_count": 2, "members": [ { "id": "9e1c3a57-2b4d-4f86-8a09-3c5e7a9b1d40", "name": "Erika Muster", "email": "[email protected]" } ] }
  }
}

Controlli di leak e-mail

2 Endpoints
GET /individual/api/leak-checks/ Elenco dei controlli di leak ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/leak-checks/
Response
{
  "leak_checks": [
    {
      "id": "d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92",
      "email": "[email protected]",
      "breach_count": 3,
      "risk_level": "high",
      "checked_at": "2026-05-15T20:00:00+00:00"
    }
  ],
  "verified_emails": [
    { "id": "8b0d2f46-1a3c-4e75-9b18-5d7f9a1c3e60", "email": "[email protected]", "verified_at": "2026-01-12T09:05:00+00:00" }
  ]
}
GET /individual/api/leak-checks/<uuid>/ Dettaglio con i breach ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/leak-checks/d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92/
Response
{
  "leak_check": {
    "id": "d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92",
    "email": "[email protected]",
    "breach_count": 3,
    "risk_level": "high",
    "checked_at": "2026-05-15T20:00:00+00:00",
    "breaches": [
      { "name": "ExampleBreach2024", "date": "2024-11-02", "domain": "example.com", "pwn_count": 1420000, "data_classes": ["E-Mail-Adressen", "Passwörter"], "description": "…", "logo_path": "" }
    ]
  }
}

Corsi

1 Endpoint
GET /individual/api/courses/ Corsi della persona con avanzamento (stessa selezione di /individual/courses/api/certifications/) ▶
Request
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \
  https://app.cybertell.io/individual/api/courses/
Response
{
  "courses": [
    {
      "id": "4e5f6a7b-0c2d-4e57-9f83-9d1e3f5a7b80",
      "title": "Phishing erkennen",
      "topic_count": 4,
      "content_count": 12,
      "completed_count": 7,
      "progress_pct": 58,
      "exam": { "id": "2c4e6a80-1b3d-4f57-9a29-6d8f0b2d4e61", "passed": true, "score": "14/16", "finished_at": "2026-05-16T09:00:00+00:00" }
    }
  ]
}

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 Endpoint
GET /reseller/api/dashboard/ Panoramica ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/dashboard/
Response
{
  "dashboard": {
    "type": "reseller",
    "company_count": 12,
    "active_companies": 10,
    "total_employees": 240,
    "open_tickets": 5,
    "sponsored_persons": 0
  }
}

Aziende

6 Endpoints
GET /reseller/api/companies/ Elenca le aziende gestite ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/
Response
{
  "companies": [
    {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "name": "Murmelibach AG",
      "email": "[email protected]",
      "industry": "finance",
      "plan": "tier_10",
      "subscription_status": "active",
      "employee_count": 24,
      "open_tickets": 1,
      "created_at": "2026-01-12T09:00:00+00:00"
    }
  ]
}
GET /reseller/api/companies/<uuid>/ Dettaglio azienda ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
Response
{
  "company": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "name": "Murmelibach AG",
    "email": "[email protected]",
    "industry": "finance",
    "company_size": "11-50",
    "plan": "tier_10",
    "subscription_status": "active",
    "country": "Schweiz",
    "employees": [
      { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]", "is_admin": true }
    ]
  }
}
GET /reseller/api/companies/security/ Situazione di sicurezza di tutti i clienti ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/security/
Response
{
  "customers": [
    {
      "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "company_name": "Murmelibach AG",
      "own_company": false,
      "migrated": false,
      "assets": 42,
      "assets_critical": 3,
      "systems": 12,
      "cves": 9,
      "findings": {
        "critical": 2,
        "high": 4,
        "medium": 5,
        "low": 1
      },
      "kev": 1,
      "support_expired": 1,
      "support_ending": 2,
      "surface_findings": 4,
      "surface_severe": 1,
      "last_run_at": "2026-11-15T02:30:00+00:00"
    }
  ],
  "totals": {
    "companies": 8,
    "with_radar": 5,
    "attention": 2,
    "assets": 214,
    "systems": 61,
    "cves": 37,
    "kev": 2,
    "kev_companies": 2,
    "critical_companies": 3,
    "support_expired": 2,
    "support_ending": 5
  },
  "shared_cves": [
    {
      "cve_id": "CVE-2026-24858",
      "title": "FortiOS: Umgehung der Authentifizierung",
      "severity": "critical",
      "kev": true,
      "cvss": 9.8,
      "companies": 3,
      "systems": 4,
      "customer_names": [
        "Murmelibach AG",
        "Seeblick GmbH"
      ]
    }
  ]
}
GET /reseller/api/companies/security/cves/ CVE aperte di tutti i clienti ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/security/cves/?kev=1
Response
{
  "cves": [
    {
      "cve_id": "CVE-2026-24858",
      "title": "FortiOS: Umgehung der Authentifizierung",
      "severity": "critical",
      "cvss": 9.8,
      "kev": true,
      "customers": [
        {
          "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
          "company_name": "Murmelibach AG"
        }
      ],
      "systems": 2,
      "findings": 2,
      "products": [
        "Fortinet FortiOS"
      ],
      "fixed_in": [
        "7.4.9"
      ],
      "first_seen_at": "2026-11-02T02:31:00+00:00"
    }
  ],
  "truncated": false,
  "kev_total": 1
}
GET /reseller/api/companies/security/assets/ Asset attivi di tutti i clienti ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/security/assets/?criticality=critical
Response
{
  "assets": [
    {
      "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
      "name": "Firewall Hauptsitz",
      "asset_type": "network",
      "asset_type_display": "Netzwerk",
      "criticality": "critical",
      "criticality_display": "Kritisch",
      "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "company_name": "Murmelibach AG",
      "open_cves": 2
    }
  ]
}
GET /reseller/api/companies/<uuid>/security/ Situazione di sicurezza di un cliente ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/security/
Response
{
  "security": {
    "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "company_name": "Murmelibach AG",
    "migrated": false,
    "radar": {
      "systems": 12,
      "cves": 9,
      "open_findings": 12,
      "findings_by_severity": {
        "critical": 2,
        "high": 4,
        "medium": 5,
        "low": 1
      },
      "kev": 1,
      "support_expired": 1,
      "packages": 0,
      "last_run_at": "2026-11-15T02:30:00+00:00",
      "cve_total": 9,
      "affected_systems": 5,
      "system_total": 12,
      "open_cves": [
        {
          "cve_id": "CVE-2026-24858",
          "title": "FortiOS: Umgehung der Authentifizierung",
          "severity": "critical",
          "kev": true,
          "cvss": 9.8,
          "findings": 2,
          "products": [
            "Fortinet FortiOS"
          ],
          "fixed_in": [
            "7.4.9"
          ]
        }
      ],
      "system_list": [
        {
          "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
          "name": "Firewall Hauptsitz",
          "kind": "firewall",
          "kind_display": "Firewall",
          "product": "Fortinet FortiOS",
          "version": "7.4.3",
          "open_findings": 2,
          "support_end": "2027-09-30",
          "support_stage": ""
        }
      ]
    },
    "assets": {
      "total": 42,
      "critical": 3,
      "items": [
        {
          "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
          "name": "Firewall Hauptsitz",
          "asset_type": "network",
          "asset_type_display": "Netzwerk",
          "criticality": "critical",
          "criticality_display": "Kritisch",
          "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
          "company_name": "Murmelibach AG",
          "open_cves": 2
        }
      ]
    },
    "attack_surface": null
  }
}

Fatturazione

6 Endpoints

Fatture 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 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/
Response
{
  "billing": {
    "model": "it_partner",
    "currency": "CHF",
    "discount_percent": 30.0,
    "invoices": {
      "count": 12,
      "open_count": 1,
      "overdue_count": 0,
      "gross_total_chf": 29760.0,
      "discount_total_chf": 8928.0,
      "net_total_chf": 20832.0,
      "open_net_chf": 1736.0,
      "overdue_net_chf": 0.0,
      "latest_id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24"
    },
    "current_period": {
      "period_start": "2026-11-01",
      "period_end": "2026-11-30",
      "priced": true,
      "customer_count": 8,
      "line_count": 9,
      "gross_chf": 2565.0,
      "discount_chf": 769.5,
      "net_chf": 1795.5
    },
    "sponsor": null
  }
}
GET /reseller/api/billing/customers/ Clienti con collaboratori, piano, abbonamento e costi del periodo corrente ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/customers/?include_own=0
Response
{
  "customers": [
    {
      "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "company_name": "Murmelibach AG",
      "domain": "murmelibach-ag.ch",
      "employee_count": 24,
      "plan": "tier_50",
      "plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
      "quantity": 1,
      "unit": "month",
      "unit_price_chf": 85.0,
      "gross_chf": 85.0,
      "discount_percent": 30.0,
      "discount_chf": 25.5,
      "net_chf": 59.5,
      "discounted": true,
      "own_company": false,
      "hosting": "main",
      "active_employee_count": 22,
      "subscription_plan": "tier_50",
      "billing_cycle": "yearly",
      "subscription_status": "active"
    }
  ],
  "totals": { "priced": true, "gross_chf": 2565.0, "discount_chf": 769.5, "net_chf": 1795.5 }
}
GET /reseller/api/billing/customers/<uuid>/ Cliente con stato attuale, abbonamento e storico delle fatture ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/customers/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
Response
{
  "customer": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "name": "Murmelibach AG",
    "own_company": false,
    "billed": true,
    "current": {
      "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "company_name": "Murmelibach AG",
      "domain": "murmelibach-ag.ch",
      "employee_count": 24,
      "plan": "tier_50",
      "plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
      "quantity": 1,
      "unit": "month",
      "unit_price_chf": 85.0,
      "gross_chf": 85.0,
      "discount_percent": 30.0,
      "discount_chf": 25.5,
      "net_chf": 59.5,
      "discounted": true,
      "own_company": false,
      "hosting": "main"
    },
    "active_employee_count": 22,
    "subscription_plan": "tier_50",
    "billing_cycle": "yearly",
    "subscription_status": "active",
    "history": [
      {
        "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
        "company_name": "Murmelibach AG",
        "domain": "murmelibach-ag.ch",
        "employee_count": 22,
        "plan": "tier_50",
        "plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
        "quantity": 1,
        "unit": "month",
        "unit_price_chf": 85.0,
        "gross_chf": 85.0,
        "discount_percent": 30.0,
        "discount_chf": 25.5,
        "net_chf": 59.5,
        "discounted": true,
        "own_company": false,
        "hosting": "main",
        "period_start": "2026-10-01",
        "period_end": "2026-10-31",
        "invoice_id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
        "invoice_number": "CT-202610-0042",
        "invoice_status": "sent"
      }
    ]
  }
}
GET /reseller/api/billing/invoices/ Fatture con clienti e totale collaboratori, filtrabili per stato; ?include=lines aggiunge le posizioni ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/invoices/?status=open
Response
{
  "invoices": [
    {
      "id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
      "invoice_number": "CT-202610-0042",
      "period_start": "2026-10-01",
      "period_end": "2026-10-31",
      "gross_chf": 2480.0,
      "discount_chf": 744.0,
      "net_chf": 1736.0,
      "currency": "CHF",
      "status": "sent",
      "status_display": "Gesendet",
      "line_count": 9,
      "customer_count": 8,
      "employee_total": 186,
      "companies": [
        { "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "company_name": "Murmelibach AG", "own_company": false }
      ],
      "has_pdf": true,
      "issued_at": "2026-11-01T05:00:00+00:00",
      "due_at": "2026-12-01T05:00:00+00:00",
      "paid_at": null
    }
  ]
}
GET /reseller/api/billing/invoices/<uuid>/ Fattura con tutte le posizioni per cliente ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/
Response
{
  "invoice": {
    "id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
    "invoice_number": "CT-202610-0042",
    "period_start": "2026-10-01",
    "period_end": "2026-10-31",
    "gross_chf": 2480.0,
    "discount_chf": 744.0,
    "net_chf": 1736.0,
    "currency": "CHF",
    "status": "sent",
    "status_display": "Gesendet",
    "line_count": 9,
    "customer_count": 8,
    "employee_total": 186,
    "companies": [
      { "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "company_name": "Murmelibach AG", "own_company": false }
    ],
    "has_pdf": true,
    "issued_at": "2026-11-01T05:00:00+00:00",
    "due_at": "2026-12-01T05:00:00+00:00",
    "paid_at": null,
    "lines": [
      {
        "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
        "company_name": "Murmelibach AG",
        "domain": "murmelibach-ag.ch",
        "employee_count": 22,
        "plan": "tier_50",
        "plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
        "quantity": 1,
        "unit": "month",
        "unit_price_chf": 85.0,
        "gross_chf": 85.0,
        "discount_percent": 30.0,
        "discount_chf": 25.5,
        "net_chf": 59.5,
        "discounted": true,
        "own_company": false,
        "hosting": "main",
        "period_start": "2026-10-01",
        "period_end": "2026-10-31"
      }
    ]
  }
}
GET /reseller/api/billing/invoices/<uuid>/pdf/ Fattura in PDF ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o rechnung.pdf https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="CT-202610-0042.pdf"

%PDF-1.7 …

developers.api.group.r-eng.title

24 Endpoints

developers.api.group.r-eng.desc

GET /reseller/api/engagements/ developers.api.ep.r-eng.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/
Response
{
  "items": [
    {
      "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
      "external_ref": "erp-2026-17",
      "title": "Pentest ERP 2026",
      "company": {
        "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
        "name": "Murmelibach AG"
      },
      "phase": "definition",
      "signature_state": "unsigned",
      "updated_at": "2026-11-16T09:12:00+00:00"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/ developers.api.ep.r-eng.1 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Pentest ERP 2026", "company": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "pentest_type": "internal", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-2026-17"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "external_ref": "erp-2026-17",
    "title": "Pentest ERP 2026",
    "company": {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "name": "Murmelibach AG"
    },
    "phase": "definition",
    "signature_state": "unsigned",
    "updated_at": "2026-11-16T09:12:00+00:00",
    "pentest_type": "internal",
    "engagement_scope": [
      "internal_pentest"
    ],
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "testing_hours": "Mo-Fr 08-18 Uhr",
    "scope_targets": "10.0.0.0/24",
    "scope_excluded": "",
    "definition_step": "scope",
    "pentests": [
      {
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
        "short_code": "PT-206",
        "status": "scheduled"
      }
    ],
    "audits": [],
    "reports": [],
    "locked": false,
    "cancelled_at": null,
    "documents": {
      "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
      "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
    }
  }
}
GET /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.2 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
  "external_ref": "erp-2026-17",
  "title": "Pentest ERP 2026",
  "company": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "name": "Murmelibach AG"
  },
  "phase": "definition",
  "signature_state": "unsigned",
  "updated_at": "2026-11-16T09:12:00+00:00",
  "pentest_type": "internal",
  "engagement_scope": [
    "internal_pentest"
  ],
  "start_date": "2026-12-01",
  "end_date": "2026-12-15",
  "testing_hours": "Mo-Fr 08-18 Uhr",
  "scope_targets": "10.0.0.0/24",
  "scope_excluded": "",
  "definition_step": "scope",
  "pentests": [
    {
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
      "short_code": "PT-206",
      "status": "scheduled"
    }
  ],
  "audits": [],
  "reports": [],
  "locked": false,
  "cancelled_at": null,
  "documents": {
    "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
    "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
  }
}
PATCH /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.3 ▶
Request
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"testing_hours": "Mo-Fr 08-18 Uhr"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "external_ref": "erp-2026-17",
    "title": "Pentest ERP 2026",
    "company": {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "name": "Murmelibach AG"
    },
    "phase": "definition",
    "signature_state": "unsigned",
    "updated_at": "2026-11-16T09:12:00+00:00",
    "pentest_type": "internal",
    "engagement_scope": [
      "internal_pentest"
    ],
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "testing_hours": "Mo-Fr 08-18 Uhr",
    "scope_targets": "10.0.0.0/24",
    "scope_excluded": "",
    "definition_step": "scope",
    "pentests": [
      {
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
        "short_code": "PT-206",
        "status": "scheduled"
      }
    ],
    "audits": [],
    "reports": [],
    "locked": false,
    "cancelled_at": null,
    "documents": {
      "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
      "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
    }
  }
}
DELETE /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.4 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response
{
  "ok": true,
  "result": "deleted"
}
POST /reseller/api/engagements/<uuid>/complete-definition/ developers.api.ep.r-eng.5 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/complete-definition/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "external_ref": "erp-2026-17",
    "title": "Pentest ERP 2026",
    "company": {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "name": "Murmelibach AG"
    },
    "phase": "definition",
    "signature_state": "unsigned",
    "updated_at": "2026-11-16T09:12:00+00:00",
    "pentest_type": "internal",
    "engagement_scope": [
      "internal_pentest"
    ],
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "testing_hours": "Mo-Fr 08-18 Uhr",
    "scope_targets": "10.0.0.0/24",
    "scope_excluded": "",
    "definition_step": "scope",
    "pentests": [
      {
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
        "short_code": "PT-206",
        "status": "scheduled"
      }
    ],
    "audits": [],
    "reports": [],
    "locked": false,
    "cancelled_at": null,
    "documents": {
      "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
      "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
    }
  }
}
GET /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.6 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/
Response
{
  "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
  "external_ref": "erp-2026-17",
  "title": "Pentest ERP 2026",
  "company": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "name": "Murmelibach AG"
  },
  "phase": "definition",
  "signature_state": "unsigned",
  "updated_at": "2026-11-16T09:12:00+00:00",
  "pentest_type": "internal",
  "engagement_scope": [
    "internal_pentest"
  ],
  "start_date": "2026-12-01",
  "end_date": "2026-12-15",
  "testing_hours": "Mo-Fr 08-18 Uhr",
  "scope_targets": "10.0.0.0/24",
  "scope_excluded": "",
  "definition_step": "scope",
  "pentests": [
    {
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
      "short_code": "PT-206",
      "status": "scheduled"
    }
  ],
  "audits": [],
  "reports": [],
  "locked": false,
  "cancelled_at": null,
  "documents": {
    "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
    "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
  }
}
PUT /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.7 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Pentest ERP 2026 v2", "company": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "pentest_type": "internal", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-2026-17"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "external_ref": "erp-2026-17",
    "title": "Pentest ERP 2026",
    "company": {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "name": "Murmelibach AG"
    },
    "phase": "definition",
    "signature_state": "unsigned",
    "updated_at": "2026-11-16T09:12:00+00:00",
    "pentest_type": "internal",
    "engagement_scope": [
      "internal_pentest"
    ],
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "testing_hours": "Mo-Fr 08-18 Uhr",
    "scope_targets": "10.0.0.0/24",
    "scope_excluded": "",
    "definition_step": "scope",
    "pentests": [
      {
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
        "short_code": "PT-206",
        "status": "scheduled"
      }
    ],
    "audits": [],
    "reports": [],
    "locked": false,
    "cancelled_at": null,
    "documents": {
      "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
      "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
    }
  }
}
PATCH/DELETE /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.8 ▶
Request
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"testing_hours": "Mo-Fr 08-18 Uhr"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "external_ref": "erp-2026-17",
    "title": "Pentest ERP 2026",
    "company": {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "name": "Murmelibach AG"
    },
    "phase": "definition",
    "signature_state": "unsigned",
    "updated_at": "2026-11-16T09:12:00+00:00",
    "pentest_type": "internal",
    "engagement_scope": [
      "internal_pentest"
    ],
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "testing_hours": "Mo-Fr 08-18 Uhr",
    "scope_targets": "10.0.0.0/24",
    "scope_excluded": "",
    "definition_step": "scope",
    "pentests": [
      {
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
        "short_code": "PT-206",
        "status": "scheduled"
      }
    ],
    "audits": [],
    "reports": [],
    "locked": false,
    "cancelled_at": null,
    "documents": {
      "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
      "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
    }
  }
}
GET /reseller/api/engagements/<uuid>/assets/ developers.api.ep.r-eng.10 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/
Response
{
  "items": [
    {
      "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
      "external_ref": "fw-hq",
      "kind": "ip_range",
      "label": "Server-LAN",
      "value": "10.0.0.0/24",
      "in_scope": true,
      "scope_keys": [
        "internal_pentest"
      ],
      "notes": "",
      "sort_order": 0
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/<uuid>/assets/ developers.api.ep.r-eng.11 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"kind": "ip_range", "label": "Server-LAN", "value": "10.0.0.0/24", "scope_keys": ["internal_pentest"]}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
    "external_ref": "fw-hq",
    "kind": "ip_range",
    "label": "Server-LAN",
    "value": "10.0.0.0/24",
    "in_scope": true,
    "scope_keys": [
      "internal_pentest"
    ],
    "notes": "",
    "sort_order": 0
  }
}
GET /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.12 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
Response
{
  "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
  "external_ref": "fw-hq",
  "kind": "ip_range",
  "label": "Server-LAN",
  "value": "10.0.0.0/24",
  "in_scope": true,
  "scope_keys": [
    "internal_pentest"
  ],
  "notes": "",
  "sort_order": 0
}
PATCH /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.13 ▶
Request
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"label": "Server-LAN Süd"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
    "external_ref": "fw-hq",
    "kind": "ip_range",
    "label": "Server-LAN",
    "value": "10.0.0.0/24",
    "in_scope": true,
    "scope_keys": [
      "internal_pentest"
    ],
    "notes": "",
    "sort_order": 0
  }
}
DELETE /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.14 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response
{
  "ok": true,
  "result": "deleted",
  "notices": [],
  "data": {
    "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
    "external_ref": "fw-hq",
    "kind": "ip_range",
    "label": "Server-LAN",
    "value": "10.0.0.0/24",
    "in_scope": true,
    "scope_keys": [
      "internal_pentest"
    ],
    "notes": "",
    "sort_order": 0
  }
}
PUT /reseller/api/engagements/<uuid>/assets/by-ref/<ref>/ developers.api.ep.r-eng.15 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"kind": "ip_range", "label": "Server-LAN", "value": "10.0.0.0/24", "scope_keys": ["internal_pentest"]}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
    "external_ref": "fw-hq",
    "kind": "ip_range",
    "label": "Server-LAN",
    "value": "10.0.0.0/24",
    "in_scope": true,
    "scope_keys": [
      "internal_pentest"
    ],
    "notes": "",
    "sort_order": 0
  }
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/assets/by-ref/<ref>/ developers.api.ep.r-eng.16 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/by-ref/erp-2026-17/
Response
{
  "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
  "external_ref": "fw-hq",
  "kind": "ip_range",
  "label": "Server-LAN",
  "value": "10.0.0.0/24",
  "in_scope": true,
  "scope_keys": [
    "internal_pentest"
  ],
  "notes": "",
  "sort_order": 0
}
POST /reseller/api/engagements/<uuid>/rules/apply-template/ developers.api.ep.r-eng.17 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/apply-template/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "categories": [
      {
        "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "name": "Social Engineering",
        "relevant": true,
        "items": []
      }
    ],
    "compiled_at": null,
    "has_rules": false
  }
}
PATCH /reseller/api/engagements/<uuid>/rules/categories/<cat_uuid>/ developers.api.ep.r-eng.18 ▶
Request
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"relevant": true}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "categories": [
      {
        "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "name": "Social Engineering",
        "relevant": true,
        "items": []
      }
    ],
    "compiled_at": null,
    "has_rules": false
  }
}
PUT /reseller/api/engagements/<uuid>/rules/items/<item_uuid>/ developers.api.ep.r-eng.19 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/items/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"answer": "yes"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "categories": [
      {
        "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "name": "Social Engineering",
        "relevant": true,
        "items": []
      }
    ],
    "compiled_at": null,
    "has_rules": false
  }
}
POST /reseller/api/engagements/<uuid>/rules/compile/ developers.api.ep.r-eng.20 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/compile/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "categories": [
      {
        "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "name": "Social Engineering",
        "relevant": true,
        "items": []
      }
    ],
    "compiled_at": null,
    "has_rules": false
  }
}
POST /reseller/api/engagements/<uuid>/provision/ developers.api.ep.r-eng.21 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/provision/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "provisioned",
  "notices": [],
  "data": {
    "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "external_ref": "erp-2026-17",
    "title": "Pentest ERP 2026",
    "company": {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "name": "Murmelibach AG"
    },
    "phase": "delivery",
    "signature_state": "signed",
    "updated_at": "2026-11-16T09:12:00+00:00",
    "pentest_type": "internal",
    "engagement_scope": [
      "internal_pentest"
    ],
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "testing_hours": "Mo-Fr 08-18 Uhr",
    "scope_targets": "10.0.0.0/24",
    "scope_excluded": "",
    "definition_step": "scope",
    "pentests": [
      {
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
        "short_code": "PT-206",
        "status": "scheduled"
      }
    ],
    "audits": [],
    "reports": [],
    "locked": false,
    "cancelled_at": null,
    "documents": {
      "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
      "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
    }
  }
}
POST /reseller/api/engagements/<uuid>/cancel/ developers.api.ep.r-eng.22 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/cancel/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Auftrag zurückgezogen"}'
Response
{
  "ok": true,
  "result": "cancelled",
  "notices": [],
  "data": {
    "id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "external_ref": "erp-2026-17",
    "title": "Pentest ERP 2026",
    "company": {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "name": "Murmelibach AG"
    },
    "phase": "cancelled",
    "signature_state": "unsigned",
    "updated_at": "2026-11-16T09:12:00+00:00",
    "pentest_type": "internal",
    "engagement_scope": [
      "internal_pentest"
    ],
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "testing_hours": "Mo-Fr 08-18 Uhr",
    "scope_targets": "10.0.0.0/24",
    "scope_excluded": "",
    "definition_step": "scope",
    "pentests": [
      {
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
        "short_code": "PT-206",
        "status": "scheduled"
      }
    ],
    "audits": [],
    "reports": [],
    "locked": false,
    "cancelled_at": null,
    "documents": {
      "pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
      "docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
    }
  }
}
GET /reseller/api/engagements/<uuid>/document/pdf/ developers.api.ep.r-eng.23 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o roe.pdf https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="roe.pdf"
X-Content-Type-Options: nosniff
GET /reseller/api/engagements/<uuid>/document/docx/ developers.api.ep.r-eng.24 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o roe.docx https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/
Response
HTTP/1.1 200 OK
Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Content-Disposition: attachment; filename="roe.docx"
X-Content-Type-Options: nosniff

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

16 Endpoints

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

GET /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/
Response
{
  "items": [
    {
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
      "external_ref": "erp-pt-1",
      "short_code": "PT-206",
      "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
      "target": "ERP-Server",
      "pentest_type": "internal",
      "scope_key": "internal_pentest",
      "pentester": "Max Muster",
      "start_date": "2026-12-01",
      "end_date": "2026-12-15",
      "status": "scheduled",
      "allowed_transitions": [
        "active",
        "cancelled"
      ],
      "started_at": null,
      "finished_at": null,
      "findings_critical": 0,
      "findings_high": 1,
      "findings_medium": 2,
      "findings_low": 0,
      "content_locked": false
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.1 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"target": "ERP-Server", "pentest_type": "internal", "pentester": "Max Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-pt-1"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
    "external_ref": "erp-pt-1",
    "short_code": "PT-206",
    "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "target": "ERP-Server",
    "pentest_type": "internal",
    "scope_key": "internal_pentest",
    "pentester": "Max Muster",
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "status": "scheduled",
    "allowed_transitions": [
      "active",
      "cancelled"
    ],
    "started_at": null,
    "finished_at": null,
    "findings_critical": 0,
    "findings_high": 1,
    "findings_medium": 2,
    "findings_low": 0,
    "content_locked": false
  }
}
PUT /reseller/api/engagements/<uuid>/pentests/by-ref/<ref>/ developers.api.ep.r-eng-runs.2 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"target": "ERP-Server", "pentest_type": "internal", "pentester": "Max Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-pt-1"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
    "external_ref": "erp-pt-1",
    "short_code": "PT-206",
    "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "target": "ERP-Server",
    "pentest_type": "internal",
    "scope_key": "internal_pentest",
    "pentester": "Max Muster",
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "status": "scheduled",
    "allowed_transitions": [
      "active",
      "cancelled"
    ],
    "started_at": null,
    "finished_at": null,
    "findings_critical": 0,
    "findings_high": 1,
    "findings_medium": 2,
    "findings_low": 0,
    "content_locked": false
  }
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/pentests/by-ref/<ref>/ developers.api.ep.r-eng-runs.3 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/by-ref/erp-2026-17/
Response
{
  "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
  "external_ref": "erp-pt-1",
  "short_code": "PT-206",
  "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
  "target": "ERP-Server",
  "pentest_type": "internal",
  "scope_key": "internal_pentest",
  "pentester": "Max Muster",
  "start_date": "2026-12-01",
  "end_date": "2026-12-15",
  "status": "scheduled",
  "allowed_transitions": [
    "active",
    "cancelled"
  ],
  "started_at": null,
  "finished_at": null,
  "findings_critical": 0,
  "findings_high": 1,
  "findings_medium": 2,
  "findings_low": 0,
  "content_locked": false
}
GET /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.4 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
Response
{
  "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
  "external_ref": "erp-pt-1",
  "short_code": "PT-206",
  "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
  "target": "ERP-Server",
  "pentest_type": "internal",
  "scope_key": "internal_pentest",
  "pentester": "Max Muster",
  "start_date": "2026-12-01",
  "end_date": "2026-12-15",
  "status": "scheduled",
  "allowed_transitions": [
    "active",
    "cancelled"
  ],
  "started_at": null,
  "finished_at": null,
  "findings_critical": 0,
  "findings_high": 1,
  "findings_medium": 2,
  "findings_low": 0,
  "content_locked": false
}
PATCH /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.5 ▶
Request
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"end_date": "2026-12-20"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
    "external_ref": "erp-pt-1",
    "short_code": "PT-206",
    "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "target": "ERP-Server",
    "pentest_type": "internal",
    "scope_key": "internal_pentest",
    "pentester": "Max Muster",
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "status": "scheduled",
    "allowed_transitions": [
      "active",
      "cancelled"
    ],
    "started_at": null,
    "finished_at": null,
    "findings_critical": 0,
    "findings_high": 1,
    "findings_medium": 2,
    "findings_low": 0,
    "content_locked": false
  }
}
DELETE /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.6 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response

POST /reseller/api/engagements/pentests/<run_uuid>/status/ developers.api.ep.r-eng-runs.7 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/status/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"status": "active"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
    "external_ref": "erp-pt-1",
    "short_code": "PT-206",
    "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "target": "ERP-Server",
    "pentest_type": "internal",
    "scope_key": "internal_pentest",
    "pentester": "Max Muster",
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "status": "active",
    "allowed_transitions": [
      "active",
      "cancelled"
    ],
    "started_at": null,
    "finished_at": null,
    "findings_critical": 0,
    "findings_high": 1,
    "findings_medium": 2,
    "findings_low": 0,
    "content_locked": false
  }
}
GET /reseller/api/engagements/<uuid>/audits/ developers.api.ep.r-eng-runs.8 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/
Response
{
  "items": [
    {
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
      "external_ref": "erp-au-1",
      "short_code": "AU-31",
      "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
      "name": "IKT-Audit ERP",
      "scope": "ERP und Anbindungen",
      "scope_key": "ikt_audit",
      "language": "de",
      "lead": "Erika Muster",
      "extra_scope_notes": "",
      "start_date": "2026-12-01",
      "end_date": "2026-12-15",
      "status": "draft",
      "allowed_transitions": [
        "preparing",
        "cancelled"
      ],
      "started_at": null,
      "finished_at": null,
      "findings_critical": 0,
      "findings_high": 1,
      "findings_medium": 2,
      "findings_low": 0,
      "content_locked": false
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/<uuid>/audits/ developers.api.ep.r-eng-runs.9 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"name": "IKT-Audit ERP", "scope": "ERP und Anbindungen", "language": "de", "lead": "Erika Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-au-1"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
    "external_ref": "erp-au-1",
    "short_code": "AU-31",
    "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "name": "IKT-Audit ERP",
    "scope": "ERP und Anbindungen",
    "scope_key": "ikt_audit",
    "language": "de",
    "lead": "Erika Muster",
    "extra_scope_notes": "",
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "status": "draft",
    "allowed_transitions": [
      "preparing",
      "cancelled"
    ],
    "started_at": null,
    "finished_at": null,
    "findings_critical": 0,
    "findings_high": 1,
    "findings_medium": 2,
    "findings_low": 0,
    "content_locked": false
  }
}
PUT /reseller/api/engagements/<uuid>/audits/by-ref/<ref>/ developers.api.ep.r-eng-runs.10 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"name": "IKT-Audit ERP", "scope": "ERP und Anbindungen", "language": "de", "lead": "Erika Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-au-1"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
    "external_ref": "erp-au-1",
    "short_code": "AU-31",
    "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "name": "IKT-Audit ERP",
    "scope": "ERP und Anbindungen",
    "scope_key": "ikt_audit",
    "language": "de",
    "lead": "Erika Muster",
    "extra_scope_notes": "",
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "status": "draft",
    "allowed_transitions": [
      "preparing",
      "cancelled"
    ],
    "started_at": null,
    "finished_at": null,
    "findings_critical": 0,
    "findings_high": 1,
    "findings_medium": 2,
    "findings_low": 0,
    "content_locked": false
  }
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/audits/by-ref/<ref>/ developers.api.ep.r-eng-runs.11 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/by-ref/erp-2026-17/
Response
{
  "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
  "external_ref": "erp-au-1",
  "short_code": "AU-31",
  "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
  "name": "IKT-Audit ERP",
  "scope": "ERP und Anbindungen",
  "scope_key": "ikt_audit",
  "language": "de",
  "lead": "Erika Muster",
  "extra_scope_notes": "",
  "start_date": "2026-12-01",
  "end_date": "2026-12-15",
  "status": "draft",
  "allowed_transitions": [
    "preparing",
    "cancelled"
  ],
  "started_at": null,
  "finished_at": null,
  "findings_critical": 0,
  "findings_high": 1,
  "findings_medium": 2,
  "findings_low": 0,
  "content_locked": false
}
GET /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.12 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
Response
{
  "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
  "external_ref": "erp-au-1",
  "short_code": "AU-31",
  "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
  "name": "IKT-Audit ERP",
  "scope": "ERP und Anbindungen",
  "scope_key": "ikt_audit",
  "language": "de",
  "lead": "Erika Muster",
  "extra_scope_notes": "",
  "start_date": "2026-12-01",
  "end_date": "2026-12-15",
  "status": "draft",
  "allowed_transitions": [
    "preparing",
    "cancelled"
  ],
  "started_at": null,
  "finished_at": null,
  "findings_critical": 0,
  "findings_high": 1,
  "findings_medium": 2,
  "findings_low": 0,
  "content_locked": false
}
PATCH /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.13 ▶
Request
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"end_date": "2026-12-20"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
    "external_ref": "erp-au-1",
    "short_code": "AU-31",
    "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "name": "IKT-Audit ERP",
    "scope": "ERP und Anbindungen",
    "scope_key": "ikt_audit",
    "language": "de",
    "lead": "Erika Muster",
    "extra_scope_notes": "",
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "status": "draft",
    "allowed_transitions": [
      "preparing",
      "cancelled"
    ],
    "started_at": null,
    "finished_at": null,
    "findings_critical": 0,
    "findings_high": 1,
    "findings_medium": 2,
    "findings_low": 0,
    "content_locked": false
  }
}
DELETE /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.14 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response

POST /reseller/api/engagements/audits/<run_uuid>/status/ developers.api.ep.r-eng-runs.15 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/status/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"status": "preparing"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
    "external_ref": "erp-au-1",
    "short_code": "AU-31",
    "engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
    "name": "IKT-Audit ERP",
    "scope": "ERP und Anbindungen",
    "scope_key": "ikt_audit",
    "language": "de",
    "lead": "Erika Muster",
    "extra_scope_notes": "",
    "start_date": "2026-12-01",
    "end_date": "2026-12-15",
    "status": "preparing",
    "allowed_transitions": [
      "preparing",
      "cancelled"
    ],
    "started_at": null,
    "finished_at": null,
    "findings_critical": 0,
    "findings_high": 1,
    "findings_medium": 2,
    "findings_low": 0,
    "content_locked": false
  }
}

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

26 Endpoints

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

POST /reseller/api/engagements/pentests/<run_uuid>/apply-methodology/ developers.api.ep.r-eng-plan.0 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/apply-methodology/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "categories": [
      {
        "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "external_ref": "athn",
        "name": "Authentisierung",
        "description": "",
        "sort_order": 0,
        "topics": [
          {
            "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
            "external_ref": "wstg-athn-01",
            "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
            "title": "Standardkennwörter prüfen",
            "description": "",
            "tools": "hydra",
            "commands": "",
            "reference_id": "WSTG-ATHN-02",
            "severity_default": "high",
            "sort_order": 0,
            "status": "open",
            "notes": "",
            "finding": null,
            "results": []
          }
        ]
      }
    ]
  }
}
GET /reseller/api/engagements/pentests/<run_uuid>/categories/ developers.api.ep.r-eng-plan.1 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
Response
{
  "items": [
    {
      "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
      "external_ref": "athn",
      "name": "Authentisierung",
      "description": "",
      "sort_order": 0,
      "topics": [
        {
          "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
          "external_ref": "wstg-athn-01",
          "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
          "title": "Standardkennwörter prüfen",
          "description": "",
          "tools": "hydra",
          "commands": "",
          "reference_id": "WSTG-ATHN-02",
          "severity_default": "high",
          "sort_order": 0,
          "status": "open",
          "notes": "",
          "finding": null,
          "results": []
        }
      ]
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/categories/ developers.api.ep.r-eng-plan.2 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Authentisierung", "external_ref": "athn"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "external_ref": "athn",
    "name": "Authentisierung",
    "description": "",
    "sort_order": 0,
    "topics": [
      {
        "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
        "external_ref": "wstg-athn-01",
        "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "title": "Standardkennwörter prüfen",
        "description": "",
        "tools": "hydra",
        "commands": "",
        "reference_id": "WSTG-ATHN-02",
        "severity_default": "high",
        "sort_order": 0,
        "status": "open",
        "notes": "",
        "finding": null,
        "results": []
      }
    ]
  }
}
PUT /reseller/api/engagements/pentests/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.3 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Authentisierung"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "external_ref": "athn",
    "name": "Authentisierung",
    "description": "",
    "sort_order": 0,
    "topics": [
      {
        "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
        "external_ref": "wstg-athn-01",
        "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "title": "Standardkennwörter prüfen",
        "description": "",
        "tools": "hydra",
        "commands": "",
        "reference_id": "WSTG-ATHN-02",
        "severity_default": "high",
        "sort_order": 0,
        "status": "open",
        "notes": "",
        "finding": null,
        "results": []
      }
    ]
  }
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.4 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/
Response
{
  "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "external_ref": "athn",
  "name": "Authentisierung",
  "description": "",
  "sort_order": 0,
  "topics": [
    {
      "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
      "external_ref": "wstg-athn-01",
      "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
      "title": "Standardkennwörter prüfen",
      "description": "",
      "tools": "hydra",
      "commands": "",
      "reference_id": "WSTG-ATHN-02",
      "severity_default": "high",
      "sort_order": 0,
      "status": "open",
      "notes": "",
      "finding": null,
      "results": []
    }
  ]
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/ developers.api.ep.r-eng-plan.5 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/
Response
{
  "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "external_ref": "athn",
  "name": "Authentisierung",
  "description": "",
  "sort_order": 0,
  "topics": [
    {
      "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
      "external_ref": "wstg-athn-01",
      "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
      "title": "Standardkennwörter prüfen",
      "description": "",
      "tools": "hydra",
      "commands": "",
      "reference_id": "WSTG-ATHN-02",
      "severity_default": "high",
      "sort_order": 0,
      "status": "open",
      "notes": "",
      "finding": null,
      "results": []
    }
  ]
}
GET /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.6 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/
Response
{
  "items": [
    {
      "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
      "external_ref": "wstg-athn-01",
      "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
      "title": "Standardkennwörter prüfen",
      "description": "",
      "tools": "hydra",
      "commands": "",
      "reference_id": "WSTG-ATHN-02",
      "severity_default": "high",
      "sort_order": 0,
      "status": "open",
      "notes": "",
      "finding": null,
      "results": []
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.7 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Standardkennwörter prüfen", "severity_default": "high", "external_ref": "wstg-athn-01"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
    "external_ref": "wstg-athn-01",
    "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "title": "Standardkennwörter prüfen",
    "description": "",
    "tools": "hydra",
    "commands": "",
    "reference_id": "WSTG-ATHN-02",
    "severity_default": "high",
    "sort_order": 0,
    "status": "open",
    "notes": "",
    "finding": null,
    "results": []
  }
}
PUT /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.8 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Standardkennwörter prüfen"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
    "external_ref": "wstg-athn-01",
    "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "title": "Standardkennwörter prüfen",
    "description": "",
    "tools": "hydra",
    "commands": "",
    "reference_id": "WSTG-ATHN-02",
    "severity_default": "high",
    "sort_order": 0,
    "status": "open",
    "notes": "",
    "finding": null,
    "results": []
  }
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.9 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/
Response
{
  "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
  "external_ref": "wstg-athn-01",
  "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "title": "Standardkennwörter prüfen",
  "description": "",
  "tools": "hydra",
  "commands": "",
  "reference_id": "WSTG-ATHN-02",
  "severity_default": "high",
  "sort_order": 0,
  "status": "open",
  "notes": "",
  "finding": null,
  "results": []
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/ developers.api.ep.r-eng-plan.10 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/
Response
{
  "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
  "external_ref": "wstg-athn-01",
  "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "title": "Standardkennwörter prüfen",
  "description": "",
  "tools": "hydra",
  "commands": "",
  "reference_id": "WSTG-ATHN-02",
  "severity_default": "high",
  "sort_order": 0,
  "status": "open",
  "notes": "",
  "finding": null,
  "results": []
}
PUT /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/result/ developers.api.ep.r-eng-plan.11 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/result/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"status": "vulnerable", "note": "Anmeldung mit admin/admin möglich"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
    "external_ref": "wstg-athn-01",
    "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "title": "Standardkennwörter prüfen",
    "description": "",
    "tools": "hydra",
    "commands": "",
    "reference_id": "WSTG-ATHN-02",
    "severity_default": "high",
    "sort_order": 0,
    "status": "open",
    "notes": "",
    "finding": null,
    "results": []
  }
}
POST /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/raise-finding/ developers.api.ep.r-eng-plan.12 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/raise-finding/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
    "external_ref": null,
    "title": "Standardkennwort aktiv",
    "severity": "high",
    "status": "open"
  }
}
POST /reseller/api/engagements/audits/<run_uuid>/apply-template/ developers.api.ep.r-eng-plan.13 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/apply-template/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "categories": [
      {
        "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "external_ref": "athn",
        "name": "Authentisierung",
        "description": "",
        "sort_order": 0,
        "topics": [
          {
            "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
            "external_ref": "wstg-athn-01",
            "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
            "title": "Standardkennwörter prüfen",
            "description": "",
            "tools": "hydra",
            "commands": "",
            "reference_id": "WSTG-ATHN-02",
            "severity_default": "high",
            "sort_order": 0,
            "status": "open",
            "notes": "",
            "finding": null,
            "results": [],
            "purpose": "",
            "reference_kind": "",
            "customer_response": "",
            "customer_note": ""
          }
        ]
      }
    ]
  }
}
GET /reseller/api/engagements/audits/<run_uuid>/categories/ developers.api.ep.r-eng-plan.14 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
Response
{
  "items": [
    {
      "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
      "external_ref": "athn",
      "name": "Authentisierung",
      "description": "",
      "sort_order": 0,
      "topics": [
        {
          "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
          "external_ref": "wstg-athn-01",
          "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
          "title": "Standardkennwörter prüfen",
          "description": "",
          "tools": "hydra",
          "commands": "",
          "reference_id": "WSTG-ATHN-02",
          "severity_default": "high",
          "sort_order": 0,
          "status": "open",
          "notes": "",
          "finding": null,
          "results": [],
          "purpose": "",
          "reference_kind": "",
          "customer_response": "",
          "customer_note": ""
        }
      ]
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/categories/ developers.api.ep.r-eng-plan.15 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Zugriffssteuerung"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "external_ref": "athn",
    "name": "Authentisierung",
    "description": "",
    "sort_order": 0,
    "topics": [
      {
        "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
        "external_ref": "wstg-athn-01",
        "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "title": "Standardkennwörter prüfen",
        "description": "",
        "tools": "hydra",
        "commands": "",
        "reference_id": "WSTG-ATHN-02",
        "severity_default": "high",
        "sort_order": 0,
        "status": "open",
        "notes": "",
        "finding": null,
        "results": [],
        "purpose": "",
        "reference_kind": "",
        "customer_response": "",
        "customer_note": ""
      }
    ]
  }
}
PUT /reseller/api/engagements/audits/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.16 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Zugriffssteuerung"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "external_ref": "athn",
    "name": "Authentisierung",
    "description": "",
    "sort_order": 0,
    "topics": [
      {
        "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
        "external_ref": "wstg-athn-01",
        "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
        "title": "Standardkennwörter prüfen",
        "description": "",
        "tools": "hydra",
        "commands": "",
        "reference_id": "WSTG-ATHN-02",
        "severity_default": "high",
        "sort_order": 0,
        "status": "open",
        "notes": "",
        "finding": null,
        "results": [],
        "purpose": "",
        "reference_kind": "",
        "customer_response": "",
        "customer_note": ""
      }
    ]
  }
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.17 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/
Response
{
  "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "external_ref": "athn",
  "name": "Authentisierung",
  "description": "",
  "sort_order": 0,
  "topics": [
    {
      "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
      "external_ref": "wstg-athn-01",
      "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
      "title": "Standardkennwörter prüfen",
      "description": "",
      "tools": "hydra",
      "commands": "",
      "reference_id": "WSTG-ATHN-02",
      "severity_default": "high",
      "sort_order": 0,
      "status": "open",
      "notes": "",
      "finding": null,
      "results": [],
      "purpose": "",
      "reference_kind": "",
      "customer_response": "",
      "customer_note": ""
    }
  ]
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/ developers.api.ep.r-eng-plan.18 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/
Response
{
  "id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "external_ref": "athn",
  "name": "Authentisierung",
  "description": "",
  "sort_order": 0,
  "topics": [
    {
      "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
      "external_ref": "wstg-athn-01",
      "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
      "title": "Standardkennwörter prüfen",
      "description": "",
      "tools": "hydra",
      "commands": "",
      "reference_id": "WSTG-ATHN-02",
      "severity_default": "high",
      "sort_order": 0,
      "status": "open",
      "notes": "",
      "finding": null,
      "results": [],
      "purpose": "",
      "reference_kind": "",
      "customer_response": "",
      "customer_note": ""
    }
  ]
}
GET /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.19 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/
Response
{
  "items": [
    {
      "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
      "external_ref": "wstg-athn-01",
      "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
      "title": "Standardkennwörter prüfen",
      "description": "",
      "tools": "hydra",
      "commands": "",
      "reference_id": "WSTG-ATHN-02",
      "severity_default": "high",
      "sort_order": 0,
      "status": "open",
      "notes": "",
      "finding": null,
      "results": [],
      "purpose": "",
      "reference_kind": "",
      "customer_response": "",
      "customer_note": ""
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.20 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Rollenkonzept vorhanden"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
    "external_ref": "wstg-athn-01",
    "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "title": "Standardkennwörter prüfen",
    "description": "",
    "tools": "hydra",
    "commands": "",
    "reference_id": "WSTG-ATHN-02",
    "severity_default": "high",
    "sort_order": 0,
    "status": "open",
    "notes": "",
    "finding": null,
    "results": [],
    "purpose": "",
    "reference_kind": "",
    "customer_response": "",
    "customer_note": ""
  }
}
PUT /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.21 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Rollenkonzept vorhanden"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
    "external_ref": "wstg-athn-01",
    "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
    "title": "Standardkennwörter prüfen",
    "description": "",
    "tools": "hydra",
    "commands": "",
    "reference_id": "WSTG-ATHN-02",
    "severity_default": "high",
    "sort_order": 0,
    "status": "open",
    "notes": "",
    "finding": null,
    "results": [],
    "purpose": "",
    "reference_kind": "",
    "customer_response": "",
    "customer_note": ""
  }
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.22 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/
Response
{
  "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
  "external_ref": "wstg-athn-01",
  "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "title": "Standardkennwörter prüfen",
  "description": "",
  "tools": "hydra",
  "commands": "",
  "reference_id": "WSTG-ATHN-02",
  "severity_default": "high",
  "sort_order": 0,
  "status": "open",
  "notes": "",
  "finding": null,
  "results": [],
  "purpose": "",
  "reference_kind": "",
  "customer_response": "",
  "customer_note": ""
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/topics/<topic_uuid>/ developers.api.ep.r-eng-plan.23 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/
Response
{
  "id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
  "external_ref": "wstg-athn-01",
  "category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
  "title": "Standardkennwörter prüfen",
  "description": "",
  "tools": "hydra",
  "commands": "",
  "reference_id": "WSTG-ATHN-02",
  "severity_default": "high",
  "sort_order": 0,
  "status": "open",
  "notes": "",
  "finding": null,
  "results": [],
  "purpose": "",
  "reference_kind": "",
  "customer_response": "",
  "customer_note": ""
}
POST /reseller/api/engagements/audits/<run_uuid>/topics/<topic_uuid>/raise-finding/ developers.api.ep.r-eng-plan.24 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/raise-finding/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
    "external_ref": null,
    "title": "Standardkennwort aktiv",
    "severity": "high",
    "status": "open"
  }
}
GET /reseller/api/engagements/audits/<run_uuid>/questionnaire/pdf/ developers.api.ep.r-eng-plan.25 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o fragebogen.pdf https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/questionnaire/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="fragebogen.pdf"
X-Content-Type-Options: nosniff

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

24 Endpoints

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

GET /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
Response
{
  "items": [
    {
      "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
      "external_ref": "f-erp-01",
      "identifier": "F-01",
      "title": "Standardkennwort aktiv",
      "severity": "high",
      "status": "open",
      "vuln_type": "Authentisierung",
      "category": "",
      "description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
      "observation": "",
      "remediation": "Kennwort ändern",
      "remediation_complexity": "low",
      "priority": "",
      "references": "",
      "poc": "",
      "tools": "",
      "commands": "",
      "affected": "erp.murmelibach.example",
      "cve": "",
      "cwe": "CWE-1392",
      "wstg_id": "",
      "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
      "custom_fields": {},
      "cvss_score": 9.1,
      "cvss_severity": "critical"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.1 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Standardkennwort aktiv", "severity": "high", "affected": "erp.murmelibach.example", "external_ref": "f-erp-01"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
    "external_ref": "f-erp-01",
    "identifier": "F-01",
    "title": "Standardkennwort aktiv",
    "severity": "high",
    "status": "open",
    "vuln_type": "Authentisierung",
    "category": "",
    "description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
    "observation": "",
    "remediation": "Kennwort ändern",
    "remediation_complexity": "low",
    "priority": "",
    "references": "",
    "poc": "",
    "tools": "",
    "commands": "",
    "affected": "erp.murmelibach.example",
    "cve": "",
    "cwe": "CWE-1392",
    "wstg_id": "",
    "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
    "custom_fields": {},
    "cvss_score": 9.1,
    "cvss_severity": "critical"
  }
}
PUT /reseller/api/engagements/pentests/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.2 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Standardkennwort aktiv", "severity": "high", "affected": "erp.murmelibach.example", "external_ref": "f-erp-01"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
    "external_ref": "f-erp-01",
    "identifier": "F-01",
    "title": "Standardkennwort aktiv",
    "severity": "high",
    "status": "open",
    "vuln_type": "Authentisierung",
    "category": "",
    "description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
    "observation": "",
    "remediation": "Kennwort ändern",
    "remediation_complexity": "low",
    "priority": "",
    "references": "",
    "poc": "",
    "tools": "",
    "commands": "",
    "affected": "erp.murmelibach.example",
    "cve": "",
    "cwe": "CWE-1392",
    "wstg_id": "",
    "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
    "custom_fields": {},
    "cvss_score": 9.1,
    "cvss_severity": "critical"
  }
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.3 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/
Response
{
  "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
  "external_ref": "f-erp-01",
  "identifier": "F-01",
  "title": "Standardkennwort aktiv",
  "severity": "high",
  "status": "open",
  "vuln_type": "Authentisierung",
  "category": "",
  "description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
  "observation": "",
  "remediation": "Kennwort ändern",
  "remediation_complexity": "low",
  "priority": "",
  "references": "",
  "poc": "",
  "tools": "",
  "commands": "",
  "affected": "erp.murmelibach.example",
  "cve": "",
  "cwe": "CWE-1392",
  "wstg_id": "",
  "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
  "custom_fields": {},
  "cvss_score": 9.1,
  "cvss_severity": "critical"
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/ developers.api.ep.r-eng-findings.4 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/
Response
{
  "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
  "external_ref": "f-erp-01",
  "identifier": "F-01",
  "title": "Standardkennwort aktiv",
  "severity": "high",
  "status": "open",
  "vuln_type": "Authentisierung",
  "category": "",
  "description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
  "observation": "",
  "remediation": "Kennwort ändern",
  "remediation_complexity": "low",
  "priority": "",
  "references": "",
  "poc": "",
  "tools": "",
  "commands": "",
  "affected": "erp.murmelibach.example",
  "cve": "",
  "cwe": "CWE-1392",
  "wstg_id": "",
  "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
  "custom_fields": {},
  "cvss_score": 9.1,
  "cvss_severity": "critical"
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/status/ developers.api.ep.r-eng-findings.5 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/status/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"status": "fixed"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
    "external_ref": "f-erp-01",
    "identifier": "F-01",
    "title": "Standardkennwort aktiv",
    "severity": "high",
    "status": "fixed",
    "vuln_type": "Authentisierung",
    "category": "",
    "description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
    "observation": "",
    "remediation": "Kennwort ändern",
    "remediation_complexity": "low",
    "priority": "",
    "references": "",
    "poc": "",
    "tools": "",
    "commands": "",
    "affected": "erp.murmelibach.example",
    "cve": "",
    "cwe": "CWE-1392",
    "wstg_id": "",
    "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
    "custom_fields": {},
    "cvss_score": 9.1,
    "cvss_severity": "critical"
  }
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/ developers.api.ep.r-eng-findings.6 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
Response
{
  "items": [
    {
      "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
      "external_ref": "f-ikt-01",
      "title": "Kein Rollenkonzept",
      "severity": "medium",
      "status": "open",
      "description": "",
      "affected": "",
      "cve": "",
      "recommendation": "Rollenkonzept erstellen",
      "cvss_vector": "",
      "cvss_score": null,
      "cvss_severity": ""
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/ developers.api.ep.r-eng-findings.7 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Kein Rollenkonzept"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
    "external_ref": "f-ikt-01",
    "title": "Kein Rollenkonzept",
    "severity": "medium",
    "status": "open",
    "description": "",
    "affected": "",
    "cve": "",
    "recommendation": "Rollenkonzept erstellen",
    "cvss_vector": "",
    "cvss_score": null,
    "cvss_severity": ""
  }
}
PUT /reseller/api/engagements/audits/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.8 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Kein Rollenkonzept"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
    "external_ref": "f-ikt-01",
    "title": "Kein Rollenkonzept",
    "severity": "medium",
    "status": "open",
    "description": "",
    "affected": "",
    "cve": "",
    "recommendation": "Rollenkonzept erstellen",
    "cvss_vector": "",
    "cvss_score": null,
    "cvss_severity": ""
  }
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.9 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/
Response
{
  "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
  "external_ref": "f-ikt-01",
  "title": "Kein Rollenkonzept",
  "severity": "medium",
  "status": "open",
  "description": "",
  "affected": "",
  "cve": "",
  "recommendation": "Rollenkonzept erstellen",
  "cvss_vector": "",
  "cvss_score": null,
  "cvss_severity": ""
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/ developers.api.ep.r-eng-findings.10 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/
Response
{
  "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
  "external_ref": "f-ikt-01",
  "title": "Kein Rollenkonzept",
  "severity": "medium",
  "status": "open",
  "description": "",
  "affected": "",
  "cve": "",
  "recommendation": "Rollenkonzept erstellen",
  "cvss_vector": "",
  "cvss_score": null,
  "cvss_severity": ""
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/status/ developers.api.ep.r-eng-findings.11 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/status/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"status": "accepted"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
    "external_ref": "f-ikt-01",
    "title": "Kein Rollenkonzept",
    "severity": "medium",
    "status": "accepted",
    "description": "",
    "affected": "",
    "cve": "",
    "recommendation": "Rollenkonzept erstellen",
    "cvss_vector": "",
    "cvss_score": null,
    "cvss_severity": ""
  }
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.12 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/
Response
{
  "items": [
    {
      "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "external_ref": "login-png",
      "filename": "login.png",
      "caption": "Anmeldemaske",
      "sort_order": 0,
      "is_image": true,
      "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
      "created_at": "2026-11-16T09:30:00+00:00"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.13 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -F "[email protected]" \
  -F "caption=Anmeldemaske" \
  -F "external_ref=login-png"
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "external_ref": "login-png",
    "filename": "login.png",
    "caption": "Anmeldemaske",
    "sort_order": 0,
    "is_image": true,
    "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
    "created_at": "2026-11-16T09:30:00+00:00"
  }
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.14 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -F "[email protected]" \
  -F "caption=Anmeldemaske"
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "external_ref": "login-png",
    "filename": "login.png",
    "caption": "Anmeldemaske",
    "sort_order": 0,
    "is_image": true,
    "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
    "created_at": "2026-11-16T09:30:00+00:00"
  }
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.15 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "external_ref": "login-png",
  "filename": "login.png",
  "caption": "Anmeldemaske",
  "sort_order": 0,
  "is_image": true,
  "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
  "created_at": "2026-11-16T09:30:00+00:00"
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/ developers.api.ep.r-eng-findings.16 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "external_ref": "login-png",
  "filename": "login.png",
  "caption": "Anmeldemaske",
  "sort_order": 0,
  "is_image": true,
  "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
  "created_at": "2026-11-16T09:30:00+00:00"
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/file/ developers.api.ep.r-eng-findings.17 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o login.png https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/
Response
HTTP/1.1 200 OK
Content-Type: image/png
Content-Disposition: attachment; filename="login.png"
X-Content-Type-Options: nosniff
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.18 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/
Response
{
  "items": [
    {
      "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "external_ref": "login-png",
      "filename": "login.png",
      "caption": "Anmeldemaske",
      "sort_order": 0,
      "is_image": true,
      "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
      "created_at": "2026-11-16T09:30:00+00:00"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.19 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -F "[email protected]" \
  -F "caption=Anmeldemaske" \
  -F "external_ref=login-png"
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "external_ref": "login-png",
    "filename": "login.png",
    "caption": "Anmeldemaske",
    "sort_order": 0,
    "is_image": true,
    "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
    "created_at": "2026-11-16T09:30:00+00:00"
  }
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.20 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -F "[email protected]" \
  -F "caption=Anmeldemaske"
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "external_ref": "login-png",
    "filename": "login.png",
    "caption": "Anmeldemaske",
    "sort_order": 0,
    "is_image": true,
    "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
    "created_at": "2026-11-16T09:30:00+00:00"
  }
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.21 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "external_ref": "login-png",
  "filename": "login.png",
  "caption": "Anmeldemaske",
  "sort_order": 0,
  "is_image": true,
  "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
  "created_at": "2026-11-16T09:30:00+00:00"
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/ developers.api.ep.r-eng-findings.22 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "external_ref": "login-png",
  "filename": "login.png",
  "caption": "Anmeldemaske",
  "sort_order": 0,
  "is_image": true,
  "file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
  "created_at": "2026-11-16T09:30:00+00:00"
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/file/ developers.api.ep.r-eng-findings.23 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o login.png https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/
Response
HTTP/1.1 200 OK
Content-Type: image/png
Content-Disposition: attachment; filename="login.png"
X-Content-Type-Options: nosniff

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

26 Endpoints

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

GET /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
Response
{
  "items": [
    {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "external_ref": "erp-report",
      "title": "Pentest-Report ERP 2026",
      "language": "de",
      "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "status": "draft",
      "run": {
        "kind": "pentest",
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
      },
      "generated_at": null,
      "finalized_at": null,
      "delivered_at": null,
      "delivered_to": "",
      "delivered_note": "",
      "docx": null,
      "pdf": null,
      "created_at": "2026-11-16T10:00:00+00:00"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.1 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "draft",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": null,
    "delivered_at": null,
    "delivered_to": "",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
PUT /reseller/api/engagements/pentests/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.2 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "draft",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": null,
    "delivered_at": null,
    "delivered_to": "",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.3 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/
Response
{
  "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
  "external_ref": "erp-report",
  "title": "Pentest-Report ERP 2026",
  "language": "de",
  "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "status": "draft",
  "run": {
    "kind": "pentest",
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
  },
  "generated_at": null,
  "finalized_at": null,
  "delivered_at": null,
  "delivered_to": "",
  "delivered_note": "",
  "docx": null,
  "pdf": null,
  "created_at": "2026-11-16T10:00:00+00:00"
}
GET /reseller/api/engagements/audits/<run_uuid>/reports/ developers.api.ep.r-eng-reports.4 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
Response
{
  "items": [
    {
      "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
      "external_ref": "erp-report",
      "title": "Pentest-Report ERP 2026",
      "language": "de",
      "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "status": "draft",
      "run": {
        "kind": "pentest",
        "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
      },
      "generated_at": null,
      "finalized_at": null,
      "delivered_at": null,
      "delivered_to": "",
      "delivered_note": "",
      "docx": null,
      "pdf": null,
      "created_at": "2026-11-16T10:00:00+00:00"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/reports/ developers.api.ep.r-eng-reports.5 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "draft",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": null,
    "delivered_at": null,
    "delivered_to": "",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
PUT /reseller/api/engagements/audits/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.6 ▶
Request
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "draft",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": null,
    "delivered_at": null,
    "delivered_to": "",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.7 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/
Response
{
  "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
  "external_ref": "erp-report",
  "title": "Pentest-Report ERP 2026",
  "language": "de",
  "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "status": "draft",
  "run": {
    "kind": "pentest",
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
  },
  "generated_at": null,
  "finalized_at": null,
  "delivered_at": null,
  "delivered_to": "",
  "delivered_note": "",
  "docx": null,
  "pdf": null,
  "created_at": "2026-11-16T10:00:00+00:00"
}
GET /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.8 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
Response
{
  "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
  "external_ref": "erp-report",
  "title": "Pentest-Report ERP 2026",
  "language": "de",
  "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "status": "draft",
  "run": {
    "kind": "pentest",
    "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
  },
  "generated_at": null,
  "finalized_at": null,
  "delivered_at": null,
  "delivered_to": "",
  "delivered_note": "",
  "docx": null,
  "pdf": null,
  "created_at": "2026-11-16T10:00:00+00:00"
}
PATCH /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.9 ▶
Request
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Report ERP, Fassung 2"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "draft",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": null,
    "delivered_at": null,
    "delivered_to": "",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
DELETE /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.10 ▶
Request
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
Response

GET /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.11 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/
Response
{
  "items": [
    {
      "id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
      "kind": "custom",
      "heading": "Management Summary",
      "body": "<p>Text</p>",
      "sort_order": 0,
      "created_at": "2026-11-16T10:05:00+00:00"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
POST /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.12 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"heading": "Management Summary", "body": "<p>Text</p>"}'
Response
{
  "ok": true,
  "result": "created",
  "notices": [],
  "data": {
    "id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
    "kind": "custom",
    "heading": "Management Summary",
    "body": "<p>Text</p>",
    "sort_order": 0,
    "created_at": "2026-11-16T10:05:00+00:00"
  }
}
GET/PATCH/DELETE /reseller/api/engagements/reports/<report_uuid>/sections/<section_uuid>/ developers.api.ep.r-eng-reports.13 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82/
Response
{
  "id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
  "kind": "custom",
  "heading": "Management Summary",
  "body": "<p>Text</p>",
  "sort_order": 0,
  "created_at": "2026-11-16T10:05:00+00:00"
}
POST /reseller/api/engagements/reports/<report_uuid>/finalize/ developers.api.ep.r-eng-reports.14 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/finalize/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "final",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": "2026-11-17T08:00:00+00:00",
    "delivered_at": null,
    "delivered_to": "",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
POST /reseller/api/engagements/reports/<report_uuid>/unfinalize/ developers.api.ep.r-eng-reports.15 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/unfinalize/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "draft",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": null,
    "delivered_at": null,
    "delivered_to": "",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
POST /reseller/api/engagements/reports/<report_uuid>/deliver/ developers.api.ep.r-eng-reports.16 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/deliver/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"delivered_to": "[email protected]", "delivered_at": "2026-11-18", "note": "Per verschlüsselter Mail"}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "delivered",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": "2026-11-17T08:00:00+00:00",
    "delivered_at": null,
    "delivered_to": "[email protected]",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
POST /reseller/api/engagements/reports/<report_uuid>/undeliver/ developers.api.ep.r-eng-reports.17 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/undeliver/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "updated",
  "notices": [],
  "data": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "external_ref": "erp-report",
    "title": "Pentest-Report ERP 2026",
    "language": "de",
    "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
    "status": "final",
    "run": {
      "kind": "pentest",
      "id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
    },
    "generated_at": null,
    "finalized_at": "2026-11-17T08:00:00+00:00",
    "delivered_at": null,
    "delivered_to": "",
    "delivered_note": "",
    "docx": null,
    "pdf": null,
    "created_at": "2026-11-16T10:00:00+00:00"
  }
}
GET /reseller/api/engagements/reports/<report_uuid>/files/docx/ developers.api.ep.r-eng-reports.18 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o report.docx https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/docx/
Response
HTTP/1.1 200 OK
Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Content-Disposition: attachment; filename="report.docx"
X-Content-Type-Options: nosniff
GET /reseller/api/engagements/reports/<report_uuid>/files/pdf/ developers.api.ep.r-eng-reports.19 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o report.pdf https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="report.pdf"
X-Content-Type-Options: nosniff
GET /reseller/api/engagements/reports/<report_uuid>/versions/ developers.api.ep.r-eng-reports.20 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/
Response
{
  "items": [
    {
      "id": "7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13",
      "sha256": "9f2c…e41a",
      "status_at_time": "final",
      "finalized_at": "2026-11-17T08:00:00+00:00",
      "delivered_at": null,
      "delivered_to": "",
      "created_by": "Integration ERP",
      "created_at": "2026-11-17T08:00:00+00:00",
      "docx": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13/docx/"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
GET /reseller/api/engagements/reports/<report_uuid>/versions/<version_uuid>/docx/ developers.api.ep.r-eng-reports.21 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -o report-v1.docx https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13/docx/
Response
HTTP/1.1 200 OK
Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Content-Disposition: attachment; filename="report-v1.docx"
X-Content-Type-Options: nosniff
POST /reseller/api/engagements/<uuid>/ai-draft/ developers.api.ep.r-eng-reports.22 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ai-draft/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "accepted",
  "data": {
    "id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
    "kind": "report_generate",
    "status": "queued",
    "target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "result": null,
    "error": null,
    "created_at": "2026-11-17T08:10:00+00:00",
    "finished_at": null
  }
}
POST /reseller/api/engagements/reports/<report_uuid>/sections/<section_uuid>/ai-text/ developers.api.ep.r-eng-reports.23 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82/ai-text/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{"target": "body", "instruction": "Kürzer und für die Geschäftsleitung formulieren"}'
Response
{
  "ok": true,
  "result": "accepted",
  "data": {
    "id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
    "kind": "report_generate",
    "status": "queued",
    "target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "result": null,
    "error": null,
    "created_at": "2026-11-17T08:10:00+00:00",
    "finished_at": null
  }
}
POST /reseller/api/engagements/reports/<report_uuid>/generate/ developers.api.ep.r-eng-reports.24 ▶
Request
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/generate/ \
  -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "result": "accepted",
  "data": {
    "id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
    "kind": "report_generate",
    "status": "queued",
    "target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "result": null,
    "error": null,
    "created_at": "2026-11-17T08:10:00+00:00",
    "finished_at": null
  }
}
GET /reseller/api/engagements/jobs/<job_uuid>/ developers.api.ep.r-eng-reports.25 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/jobs/0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53/
Response
{
  "ok": true,
  "data": {
    "id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
    "kind": "report_generate",
    "status": "done",
    "target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "result": {
      "docx": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/docx/",
      "pdf": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/pdf/"
    },
    "error": null,
    "created_at": "2026-11-17T08:10:00+00:00",
    "finished_at": null
  }
}

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

10 Endpoints

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

GET /reseller/api/engagements/library/roe-templates/ developers.api.ep.r-eng-library.0 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/
Response
{
  "items": [
    {
      "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "is_system": true,
      "updated_at": "2026-10-01T08:00:00+00:00",
      "name": "Interner Pentest",
      "description": "",
      "pentest_type": "internal",
      "translations": {}
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
GET /reseller/api/engagements/library/roe-templates/<uuid>/ developers.api.ep.r-eng-library.1 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "is_system": true,
  "updated_at": "2026-10-01T08:00:00+00:00",
  "name": "Interner Pentest",
  "description": "",
  "pentest_type": "internal",
  "translations": {}
}
GET /reseller/api/engagements/library/methodologies/ developers.api.ep.r-eng-library.2 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/methodologies/
Response
{
  "items": [
    {
      "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "is_system": true,
      "updated_at": "2026-10-01T08:00:00+00:00",
      "name": "IKT-Minimalstandard",
      "description": ""
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
GET /reseller/api/engagements/library/methodologies/<uuid>/ developers.api.ep.r-eng-library.3 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/methodologies/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "is_system": true,
  "updated_at": "2026-10-01T08:00:00+00:00",
  "name": "IKT-Minimalstandard",
  "description": ""
}
GET /reseller/api/engagements/library/audit-templates/ developers.api.ep.r-eng-library.4 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/
Response
{
  "items": [
    {
      "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "is_system": true,
      "updated_at": "2026-10-01T08:00:00+00:00",
      "name": "IKT-Minimalstandard",
      "description": ""
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
GET /reseller/api/engagements/library/audit-templates/<uuid>/ developers.api.ep.r-eng-library.5 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "is_system": true,
  "updated_at": "2026-10-01T08:00:00+00:00",
  "name": "IKT-Minimalstandard",
  "description": ""
}
GET /reseller/api/engagements/library/report-templates/ developers.api.ep.r-eng-library.6 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/report-templates/
Response
{
  "items": [
    {
      "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "is_system": true,
      "updated_at": "2026-10-01T08:00:00+00:00",
      "name": "Pentest-Report Standard",
      "description": ""
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
GET /reseller/api/engagements/library/report-templates/<uuid>/ developers.api.ep.r-eng-library.7 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/report-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "is_system": true,
  "updated_at": "2026-10-01T08:00:00+00:00",
  "name": "Pentest-Report Standard",
  "description": ""
}
GET /reseller/api/engagements/library/vulnerabilities/ developers.api.ep.r-eng-library.8 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/
Response
{
  "items": [
    {
      "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
      "is_system": true,
      "updated_at": "2026-10-01T08:00:00+00:00",
      "title": "Standardkennwörter",
      "severity": "high",
      "cwe": "CWE-1392",
      "cvss_score": "9.1"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1,
  "has_next": false
}
GET /reseller/api/engagements/library/vulnerabilities/<uuid>/ developers.api.ep.r-eng-library.9 ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
Response
{
  "id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
  "is_system": true,
  "updated_at": "2026-10-01T08:00:00+00:00",
  "title": "Standardkennwörter",
  "severity": "high",
  "cwe": "CWE-1392",
  "cvss_score": "9.1"
}

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.

200 Successo
201 Creato con successo
202 Accettato, non ancora completato (interrogare di nuovo)
400 Richiesta non valida
401 Non autenticato
403 Nessuna autorizzazione
404 Non trovato
405 Metodo non consentito
409 Conflitto con lo stato attuale (ad es. già in corso, bloccato)
410 Endpoint rimosso
429 Limite di frequenza raggiunto
500 Errore interno del server
503 Servizio temporaneamente non disponibile (IA, generazione PDF, worker di rendering)

Limiti di frequenza & note.

  • 100 richieste / min per token. In caso di superamento viene restituito un 429 con header Retry-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_size nella specifica OpenAPI supportano ?page= e ?page_size= (predefinito 50, max. 200). Con la paginazione la risposta contiene inoltre page, 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.

Supporto sviluppatori
[email protected]

Domande tecniche sull'API. Risposta di regola entro un giorno lavorativo.

Contatto generale
[email protected]

Vendite, demo, richieste partner. Risposta di regola entro un giorno lavorativo.