Developer & API. Integrate CyberTell into your infrastructure.

REST API and OpenAPI specification for security operations. Three portals, one vocabulary — company, individuals, reseller.

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

Company(B2B)

Security operations platform for companies — every module enabled for the company through one API.

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

Individuals

Personal cyber security portal — account, checks and learning content through one API.

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

Reseller/ Insurance

Partner management portal for resellers, insurers and municipalities. Manage all assigned companies and individuals.

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

Overview.

CyberTell provides a comprehensive REST API organised into three portals. Each portal has its own authentication and endpoints. All responses are JSON. All timestamps are UTC (ISO 8601).

Authentication.

All three portals authenticate the same way: with an API key as a bearer token. Each portal has its own keys, and each key only covers the scopes chosen when it was created.

API Key Company · Reseller · Individuals Bearer

Create an API key in the respective portal: company under Profile → API keys, reseller under API → API keys (admins only), individuals under Profile → API keys. The key has the form ctk_<id>_<secret> and is shown only once. Send it with every request as Authorization: Bearer <key>.

# Use the API key from your profile
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/employees/

Scopes: company keys are granted modules, reseller keys customers and billing, individual keys profile, data leaks, incidents and courses. An endpoint outside the scope answers 403, an invalid, expired or deactivated key 401.

Company: admin endpoints such as campaigns, fleet, roles and locations also check the key's module scope. Billing and corporate design (/company/api/billing/, /company/api/layout/) require the Company account scope, which only company admins can grant to a key.

Older company keys: access key pairs (Authorization: CTAK <id>:<secret>) and static keys of 64 hex characters keep working for now. The X-Company-UUID header is no longer required; if you send it, it must name the right company. New keys are always ctk_ keys.

Companies running their own instance replace the host with their instance address – the paths stay the same.

Company API (B2B)

All endpoints require a company API key in the Authorization header (Bearer ctk_…), granted for the endpoint's module.

Auth & login

2 Endpoints
GET /company/tickets/api/me/ Current user ▶
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/ Change account language ▶
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"
}

Employees & administration

14 Endpoints
GET /company/api/employees/ List all employees ▶
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/ Create employee ▶
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>/ Read, update or deactivate an employee (DELETE sets 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/ Send invitation ▶
Request
curl -X POST https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/invite/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
  "invitation_sent": true
}
GET/POST /company/api/roles/ List / create roles ▶
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>/ Update or delete role ▶
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/ List locations ▶
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/ Create location ▶
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>/ Location detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/locations/a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d/
Response
{
  "id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
  "name": "Hauptsitz Murmelibach",
  "street": "Dorfstrasse 12",
  "zip_code": "3000",
  "city": "Murmelibach",
  "country_code": "ch",
  "description": "",
  "notes": "",
  "location_types": [{"id": 1, "name": "Büro", "key": "office"}],
  "employee_count": 24,
  "has_servers": true,
  "has_network_infrastructure": true,
  "has_physical_security": true,
  "has_backup_power": false,
  "has_fire_suppression": false,
  "has_access_control": true,
  "ai_risk_level": "",
  "ai_risk_analysis": "",
  "created_at": "2026-01-12T09:00:00+00:00",
  "updated_at": "2026-05-02T10:00:00+00:00"
}
GET /company/api/location-types/ Location types ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/location-types/
Response
{
  "types": [
    { "id": 1, "name": "Büro", "key": "office" },
    { "id": 2, "name": "Rechenzentrum", "key": "datacenter" }
  ]
}
GET /company/api/billing/ Billing information ▶
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/ Document layout (logo / CI) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/layout/
Response
{
  "accent_color": "#1f6f4a",
  "font_family": "",
  "heading_font_family": "",
  "confidentiality_text": "Vertraulich",
  "footer_text": "",
  "cover_variant": "classic",
  "accent_line": "left",
  "logo_position": "right",
  "watermark_text": "",
  "margin_preset": "normal",
  "show_toc": true,
  "show_changelog": true,
  "updated_at": "2026-04-02T10:00:00+00:00"
}
GET /company/tabletop/api/company-profile/ Read company profile (with choice lists) ▶
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/ Update company profile ▶
Request
curl -X POST https://portal.cybertell.io/company/tabletop/api/company-profile/update/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"company_title": "Murmelibach AG", "industry": "finance", "company_size": "11-50", "critical_assets": "Kundendaten, Zahlungsverkehr", "default_language": "de", "country_code": "ch"}'
Response
{
  "company_title": "Murmelibach AG",
  "industry": "finance",
  "industry_label": "Finanzdienstleistung",
  "company_size": "11-50",
  "company_size_label": "11–50 Mitarbeiter",
  "description": "",
  "it_landscape": "",
  "critical_assets": "Kundendaten, Zahlungsverkehr",
  "compliance_notes": "",
  "country": "Schweiz",
  "country_code": "ch",
  "country_label": "Schweiz",
  "website": "",
  "default_language": "de",
  "logo_url": "",
  "domains": [],
  "industry_choices": [],
  "company_size_choices": [],
  "country_choices": [],
  "language_choices": []
}

Phishing campaigns

3 Endpoints
GET /company/api/campaigns/ List campaigns ▶
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/ Create campaign as draft (launch in the web portal) ▶
Request
curl -X POST https://portal.cybertell.io/company/api/campaigns/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q2 Awareness", "template_id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "smtp_profile_id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "landing_page_id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24"}'
Response
{
  "id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
  "name": "Q2 Awareness"
}
GET /company/api/campaigns/options/ Templates & options ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/campaigns/options/
Response
{
  "templates": [
    { "id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "name": "Paket-Benachrichtigung" }
  ],
  "smtp_profiles": [
    { "id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "name": "Standard-SMTP" }
  ],
  "landing_pages": [
    { "id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24", "name": "Login-Seite" }
  ]
}

Incidents & tickets

11 Endpoints
GET /company/tickets/api/list/ Ticket list (filter: ?status=, ?category=, ?type=employee|incident, ?q=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/list/?status=offen&category=phishing
Response
{
  "tickets": [
    {
      "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
      "title": "Verdächtige E-Mail",
      "category": "phishing",
      "category_display": "Phishing-Verdacht",
      "ticket_type": "meldung",
      "type_display": "Meldung",
      "status": "offen",
      "status_display": "Offen",
      "priority": "hoch",
      "priority_display": "Hoch",
      "is_serious_incident": false,
      "created_at": "2026-05-15T09:30:00+00:00",
      "updated_at": "2026-05-16T07:10:00+00:00",
      "message_count": 2
    }
  ],
  "total_count": 1
}
POST /company/tickets/api/create/ Create 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/ Options for new tickets ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/options/
Response
{
  "categories": [
    { "value": "frage", "label": "Frage" },
    { "value": "phishing", "label": "Phishing-Verdacht" },
    { "value": "sonstiges", "label": "Sonstiges" }
  ],
  "ticket_types": [
    { "value": "meldung", "label": "Meldung" },
    { "value": "vorfall", "label": "Vorfall" }
  ],
  "priorities": [
    { "value": "niedrig", "label": "Niedrig" },
    { "value": "mittel", "label": "Mittel" },
    { "value": "hoch", "label": "Hoch" },
    { "value": "kritisch", "label": "Kritisch" }
  ],
  "defaults": { "category": "sonstiges", "ticket_type": "meldung", "priority": "mittel" }
}
GET /company/tickets/api/<uuid>/ Ticket detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/
Response
{
  "ticket": {
    "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
    "title": "Verdächtige E-Mail",
    "description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.",
    "category": "phishing",
    "category_display": "Phishing-Verdacht",
    "ticket_type": "meldung",
    "type_display": "Meldung",
    "status": "offen",
    "status_display": "Offen",
    "priority": "hoch",
    "priority_display": "Hoch",
    "is_serious_incident": false,
    "created_by": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "email": "[email protected]" },
    "assigned_to": null,
    "participants": [],
    "description_edited_at": null,
    "can_edit": true,
    "escalated_by": null,
    "created_at": "2026-05-15T09:30:00+00:00",
    "updated_at": "2026-05-16T07:10:00+00:00",
    "closed_at": null,
    "escalated_at": null,
    "messages": [
      {
        "id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
        "author": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]" },
        "body": "Bitte E-Mail nicht öffnen, wir prüfen.",
        "is_internal": false,
        "created_at": "2026-05-16T07:10:00+00:00",
        "edited_at": null,
        "mentioned": [],
        "attachments": []
      }
    ],
    "attachments": []
  }
}
POST /company/tickets/api/<uuid>/reply/ Send reply ▶
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/ Change status ▶
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/ Change priority ▶
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/ Assign a ticket to a person (admin; empty = remove assignment) ▶
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/ Edit title/description or an own message (with 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/ Search people for @ mentions (?q=, without email addresses) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/mentionable/?q=an
Response
{
  "results": [
    { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "is_admin": false }
  ]
}
GET /company/tickets/api/dashboard/ Dashboard statistics ▶
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/ Tactics with techniques and coverage by own tickets and news ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/mitre/api/mobile/
Response
{
  "tactics": [
    {
      "tactic_id": "TA0001",
      "name": "Initial Access",
      "technique_count": 1,
      "techniques": [
        { "technique_id": "T1566", "name": "Phishing", "is_subtechnique": false, "ticket_count": 3, "news_count": 12 }
      ]
    }
  ],
  "technique_total": 211,
  "technique_covered": 18
}
GET /company/tickets/mitre/api/mobile/<technique_id>/ One technique with linked tickets and news (up to 20 each) ▶
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/ List war rooms ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/warrooms/?status=aktiv
Response
{
  "warrooms": [
    {
      "id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
      "title": "Ransomware-Vorfall",
      "description": "Fileserver FS01 verschlüsselt.",
      "status": "aktiv",
      "status_display": "Aktiv",
      "external_link": "",
      "external_link_label": "Video-Call",
      "participant_count": 5,
      "message_count": 12,
      "created_at": "2026-05-16T09:00:00+00:00",
      "closed_at": null
    }
  ]
}
POST /company/tickets/api/warrooms/create/ Create 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>/ War room detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/
Response
{
  "id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
  "title": "Ransomware-Vorfall",
  "description": "Fileserver FS01 verschlüsselt.",
  "status": "aktiv",
  "status_display": "Aktiv",
  "external_link": "",
  "external_link_label": "Video-Call",
  "participants": [
    { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "initials": "MM", "is_admin": true }
  ],
  "tickets": [
    { "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen" }
  ],
  "playbooks": [
    { "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response" }
  ],
  "messages": [
    {
      "id": 501,
      "author_id": 42,
      "author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "author_name": "Max Muster",
      "author_initials": "MM",
      "author_avatar_url": "",
      "body": "Systeme isoliert.",
      "created_at": "16.05.2026 10:00",
      "created_at_iso": "2026-05-16T10:00:00+00:00",
      "attachments": []
    }
  ],
  "created_at": "2026-05-16T09:00:00+00:00",
  "closed_at": null
}
GET /company/tickets/warroom/<uuid>/api/messages/ Fetch messages (polling) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/messages/?after=500
Response
{
  "messages": [
    {
      "id": 501,
      "author_id": 42,
      "author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "author_name": "Max Muster",
      "author_initials": "MM",
      "author_avatar_url": "",
      "body": "Systeme isoliert.",
      "created_at": "16.05.2026 10:00",
      "attachments": []
    }
  ]
}
POST /company/tickets/warroom/<uuid>/api/send/ Send message ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/send/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"body": "Backups werden geprüft."}'
Response
{
  "id": 502,
  "author_id": 42,
  "author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
  "author_name": "Max Muster",
  "author_initials": "MM",
  "author_avatar_url": "",
  "body": "Backups werden geprüft.",
  "created_at": "16.05.2026 10:05",
  "attachments": []
}
GET/POST /company/tickets/api/warrooms/<uuid>/participants/ Read, invite or remove participants ▶
Request
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/participants/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"add": ["c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"], "remove": [], "add_groups": []}'
Response
{
  "participants": [
    {
      "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "name": "Max Muster",
      "initials": "MM",
      "is_admin": true
    }
  ],
  "employees": [
    {
      "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
      "name": "Max Muster",
      "initials": "MM",
      "is_admin": true,
      "is_participant": true,
      "group_ids": ["b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01"]
    }
  ],
  "groups": [
    { "id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01", "name": "Werkstatt" }
  ],
  "can_manage": true
}

Dark Web Monitoring

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

Phishing analysis (EML)

2 Endpoints
POST /company/tickets/analysis/api/upload/ Upload EML file ▶
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/ Analysis list ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/analysis/api/list/
Response
{
  "analyses": [
    {
      "id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
      "subject": "Ihr Konto wurde gesperrt",
      "sender": "[email protected]",
      "risk_score": 85,
      "vt_status": "done",
      "ai_status": "done",
      "created_at": "2026-05-15T18:20:00+00:00"
    }
  ]
}

Mail plugin (phishing indicators)

3 Endpoints

API for the Apple Mail plugin for automatic phishing detection. Indicators are extracted from confirmed phishing analyses.

GET /company/tickets/api/mail-plugin/indicators/ Fetch phishing indicators (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/ Check email against indicators ▶
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>/ Analysis detail for popup ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/tickets/api/mail-plugin/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/
Response
{
  "id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
  "sender": "[email protected]",
  "subject": "Ihr Konto wurde gesperrt",
  "risk_score": 85,
  "risk_label": "Hoch",
  "spf": "fail",
  "dkim": "none",
  "dmarc": "fail",
  "malicious_urls": ["https://paypa1.com/login"],
  "ai_category": "Phishing",
  "ai_assessment": "KATEGORIE: Phishing\n- Domain 2 Tage alt\nEMPFEHLUNG: Nicht öffnen.",
  "ai_indicators": ["Domain 2 Tage alt"],
  "ai_recommendation": "Nicht öffnen.",
  "analysed_at": "2026-05-15T18:20:00+00:00",
  "analysed_by": "Max Muster"
}

Awareness videos

7 Endpoints
GET /company/videos/api/list/ Video list ▶
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/ Generate awareness video (AI; optional: tone, address_form, length_preset, slide_count, style_template, setting, tts_voice, tts_speed) ▶
Request
curl -X POST https://portal.cybertell.io/company/videos/api/generate/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Sicheres Homeoffice", "language": "de", "enable_tts": false, "video_format": "landscape", "extra_notes": ""}'
Response
{
  "job_id": "f7b9d1e3-5d7a-4f02-9c38-4e6a8b0d2f35",
  "status": "generating"
}
GET /company/videos/api/<uuid>/ Video detail including slides ▶
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/ Trigger rendering again ▶
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/ Load MP4 for the 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/ Delete 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/ Report watched seconds (completion tracking) ▶
Request
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/progress/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"watched": 73, "duration": 92, "ended": false}'
Response
{
  "progress_pct": 79,
  "completed": false
}

Asset register

5 Endpoints

Reading requires the module on the key; create, update and delete for company admins only.

GET /company/assets/api/list/ Assets with risk assessment ▶
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/ Create 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>/ Asset detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
Response
{
  "id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
  "name": "Fileserver FS01",
  "asset_type": "system",
  "asset_type_display": "System / Server",
  "status": "active",
  "status_display": "Aktiv",
  "criticality": "high",
  "criticality_display": "Hoch",
  "confidentiality": "high",
  "integrity": "medium",
  "availability": "high",
  "owner_name": "Max Muster",
  "owner_email": "[email protected]",
  "supplier": {
    "id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
    "name": "Wolkensoftware Eidgenossenschaft"
  },
  "status_page_url": "",
  "provider_status": {
    "state": "degraded",
    "label": "Beeinträchtigt",
    "summary": "Verzögerte Zustellung",
    "disrupted": true,
    "since": "2026-05-02T09:40:00+00:00",
    "checked_at": "2026-05-02T10:00:00+00:00"
  },
  "renews_on": "2027-01-31",
  "renewal_state": "ok",
  "auto_renew": true,
  "payment_method": "invoice",
  "payment_method_display": "Rechnung",
  "description": "Zentraler Dateiserver",
  "notes": "",
  "renewal_cycle": "yearly",
  "renewal_cycle_display": "Jährlich",
  "payment_note": "",
  "provider_account": "",
  "risks": [],
  "updated_at": "2026-05-02T10:00:00+00:00"
}
GET/POST /company/assets/api/<uuid>/risks/ List or create the risks of an 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>/ Read, change or delete a risk; accepted: true accepts it ▶
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"
}

Third parties (suppliers)

3 Endpoints

Reading requires the module on the key; create, update and delete for company admins only.

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

ICT assessment

7 Endpoints

Reading requires the module on the key; create, update and delete for company admins only.

GET /company/ict/api/list/ List assessments (?include_auto=1 includes the CyberTell mirror) ▶
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/ Requirements catalog of a standard (functions, categories, requirements; ?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/ Create assessment ▶
Request
curl -X POST https://portal.cybertell.io/company/ict/api/new/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"standard": "ikt", "title": "IKT-Minimalstandard 2026"}'
Response
{
  "id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
  "prefilled": 0,
  "title": "IKT-Minimalstandard 2026",
  "version": "1.0",
  "standard_slug": "ikt"
}
GET/DEL /company/ict/api/<uuid>/ Assessment detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/
Response
{
  "id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
  "title": "IKT-Minimalstandard 2026",
  "version": "1.0",
  "standard_slug": "ikt",
  "rating_max": 4,
  "overall_score": 2.1,
  "completion_percent": 40,
  "maturity_label": "Wiederholbar",
  "is_complete": false,
  "is_auto": false,
  "read_only": false,
  "created_at": "2026-04-02T10:00:00+00:00",
  "functions": [
    {
      "code": "ID",
      "short_code": "ID",
      "name": "Identifizieren",
      "description": "…",
      "score": 2.4,
      "categories": [
        {
          "code": "ID.AM",
          "short_code": "AM",
          "name": "Asset Management",
          "score": 2.0,
          "items": [
            {
              "id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
              "uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
              "code": "ID.AM-1",
              "title": "Inventar der Geräte",
              "priority": 1,
              "rating": "3",
              "comment": "Inventar in Asset-Register"
            }
          ]
        }
      ]
    }
  ]
}
POST /company/ict/api/<uuid>/save-response/ Save answer ▶
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/ Available compliance standards ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/ict/api/standards/
Response
{
  "standards": [
    {
      "slug": "ikt",
      "name": "IKT-Minimalstandard",
      "description": "Bundesamt für wirtschaftliche Landesversorgung",
      "rating_max": 4,
      "is_status_scale": false
    }
  ]
}
GET /company/ict/api/<uuid>/pdf/ Compliance report as PDF ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o compliance-report.pdf https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="compliance-report.pdf"

%PDF-1.7 …

AD assessment

3 Endpoints

Reading requires the module on the key; create, update and delete for company admins only.

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

Microsoft 365 assessment

3 Endpoints

Reading requires the module on the key; create, update and delete for company admins only.

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

Risk management

2 Endpoints
GET /company/risk/api/list/ List risks ▶
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/ Create risk ▶
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"
}

Dependencies & Outage

16 Endpoints

Reading and simulating need the key’s module scope; only company admins change the map, processes, groups and scenarios.

GET /company/data-flows/api/mobile/ Key figures, single points of failure and outage scenarios ▶
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/ Map: all nodes, flows and groups ▶
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/ Place a supplier, asset or process on the map (idempotent) ▶
Request
curl -X POST https://portal.cybertell.io/company/data-flows/api/nodes/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82"}'
Response
{
  "ok": true,
  "node": {
    "id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
    "uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
    "kind": "supplier",
    "label": "Hosting AG",
    "criticality": "high"
  }
}
DEL /company/data-flows/api/nodes/<uuid>/ Remove a node and its flows from the map; the supplier, asset or process remains ▶
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/ Create a flow between two nodes ▶
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>/ Change a flow (only the fields sent) or delete it ▶
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/ List or create business processes (placed on the map right away) ▶
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>/ Read, change or delete a business process ▶
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/ List or create groups ▶
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>/ Rename a group, set (nodes), add (add) or remove (remove) nodes, or delete the group ▶
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/ Simulate an outage without saving anything (trigger by node or by supplier, asset, process) ▶
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/ List saved scenarios or save a simulation as a 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>/ Read a scenario with its result or delete it ▶
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/ Status page state per node and the impact of ongoing disruptions ▶
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/ Provider disruption history, newest first; ?open=1 only ongoing ones ▶
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/ Read and set node positions ▶
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 & Recovery

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

Attack surface

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

Banning orders

3 Endpoints
GET /company/banning-orders/api/list/ List banning orders (newest 100) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/banning-orders/api/list/
Response
{
  "hausverbote": [
    {
      "id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
      "firstname": "Unbekannt",
      "lastname": "männlich",
      "status": "aktiv",
      "reason": "Hausfriedensbruch",
      "location": "Filiale Tannenhof",
      "ban_date": "2026-05-16",
      "ban_until": "2027-05-16",
      "photo_url": null,
      "violation_count": 0
    }
  ]
}
POST /company/banning-orders/api/create/ Create banning order ▶
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>/ Banning order detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/banning-orders/api/8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60/
Response
{
  "id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
  "firstname": "Unbekannt",
  "lastname": "männlich",
  "date_of_birth": null,
  "photo_url": null,
  "description": "",
  "street": "",
  "postal_code": "",
  "city": "",
  "country": "",
  "reason": "Hausfriedensbruch",
  "location": "Filiale Tannenhof",
  "ban_date": "2026-05-16",
  "ban_until": "2027-05-16",
  "status": "aktiv",
  "notes": "",
  "violations": [
    {
      "id": "0a2c4e68-1b3d-4f75-9c18-5e7a9c1d3f60",
      "date": "2026-06-01",
      "description": "Erneut im Laden",
      "reported_to_police": true,
      "notes": ""
    }
  ],
  "can_edit": true,
  "can_manage": true
}

Tabletop exercises

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

SOC, device fleet & threat report

8 Endpoints
GET /company/api/soc/status/ SOC hub status (configured firewall) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/soc/status/
Response
{
  "firewalla": true,
  "sophos": false,
  "defender": false,
  "pfsense": false,
  "waf": true
}
GET/POST /company/api/threat-reports/config/ Read / save threat report configuration (role_id as UUID or internal integer) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/threat-reports/config/
Response
{
  "configs": [
    {
      "id": 3,
      "role_id": 12,
      "role_uuid": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
      "role_name": "Geschäftsleitung",
      "frequency": "monthly",
      "send_hour": 8,
      "send_weekday": 0,
      "send_day": 1,
      "sections": ["lage_schweiz", "eigene_vorfaelle"],
      "is_active": true,
      "include_ai_summary": true
    }
  ],
  "available_sections": [
    { "key": "lage_schweiz", "label": "Lage Schweiz" }
  ]
}
GET /company/api/soc/<provider>/live/ Live data of a SOC provider (provider = firewalla, pfsense, sophos, defender, graylog; time window ?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/ Aggregated flows of one device in the last hour (?device= required, optional ?region=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/soc/firewalla/device-flows/?device=WS-042
Response
{
  "device": "WS-042",
  "total_flows": 812,
  "blocked_flows": 14,
  "blocked_ratio": 1.72,
  "total_download": 41984000,
  "total_upload": 5242880,
  "filter_region": "",
  "top_domains": [
    { "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
  ],
  "top_regions": [
    { "region": "CH", "count": 640, "blocked": 0 }
  ]
}
GET/POST/DEL /company/api/soc/<provider>/device-assignments/ Assign devices to employees (admin; mitarbeiter_id as UUID or internal integer) ▶
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/ AI analysis of an alarm (form fields; also at /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/ Check a suspicious destination (action=vt|ai|both; also at /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/ Latest threat report ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/threat-report/latest/
Response
{
  "report": {
    "sent_at": "2026-05-01T06:00:00+00:00",
    "recipient_count": 3,
    "ai_summary": "Im April dominierten QR-Phishing und Rechnungsbetrug.",
    "sections": ["lage_schweiz", "eigene_vorfaelle"],
    "role": "Geschäftsleitung"
  }
}

Firewalla integration

13 Endpoints
GET /company/api/firewalla/overview/ Dashboard overview ▶
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/ List devices (boxes) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/
Response
{
  "boxes": [
    {
      "id": "0a1b2c3d",
      "name": "Gold Murmelibach",
      "model": "gold",
      "version": "1.979",
      "license": "MSP",
      "ip": "203.0.113.20",
      "local_ip": "10.0.0.1",
      "mac": "AA:BB:CC:00:11:22",
      "mode": "router",
      "network_count": 3,
      "device_count": 38,
      "uptime": 864000,
      "last_active": "16.05.2026 08:00",
      "online": true,
      "location": "Murmelibach"
    }
  ]
}
GET /company/api/firewalla/boxes/<box_id>/ Box detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/
Response
{
  "box_id": "0a1b2c3d",
  "box": {
    "id": "0a1b2c3d",
    "name": "Gold Murmelibach",
    "model": "gold",
    "version": "1.979",
    "license": "MSP",
    "ip": "203.0.113.20",
    "local_ip": "10.0.0.1",
    "mac": "AA:BB:CC:00:11:22",
    "mode": "router",
    "network_count": 3,
    "device_count": 38,
    "uptime": 864000,
    "last_active": "16.05.2026 08:00",
    "online": true,
    "location": "Murmelibach"
  },
  "alarms": [
    {
      "id": "a-901",
      "type": "Sicherheitsaktivität",
      "message": "Verbindung zu bekannter Malware-Domain",
      "device": "WS-042",
      "target": "boese-domain.example",
      "timestamp": "16.05.2026 08:05",
      "severity": "high",
      "box_id": "0a1b2c3d"
    }
  ],
  "rules": [
    {
      "id": "55",
      "type": "dns",
      "target": "boese-domain.example",
      "action": "block",
      "direction": "outbound",
      "protocol": "",
      "scope": "",
      "expire": 0,
      "created_at": "10.05.2026 09:00",
      "paused": false
    }
  ],
  "devices": [
    {
      "id": "AA:BB:CC:DD:EE:FF",
      "mac": "AA:BB:CC:DD:EE:FF",
      "mac_vendor": "Dell",
      "ip": "10.0.0.42",
      "name": "WS-042",
      "online": true,
      "last_seen": "16.05.2026 08:00",
      "total_download": 41984000,
      "total_upload": 5242880,
      "assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
    }
  ]
}
GET /company/api/firewalla/boxes/<box_id>/devices/ Devices of a box ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/devices/
Response
{
  "box_id": "0a1b2c3d",
  "devices": [
    {
      "id": "AA:BB:CC:DD:EE:FF",
      "mac": "AA:BB:CC:DD:EE:FF",
      "mac_vendor": "Dell",
      "ip": "10.0.0.42",
      "name": "WS-042",
      "online": true,
      "last_seen": "16.05.2026 08:00",
      "total_download": 41984000,
      "total_upload": 5242880,
      "assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
    }
  ],
  "count": 1
}
GET /company/api/firewalla/flows/ Traffic flows (?query=, ?groupBy=, ?sortBy=, ?cursor=, ?limit= default 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/ Device traffic (?device= required, optional ?region=) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/device-flows/?device=WS-042
Response
{
  "device": "WS-042",
  "total_flows": 812,
  "blocked_flows": 14,
  "blocked_ratio": 1.72,
  "total_download": 41984000,
  "total_upload": 5242880,
  "filter_region": "",
  "top_domains": [
    { "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
  ],
  "top_regions": [
    { "region": "CH", "count": 640, "blocked": 0 }
  ]
}
GET /company/api/firewalla/stats/ Fleet statistics ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/stats/
Response
{
  "stats": { "onlineBoxes": 2, "offlineBoxes": 0, "alarms": 7, "rules": 64 }
}
GET /company/api/firewalla/soc-live/ Live SOC feed ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/api/firewalla/soc-live/
Response
{
  "provider": "firewalla",
  "capabilities": { "label": "Firewalla", "device_assignments": true },
  "soc_stats": {
    "threat_level": "medium",
    "alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
    "total_alarms": 7,
    "boxes_online": 2,
    "boxes_total": 2,
    "total_flows": 812,
    "blocked_flows": 14,
    "blocked_ratio": 1.72,
    "total_download": 41984000,
    "total_upload": 5242880
  },
  "flow_map": [
    { "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
  ],
  "recent_blocked": [
    { "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
  ],
  "suspicious": [
    { "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
  ],
  "company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
  "blocked_countries": ["RU", "KP"]
}
GET/POST/DEL /company/api/firewalla/blocked-countries/ Blocked countries ▶
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/ Manage blocked domains ▶
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/ Manage device assignments (mitarbeiter_id as UUID or internal integer) ▶
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/ Pause rule ▶
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/ Resume rule ▶
Request
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/resume/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "ok": true,
  "message": "Regel 55 fortgesetzt."
}

Playbooks (incident response)

14 Endpoints
GET /company/playbooks/api/list/ List playbooks ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/list/
Response
{
  "playbooks": [
    {
      "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
      "title": "Ransomware Response",
      "description": "Sofortmassnahmen bei Verschlüsselung",
      "topic": "ransomware",
      "topic_display": "Ransomware-Angriff",
      "version": "1.0",
      "updated_at": "2026-05-02T10:00:00+00:00",
      "scope": "standard",
      "has_steps": true
    }
  ]
}
POST /company/playbooks/api/create/ Create playbook (optionally with AI content, ai_generate) ▶
Request
curl -X POST https://portal.cybertell.io/company/playbooks/api/create/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Ransomware Response", "topic": "ransomware", "version": "1.0", "description": "Sofortmassnahmen bei Verschlüsselung", "scope": "standard", "ai_generate": true}'
Response
{
  "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
  "title": "Ransomware Response"
}
GET /company/playbooks/api/<uuid>/ Playbook detail ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/
Response
{
  "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
  "title": "Ransomware Response",
  "description": "Sofortmassnahmen bei Verschlüsselung",
  "topic": "ransomware",
  "topic_display": "Ransomware-Angriff",
  "version": "1.0",
  "updated_at": "2026-05-02T10:00:00+00:00",
  "scope": "standard",
  "has_steps": true,
  "sections": [
    {
      "id": "4a6c8e02-1b3d-4f59-9c87-2e5a7d1f3b06",
      "title": "Sofortmassnahmen",
      "content": "Betroffene Hosts isolieren …",
      "order": 0,
      "intro": "",
      "preparation": "",
      "condition": "",
      "block_key": "",
      "has_steps": true,
      "steps": [
        { "id": "e4b8c2d6-1a3f-4c57-9e80-2b4d6f8a0c13", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Incident Lead", "time_mark": "", "condition": "", "module_key": "", "order": 0 }
      ]
    }
  ],
  "roles": [
    { "id": "5b7d9f21-3c4e-4a86-9b05-1d3f5a7c9e20", "role_type": "intern", "name": "Max Muster", "role_title": "Incident Lead", "email": "[email protected]", "phone": "", "notes": "" }
  ]
}
GET /company/playbooks/api/<uuid>/pdf/ Playbook as 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/ List runs (?status=laufend|finished|abgeschlossen|abgebrochen, ?kind=drill|incident) ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/runs/?status=laufend
Response
{
  "runs": [
    {
      "id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
      "playbook_id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
      "title": "Ransomware Response",
      "kind": "incident", "kind_display": "Ernstfall",
      "status": "laufend", "status_display": "Laufend", "is_running": true,
      "started_at": "2026-10-11T08:15:00+00:00",
      "warroom": { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" },
      "ticket": null,
      "counts": { "done": 2, "open": 5, "skipped": 0, "na": 1, "visible": 7, "percent": 29 }
    }
  ]
}
GET /company/playbooks/api/runs/options/ Options for activation: playbooks with case-check questions, systems, service providers, war rooms, tickets ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  https://portal.cybertell.io/company/playbooks/api/runs/options/
Response
{
  "playbooks": [ { "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response", "topic": "ransomware", "questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ] } ],
  "asset_groups": [ { "key": "system", "label": "System", "assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster" } ] } ],
  "supplier_groups": [ { "key": "it_infrastructure", "label": "IT-Infrastruktur", "assets": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "criticality": "active", "criticality_label": "Aktiv", "owner": "" } ] } ],
  "warrooms": [ { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" } ],
  "tickets": [ { "id": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "title": "Verschlüsselte Dateien", "short_code": "T-0481" } ],
  "can_pick_assets": true
}
POST /company/playbooks/api/runs/activate/ Start a run (drill or incident) with systems, service providers, link and case check ▶
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>/ Run detail: sections and steps with state, case check, affected systems and service providers, permissions ▶
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/ Replace affected systems and service providers (without the suppliers key the providers stay unchanged) ▶
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/ Set case-check answers (true, false or null = open) ▶
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/ Tick, skip or reopen a step (offen|erledigt|uebersprungen), optionally with a note ▶
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/ Finish or abort a run (action=finish|abort), closing note, optionally create a review ▶
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/ Delete a run (company admin only) ▶
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/ Run as PDF ▶
Request
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  -o playbook-lauf.pdf https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/pdf/
Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="playbook-lauf.pdf"

%PDF-1.7 …

Security policy

3 Endpoints

Employees retrieve the current security policy and acknowledge it. Acknowledgements are logged as compliance evidence.

GET /company/policy/api/ Fetch current policy ▶
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/ Acknowledge policy (employee) ▶
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/ Policy as 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 …

Secure documents

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

Points

1 Endpoint
GET /company/api/points/me/ Own points and leaderboard ▶
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/ Phases, progress and next steps ▶
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/ Complete or postpone a step ▶
Request
curl -X POST https://portal.cybertell.io/company/roadmap/api/mobile/action/ \
  -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
  --data-urlencode 'action=done' \
  --data-urlencode 'item_key=module:incidents'
Response
{
  "ok": true,
  "progress": 38
}

DMARC

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

Incident response

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

Audit log

1 Endpoint
GET /company/tickets/api/audit-log/ Company audit log (last 100 events, company admins only) ▶
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"
    }
  ]
}

Individuals API.

All endpoints require an individual API key in the Authorization header (Bearer ctk_…). A key only sees the data of the person who created it.

Dashboard & profile

2 Endpoints
GET /individual/api/dashboard/ Dashboard overview (courses_* counts exam attempts) ▶
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/ Profile data ▶
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]" } ] }
  }
}

Email leak checks

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

Courses

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

Reseller / insurer API.

All endpoints require a reseller API key in the Authorization header (Bearer ctk_…). Billing additionally requires that the key was created by an admin who is still an admin.

Dashboard

1 Endpoint
GET /reseller/api/dashboard/ Overview ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/dashboard/
Response
{
  "dashboard": {
    "type": "reseller",
    "company_count": 12,
    "active_companies": 10,
    "total_employees": 240,
    "open_tickets": 5,
    "sponsored_persons": 0
  }
}

Companies

6 Endpoints
GET /reseller/api/companies/ List managed companies ▶
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>/ Company detail ▶
Request
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
  https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
Response
{
  "company": {
    "id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
    "name": "Murmelibach AG",
    "email": "[email protected]",
    "industry": "finance",
    "company_size": "11-50",
    "plan": "tier_10",
    "subscription_status": "active",
    "country": "Schweiz",
    "employees": [
      { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]", "is_admin": true }
    ]
  }
}
GET /reseller/api/companies/security/ Security posture of all customers ▶
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/ Open CVEs of all customers ▶
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/ Active assets of all customers ▶
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/ Security posture of one customer ▶
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
  }
}

Billing

6 Endpoints

Consolidated invoices and costs per customer for your own accounting. Each line names the customer company, the number of employees, the plan, quantity and unit, the list price, the partner discount and the net amount. Requires an API key with the «Billing» scope created by a partner admin; costs per customer are available to IT partners only. Without a list price (on-premises) the current period amounts are null; older invoices return the new fields as null.

GET /reseller/api/billing/ Overview with totals, open amounts and current period ▶
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/ Customers with employees, plan, subscription and current period costs ▶
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>/ Customer with current state, subscription and invoice history ▶
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/ Invoices with customers and employee total, filterable by status; ?include=lines adds the line items ▶
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>/ Invoice with all line items per customer ▶
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/ Invoice as 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"
}

Response format.

All API responses are returned as JSON. Successful requests contain the data directly, errors return a structured error object:

Successful response

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

Error response

{
  "error": "Not authenticated",
  "code": 401
}

Error objects of the portal APIs contain error (a human-readable message in the account’s language) and code (the HTTP status as a number); unexpected server errors (500) only return error. A 403 typically occurs when the API key lacks the endpoint’s scope — adjust the key’s scope in the portal under API keys.

HTTP status codes.

200 Success
201 Created successfully
202 Accepted, not finished yet (poll again)
400 Bad request
401 Not authenticated
403 No permission
404 Not found
405 Method not allowed
409 Conflict with the current state (e.g. already running, locked)
410 Endpoint removed
429 Rate limit reached
500 Internal server error
503 Service temporarily unavailable (AI, PDF generation, render worker)

Rate limits & notes.

  • 100 requests / min per token. If exceeded, a 429 with a Retry-After header is returned.
  • All timestamps are in UTC (ISO 8601 format).
  • The API is served over HTTPS.
  • Base URL: Company (B2B), Reseller / insurer: https://portal.cybertell.io · Individuals: https://app.cybertell.io. Companies running their own instance replace the host with their instance address – the paths stay the same.
  • Pagination: list endpoints that carry the page/page_size parameters in the OpenAPI specification support ?page= and ?page_size= (default 50, max. 200). With pagination the response additionally contains page, page_size, total, total_pages. Without pagination parameters some lists return only the newest 50–200 entries; always use ?page= for complete lists.

Contact & support.

Questions about API integration? We reply by e-mail, usually within one working day.

Developer support
[email protected]

Technical questions about the API. Reply usually within one working day.

General contact
[email protected]

Sales, demos, partner enquiries. Reply usually within one working day.