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.
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 EndpointsGET /company/tickets/api/me/ Current user ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/me/
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"first_name": "Max",
"last_name": "Muster",
"email": "[email protected]",
"is_admin": true,
"company_name": "Murmelibach AG",
"company_uuid": "2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02",
"language": "de",
"modules": ["incidents", "phishing_analysis", "courses"],
"has_firewalla": true,
"gamification_enabled": true,
"profile_image_url": null,
"company_logo_url": "https://cybertell.io/media/logos/murmelibach.png"
}
POST /company/tickets/api/me/language/ Change account language ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/me/language/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"language": "fr"}'
{
"ok": true,
"language": "fr"
}
Employees & administration
14 EndpointsGET /company/api/employees/ List all employees ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/employees/
{
"employees": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"status_display": "Aktiv",
"is_company_admin": false,
"language": "de",
"roles": [{"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d", "name": "Mitarbeiter"}],
"last_login": "2026-06-10T08:15:00+00:00",
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
POST /company/api/employees/create/ Create employee ▶
curl -X POST https://portal.cybertell.io/company/api/employees/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"firstname": "Anna", "lastname": "Müller", "email": "[email protected]", "language": "de", "is_company_admin": false, "role_ids": ["a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d"], "send_invite_now": true}'
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"is_company_admin": false,
"invitation_sent": true
}
GET/PATCH/PUT/DEL /company/api/employees/<uuid>/ Read, update or deactivate an employee (DELETE sets status=inactive) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"firstname": "Anna",
"lastname": "Müller",
"email": "[email protected]",
"status": "active",
"status_display": "Aktiv",
"is_company_admin": false,
"language": "de",
"phone": "",
"department": "",
"position": "",
"roles": [{"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d", "name": "Mitarbeiter"}],
"certifications": [{"id": "3b9d1f72-8c4a-4e15-9a6b-2d7e0c1f5a83", "title": "Security Awareness Basis"}],
"totp_enabled": false,
"passkey_enabled": true,
"last_login": "2026-06-10T08:15:00+00:00",
"private_email": "",
"company_mobile": "",
"private_mobile": "",
"country": "ch"
}
POST /company/api/employees/<uuid>/invite/ Send invitation ▶
curl -X POST https://portal.cybertell.io/company/api/employees/c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64/invite/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"invitation_sent": true
}
GET/POST /company/api/roles/ List / create roles ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/roles/
{
"roles": [
{
"id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"name": "Werkstatt",
"is_default": false,
"is_external": false,
"modules": [{"id": 3, "key": "incidents", "name": "Vorfälle"}],
"member_count": 8
}
]
}
PATCH/DELETE /company/api/roles/<uuid>/ Update or delete role ▶
curl -X PATCH https://portal.cybertell.io/company/api/roles/b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Werkstatt", "is_external": false, "module_ids": [3]}'
{
"id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"name": "Werkstatt",
"is_default": false,
"is_external": false
}
GET /company/api/locations/ List locations ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/locations/
{
"locations": [
{
"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
"name": "Hauptsitz Murmelibach",
"street": "Dorfstrasse 12",
"address": "Dorfstrasse 12",
"zip_code": "3000",
"city": "Murmelibach",
"country_code": "ch",
"country": "ch",
"location_types": [{"id": 1, "name": "Büro", "key": "office"}],
"ai_risk_level": "",
"ai_risk_analysis": "",
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
POST /company/api/locations/create/ Create location ▶
curl -X POST https://portal.cybertell.io/company/api/locations/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Filiale Tannenhof", "street": "Bahnhofstrasse 3", "zip_code": "3011", "city": "Bern", "country_code": "ch", "employee_count": 6, "location_type_ids": [1]}'
{
"id": "e7f9a1c3-5b2d-4c84-9e16-7a3c5e9b1d40",
"name": "Filiale Tannenhof"
}
GET/PATCH/PUT/DEL /company/api/locations/<uuid>/ Location detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/locations/a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d/
{
"id": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
"name": "Hauptsitz Murmelibach",
"street": "Dorfstrasse 12",
"zip_code": "3000",
"city": "Murmelibach",
"country_code": "ch",
"description": "",
"notes": "",
"location_types": [{"id": 1, "name": "Büro", "key": "office"}],
"employee_count": 24,
"has_servers": true,
"has_network_infrastructure": true,
"has_physical_security": true,
"has_backup_power": false,
"has_fire_suppression": false,
"has_access_control": true,
"ai_risk_level": "",
"ai_risk_analysis": "",
"created_at": "2026-01-12T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET /company/api/location-types/ Location types ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/location-types/
{
"types": [
{ "id": 1, "name": "Büro", "key": "office" },
{ "id": 2, "name": "Rechenzentrum", "key": "datacenter" }
]
}
GET /company/api/billing/ Billing information ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/billing/
{
"plan": "tier_10",
"billed_via": "direct",
"reseller": null,
"employee_count": 8,
"billing_cycle": "yearly",
"subscription_status": "active",
"trial_ends_at": null,
"stripe_current_period_end": "2027-01-12T09:00:00+00:00"
}
GET /company/api/layout/ Document layout (logo / CI) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/layout/
{
"accent_color": "#1f6f4a",
"font_family": "",
"heading_font_family": "",
"confidentiality_text": "Vertraulich",
"footer_text": "",
"cover_variant": "classic",
"accent_line": "left",
"logo_position": "right",
"watermark_text": "",
"margin_preset": "normal",
"show_toc": true,
"show_changelog": true,
"updated_at": "2026-04-02T10:00:00+00:00"
}
GET /company/tabletop/api/company-profile/ Read company profile (with choice lists) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/company-profile/
{
"company_title": "Murmelibach AG",
"industry": "finance",
"industry_label": "Finanzdienstleistung",
"company_size": "11-50",
"company_size_label": "11–50 Mitarbeiter",
"description": "",
"it_landscape": "Microsoft 365, Fileserver",
"critical_assets": "Kundendaten, Zahlungsverkehr",
"compliance_notes": "",
"country": "Schweiz",
"country_code": "ch",
"country_label": "Schweiz",
"website": "https://murmelibach-ag.example",
"default_language": "de",
"logo_url": "/media/logos/murmelibach.png",
"domains": [
{ "domain": "murmelibach-ag.ch", "is_primary": true, "notes": "" }
],
"industry_choices": [
{ "value": "finance", "label": "Finanzdienstleistung" }
],
"company_size_choices": [
{ "value": "11-50", "label": "11–50 Mitarbeiter" }
],
"country_choices": [
{ "value": "ch", "label": "Schweiz" }
],
"language_choices": [
{ "value": "de", "label": "Deutsch" }
]
}
POST /company/tabletop/api/company-profile/update/ Update company profile ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/company-profile/update/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"company_title": "Murmelibach AG", "industry": "finance", "company_size": "11-50", "critical_assets": "Kundendaten, Zahlungsverkehr", "default_language": "de", "country_code": "ch"}'
{
"company_title": "Murmelibach AG",
"industry": "finance",
"industry_label": "Finanzdienstleistung",
"company_size": "11-50",
"company_size_label": "11–50 Mitarbeiter",
"description": "",
"it_landscape": "",
"critical_assets": "Kundendaten, Zahlungsverkehr",
"compliance_notes": "",
"country": "Schweiz",
"country_code": "ch",
"country_label": "Schweiz",
"website": "",
"default_language": "de",
"logo_url": "",
"domains": [],
"industry_choices": [],
"company_size_choices": [],
"country_choices": [],
"language_choices": []
}
Phishing campaigns
3 EndpointsGET /company/api/campaigns/ List campaigns ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/campaigns/
{
"campaigns": [
{
"id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
"name": "Q2 Awareness",
"status": "Wird gesendet",
"created_date": "2026-05-02T09:00:00+00:00",
"stats": { "sent": 120, "opened": 61, "clicked": 14 }
}
]
}
POST /company/api/campaigns/create/ Create campaign as draft (launch in the web portal) ▶
curl -X POST https://portal.cybertell.io/company/api/campaigns/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Q2 Awareness", "template_id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "smtp_profile_id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "landing_page_id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24"}'
{
"id": "5e8f1c20-9a3b-4d6e-8f12-7c4a9b2e1d05",
"name": "Q2 Awareness"
}
GET /company/api/campaigns/options/ Templates & options ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/campaigns/options/
{
"templates": [
{ "id": "b7c9e1d3-2f4a-4c68-9b05-1e3d5f7a9c20", "name": "Paket-Benachrichtigung" }
],
"smtp_profiles": [
{ "id": "0c2e4a6b-8d1f-4a35-9b7c-2e4f6a8c0d13", "name": "Standard-SMTP" }
],
"landing_pages": [
{ "id": "1d3f5a7c-9e2b-4c46-8a0d-3f5a7c9e1b24", "name": "Login-Seite" }
]
}
Incidents & tickets
11 EndpointsGET /company/tickets/api/list/ Ticket list (filter: ?status=, ?category=, ?type=employee|incident, ?q=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/list/?status=offen&category=phishing
{
"tickets": [
{
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"message_count": 2
}
],
"total_count": 1
}
POST /company/tickets/api/create/ Create ticket ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"category": "phishing", "title": "Verdächtige E-Mail", "description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.", "priority": "hoch", "ticket_type": "meldung"}'
{
"ticket_id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"message": "Ticket erstellt."
}
GET /company/tickets/api/options/ Options for new tickets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/options/
{
"categories": [
{ "value": "frage", "label": "Frage" },
{ "value": "phishing", "label": "Phishing-Verdacht" },
{ "value": "sonstiges", "label": "Sonstiges" }
],
"ticket_types": [
{ "value": "meldung", "label": "Meldung" },
{ "value": "vorfall", "label": "Vorfall" }
],
"priorities": [
{ "value": "niedrig", "label": "Niedrig" },
{ "value": "mittel", "label": "Mittel" },
{ "value": "hoch", "label": "Hoch" },
{ "value": "kritisch", "label": "Kritisch" }
],
"defaults": { "category": "sonstiges", "ticket_type": "meldung", "priority": "mittel" }
}
GET /company/tickets/api/<uuid>/ Ticket detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/
{
"ticket": {
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"description": "Absender gibt sich als Bergbank Eidgenossenschaft aus.",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_by": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "email": "[email protected]" },
"assigned_to": null,
"participants": [],
"description_edited_at": null,
"can_edit": true,
"escalated_by": null,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"closed_at": null,
"escalated_at": null,
"messages": [
{
"id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
"author": { "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]" },
"body": "Bitte E-Mail nicht öffnen, wir prüfen.",
"is_internal": false,
"created_at": "2026-05-16T07:10:00+00:00",
"edited_at": null,
"mentioned": [],
"attachments": []
}
],
"attachments": []
}
}
POST /company/tickets/api/<uuid>/reply/ Send reply ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/reply/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"body": "Bitte E-Mail nicht öffnen, wir prüfen.", "mentions": []}'
{
"message_id": "7b1d3f57-2a4c-4e86-8b09-3d5f7a1c9e40",
"message": "Antwort gespeichert."
}
POST /company/tickets/api/<uuid>/status/ Change status ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/status/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"status": "in_bearbeitung"}'
{
"message": "Status aktualisiert."
}
POST /company/tickets/api/<uuid>/priority/ Change priority ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/priority/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"priority": "kritisch"}'
{
"message": "Priorität aktualisiert."
}
POST /company/tickets/api/<uuid>/assign/ Assign a ticket to a person (admin; empty = remove assignment) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/assign/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"assigned_to": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"}'
{
"changed": true,
"assigned_to": {
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Anna Müller",
"email": "[email protected]"
}
}
POST /company/tickets/api/<uuid>/edit/ Edit title/description or an own message (with message_id) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/edit/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Verdächtige E-Mail mit Rechnungsanhang"}'
{
"changed": ["title"]
}
GET /company/tickets/api/<uuid>/mentionable/ Search people for @ mentions (?q=, without email addresses) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c/mentionable/?q=an
{
"results": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Anna Müller", "is_admin": false }
]
}
GET /company/tickets/api/dashboard/ Dashboard statistics ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/dashboard/
{
"total_tickets": 46,
"open_tickets": 3,
"closed_tickets": 41,
"serious_incidents": 1,
"by_category": [
{ "category": "phishing", "category_display": "Phishing-Verdacht", "count": 18 }
],
"by_priority": [
{ "priority": "hoch", "priority_display": "Hoch", "count": 7 }
],
"by_status": [
{ "status": "offen", "status_display": "Offen", "count": 3 }
],
"recent_tickets": [
{
"id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c",
"title": "Verdächtige E-Mail",
"category": "phishing",
"category_display": "Phishing-Verdacht",
"ticket_type": "meldung",
"type_display": "Meldung",
"status": "offen",
"status_display": "Offen",
"priority": "hoch",
"priority_display": "Hoch",
"is_serious_incident": false,
"created_at": "2026-05-15T09:30:00+00:00",
"updated_at": "2026-05-16T07:10:00+00:00",
"message_count": 2
}
]
}
MITRE ATT&CK
2 EndpointsGET /company/tickets/mitre/api/mobile/ Tactics with techniques and coverage by own tickets and news ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/mitre/api/mobile/
{
"tactics": [
{
"tactic_id": "TA0001",
"name": "Initial Access",
"technique_count": 1,
"techniques": [
{ "technique_id": "T1566", "name": "Phishing", "is_subtechnique": false, "ticket_count": 3, "news_count": 12 }
]
}
],
"technique_total": 211,
"technique_covered": 18
}
GET /company/tickets/mitre/api/mobile/<technique_id>/ One technique with linked tickets and news (up to 20 each) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/mitre/api/mobile/T1566/
{
"technique_id": "T1566",
"name": "Phishing",
"description": "…",
"is_subtechnique": false,
"parent_id": "",
"tactics": ["Initial Access"],
"assets": ["E-Mail"],
"tickets": [
{ "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen", "priority": "hoch", "priority_display": "Hoch", "created_at": "2026-05-15T09:30:00+00:00" }
],
"news": [
{ "id": "4812", "title": "Neue Phishing-Welle gegen KMU", "url": "https://www.ncsc.admin.ch/…", "published_at": "2026-05-14T06:00:00+00:00" }
]
}
War Rooms
6 EndpointsGET /company/tickets/api/warrooms/ List war rooms ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/warrooms/?status=aktiv
{
"warrooms": [
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participant_count": 5,
"message_count": 12,
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
]
}
POST /company/tickets/api/warrooms/create/ Create war room ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware-Vorfall", "description": "Fileserver FS01 verschlüsselt.", "external_link": "", "external_link_label": "Video-Call"}'
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participant_count": 1,
"message_count": 0,
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
GET /company/tickets/api/warrooms/<uuid>/ War room detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/
{
"id": "2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87",
"title": "Ransomware-Vorfall",
"description": "Fileserver FS01 verschlüsselt.",
"status": "aktiv",
"status_display": "Aktiv",
"external_link": "",
"external_link_label": "Video-Call",
"participants": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "initials": "MM", "is_admin": true }
],
"tickets": [
{ "id": "9f3a7c1e-2b4d-4e8a-9c10-6d5e4f3a2b1c", "title": "Verdächtige E-Mail", "status": "offen", "status_display": "Offen" }
],
"playbooks": [
{ "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response" }
],
"messages": [
{
"id": 501,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Systeme isoliert.",
"created_at": "16.05.2026 10:00",
"created_at_iso": "2026-05-16T10:00:00+00:00",
"attachments": []
}
],
"created_at": "2026-05-16T09:00:00+00:00",
"closed_at": null
}
GET /company/tickets/warroom/<uuid>/api/messages/ Fetch messages (polling) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/messages/?after=500
{
"messages": [
{
"id": 501,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Systeme isoliert.",
"created_at": "16.05.2026 10:00",
"attachments": []
}
]
}
POST /company/tickets/warroom/<uuid>/api/send/ Send message ▶
curl -X POST https://portal.cybertell.io/company/tickets/warroom/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/api/send/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"body": "Backups werden geprüft."}'
{
"id": 502,
"author_id": 42,
"author_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"author_name": "Max Muster",
"author_initials": "MM",
"author_avatar_url": "",
"body": "Backups werden geprüft.",
"created_at": "16.05.2026 10:05",
"attachments": []
}
GET/POST /company/tickets/api/warrooms/<uuid>/participants/ Read, invite or remove participants ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/warrooms/2d6b9e44-1a7c-4f30-8b95-3c2e1d0a9f87/participants/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"add": ["c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64"], "remove": [], "add_groups": []}'
{
"participants": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Max Muster",
"initials": "MM",
"is_admin": true
}
],
"employees": [
{
"id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"name": "Max Muster",
"initials": "MM",
"is_admin": true,
"is_participant": true,
"group_ids": ["b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01"]
}
],
"groups": [
{ "id": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01", "name": "Werkstatt" }
],
"can_manage": true
}
Dark Web Monitoring
4 EndpointsGET /company/tickets/api/darkweb/ Scan overview ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/
{
"scans": [
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch",
"total_credentials": 7,
"unique_emails": 5,
"breach_count": 3,
"has_plaintext_pw": true,
"risk_level": "high",
"sources_queried": "Dehashed, HIBP, LeakCheck",
"created_at": "2026-05-15T02:00:00+00:00"
}
]
}
POST /company/tickets/api/darkweb/scan/ Start scan (verified domains only) ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/darkweb/scan/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"domain": "murmelibach-ag.ch", "run_dehashed": true, "run_hibp": true, "run_leakcheck": true}'
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch"
}
GET /company/tickets/api/darkweb/<uuid>/ Scan detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e/
{
"id": "7a1c3e90-4b2d-4c61-9e83-1f0a2b3c4d5e",
"domain": "murmelibach-ag.ch",
"total_credentials": 7,
"unique_emails": 5,
"breach_count": 3,
"has_plaintext_pw": true,
"risk_level": "high",
"sources_queried": "Dehashed, HIBP, LeakCheck",
"created_at": "2026-05-15T02:00:00+00:00",
"stats": { "dehashed_count": 4, "hibp_count": 3, "leakcheck_count": 3 },
"findings": [
{
"source": "Dehashed",
"email": "[email protected]",
"username": "",
"password": "Sommer2024!",
"hashed_password": "",
"name": "",
"database": "combolist-2025",
"url": ""
}
],
"findings_total": 7,
"breaches": [
{
"name": "ExampleBreach2024",
"date": "2024-11-02",
"pwn_count": 1420000,
"data_classes": ["Email addresses", "Passwords"],
"description": "…",
"domain": "example.com"
}
]
}
GET /company/tickets/api/darkweb/domains/ Company domains for the scan ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/darkweb/domains/
{
"domains": [
{
"domain": "murmelibach-ag.ch",
"is_primary": true,
"is_verified": true
}
]
}
Phishing analysis (EML)
2 EndpointsPOST /company/tickets/analysis/api/upload/ Upload EML file ▶
curl -X POST https://portal.cybertell.io/company/tickets/analysis/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "[email protected]"
{
"analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"detail_url": "https://cybertell.io/company/tickets/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/",
"message": "E-Mail erfolgreich analysiert."
}
GET /company/tickets/analysis/api/list/ Analysis list ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/analysis/api/list/
{
"analyses": [
{
"id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"subject": "Ihr Konto wurde gesperrt",
"sender": "[email protected]",
"risk_score": 85,
"vt_status": "done",
"ai_status": "done",
"created_at": "2026-05-15T18:20:00+00:00"
}
]
}
Mail plugin (phishing indicators)
3 EndpointsAPI 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) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/mail-plugin/indicators/?since=2026-05-01T00:00:00Z
{
"indicators": [
{
"id": 12,
"type": "sender_domain",
"value": "paypa1.com",
"risk_level": "high",
"description": "Gefälschter Absender",
"analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"hit_count": 3,
"created_at": "2026-05-15T18:25:00+00:00",
"expires_at": null
}
],
"count": 1,
"last_updated": "2026-05-16T08:00:00+00:00"
}
POST /company/tickets/api/mail-plugin/check/ Check email against indicators ▶
curl -X POST https://portal.cybertell.io/company/tickets/api/mail-plugin/check/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"sender": "[email protected]", "subject": "Konto gesperrt", "urls": ["https://paypa1.com/login"]}'
{
"is_phishing": true,
"risk_level": "high",
"matches": [
{ "type": "sender_domain", "value": "paypa1.com", "risk_level": "high", "analysis_id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13" }
],
"analysis_url": "https://cybertell.io/company/tickets/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/"
}
GET /company/tickets/api/mail-plugin/analysis/<uuid>/ Analysis detail for popup ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/mail-plugin/analysis/d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13/
{
"id": "d5f7a9c1-3b5e-4d80-9a16-2c4e6f8a0b13",
"sender": "[email protected]",
"subject": "Ihr Konto wurde gesperrt",
"risk_score": 85,
"risk_label": "Hoch",
"spf": "fail",
"dkim": "none",
"dmarc": "fail",
"malicious_urls": ["https://paypa1.com/login"],
"ai_category": "Phishing",
"ai_assessment": "KATEGORIE: Phishing\n- Domain 2 Tage alt\nEMPFEHLUNG: Nicht öffnen.",
"ai_indicators": ["Domain 2 Tage alt"],
"ai_recommendation": "Nicht öffnen.",
"analysed_at": "2026-05-15T18:20:00+00:00",
"analysed_by": "Max Muster"
}
Awareness videos
7 EndpointsGET /company/videos/api/list/ Video list ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/videos/api/list/
{
"videos": [
{
"id": "e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24",
"title": "Phishing in 90 Sekunden",
"language": "de",
"status": "completed",
"status_display": "Fertig",
"slide_count": 8,
"duration_seconds": 92,
"render_progress": 100,
"source": "generated",
"completed_by_me": false,
"release_status": "publiziert",
"release_status_display": "Publiziert",
"is_published": true,
"is_current": true,
"valid_from": null,
"valid_until": null,
"created_at": "2026-05-10T09:00:00+00:00"
}
]
}
POST /company/videos/api/generate/ Generate awareness video (AI; optional: tone, address_form, length_preset, slide_count, style_template, setting, tts_voice, tts_speed) ▶
curl -X POST https://portal.cybertell.io/company/videos/api/generate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Sicheres Homeoffice", "language": "de", "enable_tts": false, "video_format": "landscape", "extra_notes": ""}'
{
"job_id": "f7b9d1e3-5d7a-4f02-9c38-4e6a8b0d2f35",
"status": "generating"
}
GET /company/videos/api/<uuid>/ Video detail including slides ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/
{
"id": "e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24",
"title": "Phishing in 90 Sekunden",
"extra_notes": "",
"language": "de",
"video_format": "landscape",
"status": "completed",
"status_display": "Fertig",
"slide_count": 8,
"duration_seconds": 92,
"render_progress": 100,
"render_error": "",
"enable_tts": false,
"has_video": true,
"video_url": "/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/",
"source": "generated",
"completed_by_me": false,
"release_status": "publiziert",
"release_status_display": "Publiziert",
"is_published": true,
"is_current": true,
"valid_from": null,
"valid_until": null,
"created_at": "2026-05-10T09:00:00+00:00",
"slides": [
{
"id": "0b2d4f68-1a3c-4e75-9b18-5d7f9a1c3e60",
"order": 1,
"slide_type": "intro",
"title": "Was ist Phishing?",
"bullets": ["Gefälschter Absender", "Zeitdruck"],
"speaker_notes": "",
"narration": "",
"illustration_key": "mail",
"duration_sec": 12
}
]
}
POST /company/videos/api/<uuid>/render/ Trigger rendering again ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/render/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "rendering",
"phase": "waiting",
"position": 1,
"status_display": "In Warteschlange"
}
GET /company/videos/api/<uuid>/video/ Load MP4 for the player ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o awareness.mp4 https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/video/
HTTP/1.1 200 OK Content-Type: video/mp4 Accept-Ranges: bytes Content-Length: 4821004 <MP4-Datenstrom>
POST/DEL /company/videos/api/<uuid>/delete/ Delete video ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/delete/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "deleted"
}
POST /company/videos/api/<uuid>/progress/ Report watched seconds (completion tracking) ▶
curl -X POST https://portal.cybertell.io/company/videos/api/e6a8c0d2-4c6f-4e91-8b27-3d5f7a9c1e24/progress/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"watched": 73, "duration": 92, "ended": false}'
{
"progress_pct": 79,
"completed": false
}
Asset register
5 EndpointsReading requires the module on the key; create, update and delete for company admins only.
GET /company/assets/api/list/ Assets with risk assessment ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/assets/api/list/
{
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01",
"asset_type": "system",
"asset_type_display": "System / Server",
"status": "active",
"status_display": "Aktiv",
"criticality": "high",
"criticality_display": "Hoch",
"confidentiality": "high",
"integrity": "medium",
"availability": "high",
"owner_name": "Max Muster",
"owner_email": "[email protected]",
"supplier": {
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
},
"status_page_url": "",
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"renews_on": "2027-01-31",
"renewal_state": "ok",
"auto_renew": true,
"payment_method": "invoice",
"payment_method_display": "Rechnung",
"risk_count": 2,
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/assets/api/create/ Create asset ▶
curl -X POST https://portal.cybertell.io/company/assets/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Fileserver FS01", "asset_type": "system", "criticality": "high", "supplier": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "owner_email": "[email protected]"}'
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01"
}
GET/PATCH/PUT/DEL /company/assets/api/<uuid>/ Asset detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01",
"asset_type": "system",
"asset_type_display": "System / Server",
"status": "active",
"status_display": "Aktiv",
"criticality": "high",
"criticality_display": "Hoch",
"confidentiality": "high",
"integrity": "medium",
"availability": "high",
"owner_name": "Max Muster",
"owner_email": "[email protected]",
"supplier": {
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
},
"status_page_url": "",
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"renews_on": "2027-01-31",
"renewal_state": "ok",
"auto_renew": true,
"payment_method": "invoice",
"payment_method_display": "Rechnung",
"description": "Zentraler Dateiserver",
"notes": "",
"renewal_cycle": "yearly",
"renewal_cycle_display": "Jährlich",
"payment_note": "",
"provider_account": "",
"risks": [],
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET/POST /company/assets/api/<uuid>/risks/ List or create the risks of an asset ▶
curl -X POST https://portal.cybertell.io/company/assets/api/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/risks/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ausfall Rechenzentrum", "likelihood": 2, "impact": 4, "target_likelihood": 1, "target_impact": 4, "contingency": "Failover ausl\u00f6sen"}'
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"asset_id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"title": "Ausfall Rechenzentrum",
"threat": "Stromausfall",
"vulnerability": "Kein Zweitstandort",
"likelihood": 2,
"impact": 4,
"risk_score": 8,
"risk_level": "high",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"status": "assessed",
"treatment": "Replikation ins Zweit-RZ",
"contingency": "Failover auslösen",
"accepted": false,
"accepted_by": "",
"accepted_at": null,
"accepted_justification": "",
"review_date": "2027-03-31",
"ai_generated": false,
"updated_at": "2026-05-02T10:00:00+00:00"
}
GET/PATCH/DEL /company/assets/api/risks/<uuid>/ Read, change or delete a risk; accepted: true accepts it ▶
curl -X PATCH https://portal.cybertell.io/company/assets/api/risks/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"accepted": true, "accepted_justification": "Kosten stehen in keinem Verh\u00e4ltnis"}'
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"asset_id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"title": "Ausfall Rechenzentrum",
"threat": "Stromausfall",
"vulnerability": "Kein Zweitstandort",
"likelihood": 2,
"impact": 4,
"risk_score": 8,
"risk_level": "high",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"status": "assessed",
"treatment": "Replikation ins Zweit-RZ",
"contingency": "Failover auslösen",
"accepted": false,
"accepted_by": "",
"accepted_at": null,
"accepted_justification": "",
"review_date": "2027-03-31",
"ai_generated": false,
"updated_at": "2026-05-02T10:00:00+00:00"
}
Third parties (suppliers)
3 EndpointsReading requires the module on the key; create, update and delete for company admins only.
GET /company/suppliers/api/list/ List suppliers ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/suppliers/api/list/
{
"suppliers": [
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft",
"category": "cloud_saas",
"category_display": "Cloud / SaaS",
"status": "active",
"status_display": "Aktiv",
"risk_level": "high",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"ai_risk_level": "",
"country_code": "ch",
"website": "https://wolkensoftware.example",
"contact_name": "Erika Muster",
"contact_email": "[email protected]",
"data_access": true,
"system_access": false,
"status_page_url": "https://status.wolkensoftware.example",
"status_sources": [
"https://status.wolkensoftware.example/history.rss"
],
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"sla": {
"target": 99.9,
"claim_days": 30
},
"document_count": 1,
"created_at": "2026-02-01T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/suppliers/api/create/ Create supplier ▶
curl -X POST https://portal.cybertell.io/company/suppliers/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Wolkensoftware Eidgenossenschaft", "category": "cloud_saas", "risk_level": "high", "likelihood": 3, "impact": 4, "contingency": "Zweitanbieter aktivieren", "status_page_url": "https://status.wolkensoftware.example", "status_sources": ["https://status.wolkensoftware.example/history.rss"], "data_access": true, "sla_target": 99.9, "sla_claim_days": 30}'
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft"
}
GET/PATCH/PUT/DEL /company/suppliers/api/<uuid>/ Supplier detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/suppliers/api/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/
{
"id": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82",
"name": "Wolkensoftware Eidgenossenschaft",
"category": "cloud_saas",
"category_display": "Cloud / SaaS",
"status": "active",
"status_display": "Aktiv",
"risk_level": "high",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"ai_risk_level": "",
"country_code": "ch",
"website": "https://wolkensoftware.example",
"contact_name": "Erika Muster",
"contact_email": "[email protected]",
"data_access": true,
"system_access": false,
"status_page_url": "https://status.wolkensoftware.example",
"status_sources": [
"https://status.wolkensoftware.example/history.rss"
],
"provider_status": {
"state": "degraded",
"label": "Beeinträchtigt",
"summary": "Verzögerte Zustellung",
"disrupted": true,
"since": "2026-05-02T09:40:00+00:00",
"checked_at": "2026-05-02T10:00:00+00:00"
},
"sla": {
"target": 99.9,
"claim_days": 30
},
"document_count": 1,
"contact_phone": "",
"language": "de",
"description": "Mail und Ablage",
"notes": "",
"contingency": "Zweitanbieter aktivieren, Kunden informieren",
"ai_risk_analysis": "",
"backup_strategy": "Tägliche Sicherung im Zweit-RZ",
"backup_last_tested_at": "2026-10-01",
"backup_test_result": "Rücksicherung in 2 h",
"documents": [],
"compliance_requests": [],
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Fileserver FS01"
}
],
"sla_breaches": [
{
"id": "8c1e3a57-9d2b-4f60-a8e4-2b7d5c9f1a36",
"month": "2026-10",
"target": 99.9,
"achieved": 99.583,
"outage_minutes": 180,
"claim_deadline": "2026-11-30",
"claim_sent_at": null
}
],
"created_at": "2026-02-01T09:00:00+00:00",
"updated_at": "2026-05-02T10:00:00+00:00"
}
ICT assessment
7 EndpointsReading 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) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/list/
{
"assessments": [
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt",
"standard_name": "IKT-Minimalstandard",
"rating_max": 4,
"overall_score": 2.1,
"completion_percent": 40,
"maturity_label": "Wiederholbar",
"created_at": "2026-04-02T10:00:00+00:00",
"created_by": "Max Muster",
"is_auto": false,
"read_only": false
}
]
}
GET /company/ict/api/catalog/ Requirements catalog of a standard (functions, categories, requirements; ?standard=ikt|isms|vvt|tom|din27076|nistcsf2) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/catalog/?standard=ikt
{
"standard_slug": "ikt",
"standard_name": "IKT-Minimalstandard",
"rating_max": 4,
"rating_choices": [
{ "value": "na", "label": "Nicht anwendbar" },
{ "value": "0", "label": "0 – Nicht umgesetzt" }
],
"functions": [
{
"code": "ID",
"short_code": "ID",
"name": "Identifizieren",
"description": "…",
"categories": [
{
"code": "ID.AM",
"short_code": "AM",
"name": "Asset Management",
"items": [
{
"id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"code": "ID.AM-1",
"title": "Inventar der Geräte",
"description": "…",
"priority": 1
}
]
}
]
}
]
}
POST /company/ict/api/new/ Create assessment ▶
curl -X POST https://portal.cybertell.io/company/ict/api/new/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"standard": "ikt", "title": "IKT-Minimalstandard 2026"}'
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"prefilled": 0,
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt"
}
GET/DEL /company/ict/api/<uuid>/ Assessment detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/
{
"id": "9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20",
"title": "IKT-Minimalstandard 2026",
"version": "1.0",
"standard_slug": "ikt",
"rating_max": 4,
"overall_score": 2.1,
"completion_percent": 40,
"maturity_label": "Wiederholbar",
"is_complete": false,
"is_auto": false,
"read_only": false,
"created_at": "2026-04-02T10:00:00+00:00",
"functions": [
{
"code": "ID",
"short_code": "ID",
"name": "Identifizieren",
"description": "…",
"score": 2.4,
"categories": [
{
"code": "ID.AM",
"short_code": "AM",
"name": "Asset Management",
"score": 2.0,
"items": [
{
"id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"uuid": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20",
"code": "ID.AM-1",
"title": "Inventar der Geräte",
"priority": 1,
"rating": "3",
"comment": "Inventar in Asset-Register"
}
]
}
]
}
]
}
POST /company/ict/api/<uuid>/save-response/ Save answer ▶
curl -X POST https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/save-response/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"item_id": "5a7c9e13-4b6d-4f80-9a25-1e3d5f7a9c20", "rating": "3", "comment": "MFA aktiv"}'
{
"ok": true,
"completion_percent": 42,
"overall_score": 2.2,
"review_status": "",
"transferred": []
}
GET /company/ict/api/standards/ Available compliance standards ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ict/api/standards/
{
"standards": [
{
"slug": "ikt",
"name": "IKT-Minimalstandard",
"description": "Bundesamt für wirtschaftliche Landesversorgung",
"rating_max": 4,
"is_status_scale": false
}
]
}
GET /company/ict/api/<uuid>/pdf/ Compliance report as PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o compliance-report.pdf https://portal.cybertell.io/company/ict/api/9d2f4b80-3c6e-4a15-8b97-1d5f3a7c9e20/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="compliance-report.pdf" %PDF-1.7 …
AD assessment
3 EndpointsReading requires the module on the key; create, update and delete for company admins only.
GET /company/ad/api/list/ List AD dumps ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ad/api/list/
{
"dumps": [
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"filename": "ad_dump.json",
"status": "analysed",
"risk_score": 62,
"risk_level": "Hoch",
"risk_color": "warning",
"user_count": 140,
"computer_count": 96,
"has_ai_recommendations": true,
"created_at": "2026-05-10T09:00:00+00:00",
"uploaded_by": "Max Muster"
}
]
}
POST /company/ad/api/upload/ Upload AD dump ▶
curl -X POST https://portal.cybertell.io/company/ad/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "dump_file=@ad_dump.json"
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"status": "analysed"
}
GET /company/ad/api/<uuid>/ Dump detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/ad/api/3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74/
{
"id": "3c5e7a92-1b4d-4f68-9a03-6e2d8c1f5b74",
"filename": "ad_dump.json",
"status": "analysed",
"risk_score": 62,
"risk_level": "Hoch",
"risk_color": "warning",
"ai_recommendations": "…",
"user_count": 140,
"computer_count": 96,
"group_count": 31,
"risks": [
{ "severity": "high", "title": "Kerberoastable accounts" }
],
"password_policy": { "min_length": 8 },
"domain_info": { "name": "murmelibach.local" },
"created_at": "2026-05-10T09:00:00+00:00"
}
Microsoft 365 assessment
3 EndpointsReading requires the module on the key; create, update and delete for company admins only.
GET /company/azure/api/list/ List Azure dumps ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/azure/api/list/
{
"dumps": [
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"filename": "azure_export.json",
"status": "analysed",
"risk_score": 45,
"risk_level": "Mittel",
"risk_color": "warning",
"user_count": 140,
"has_ai_recommendations": true,
"created_at": "2026-05-10T09:00:00+00:00",
"uploaded_by": "Max Muster"
}
]
}
POST /company/azure/api/upload/ Upload Azure dump ▶
curl -X POST https://portal.cybertell.io/company/azure/api/upload/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "dump_file=@azure_export.json"
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"status": "analysed"
}
GET /company/azure/api/<uuid>/ Dump detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/azure/api/2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60/
{
"id": "2b4d6f81-9c3e-4a05-8b27-5d1f7a3c9e60",
"filename": "azure_export.json",
"status": "analysed",
"risk_score": 45,
"risk_level": "Mittel",
"risk_color": "warning",
"ai_recommendations": "…",
"user_count": 140,
"role_count": 12,
"app_count": 27,
"risks": [
{ "severity": "medium", "title": "Legacy auth aktiv" }
],
"security_defaults": { "enabled": false },
"conditional_access": [],
"checks": [
{ "id": "M365.AAD.02", "workload": "entra", "status": "fail", "severity": "critical", "title": "Conditional-Access-Richtlinie vorhanden", "evidence": "…", "fix": "…", "refs": ["CIS 5.2.2.1"] }
],
"workloads": [
{ "key": "entra", "label": "Entra ID", "collected": true, "skip_reason": "", "passed": 18, "failed": 4, "skipped": 0 }
],
"created_at": "2026-05-10T09:00:00+00:00"
}
Risk management
2 EndpointsGET /company/risk/api/list/ List risks ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/risk/api/list/
{
"risks": [
{
"id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
"title": "Ransomware",
"category": "technical",
"category_display": "Technisch",
"likelihood": 3,
"impact": 4,
"risk_score": 12,
"risk_level": "high",
"risk_level_display": "Hoch",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium",
"treatment": "Offline-Backups einführen",
"treatment_display": "Offline-Backups einführen",
"owner": "Max Muster",
"updated_at": "2026-05-02T10:00:00+00:00"
}
]
}
POST /company/risk/api/create/ Create risk ▶
curl -X POST https://portal.cybertell.io/company/risk/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware", "category": "technical", "threat": "Verschlüsselung", "vulnerability": "Kein Offline-Backup", "likelihood": 3, "impact": 4, "target_likelihood": 1, "target_impact": 4, "owner": "Max Muster", "treatment": "Offline-Backups einführen"}'
{
"id": "b3d5f719-2c4e-4a86-9f03-7d1a5c9e2b40",
"title": "Ransomware",
"target_likelihood": 1,
"target_impact": 4,
"target_score": 4,
"target_level": "medium"
}
Dependencies & Outage
16 EndpointsReading 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 ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/mobile/
{
"node_count": 14,
"edge_count": 22,
"process_count": 5,
"spof": [],
"scenarios": []
}
GET /company/data-flows/api/map/ Map: all nodes, flows and groups ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/map/
{
"nodes": [
{
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"kind": "supplier",
"label": "Hosting AG",
"criticality": "high"
}
],
"edges": [
{
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
],
"groups": [
{
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
]
}
POST /company/data-flows/api/nodes/ Place a supplier, asset or process on the map (idempotent) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/nodes/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82"}'
{
"ok": true,
"node": {
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"uuid": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"kind": "supplier",
"label": "Hosting AG",
"criticality": "high"
}
}
DEL /company/data-flows/api/nodes/<uuid>/ Remove a node and its flows from the map; the supplier, asset or process remains ▶
curl -X DELETE https://portal.cybertell.io/company/data-flows/api/nodes/5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…"
{
"ok": true
}
POST /company/data-flows/api/edges/ Create a flow between two nodes ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/edges/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"source": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26", "target": "8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20", "flow_type": "service", "data_categories": ["customer"]}'
{
"ok": true,
"edge": {
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
}
PATCH/DEL /company/data-flows/api/edges/<uuid>/ Change a flow (only the fields sent) or delete it ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/edges/9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"is_redundant": true}'
{
"ok": true,
"edge": {
"uuid": "9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47",
"source": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"target": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"flow_type": "service",
"direction": "forward",
"is_redundant": false,
"impacts_target": true,
"impacts_source": false,
"data_categories": [
"customer"
],
"description": "Hosting des Shops"
}
}
GET/POST /company/data-flows/api/processes/ List or create business processes (placed on the map right away) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/processes/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Auftragsabwicklung", "criticality": "high", "rto_hours": 8, "mtpd_hours": 24}'
{
"process": {
"uuid": "2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82",
"name": "Auftragsabwicklung",
"description": "",
"criticality": "high",
"rto_hours": 8,
"mtpd_hours": 24,
"rpo_hours": 4,
"owner_email": "[email protected]"
}
}
GET/PATCH/DEL /company/data-flows/api/processes/<uuid>/ Read, change or delete a business process ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/processes/2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"rpo_hours": 4}'
{
"process": {
"uuid": "2c4e6a80-1b3d-4f57-9a6b-8c0d2e4f6a82",
"name": "Auftragsabwicklung",
"description": "",
"criticality": "high",
"rto_hours": 8,
"mtpd_hours": 24,
"rpo_hours": 4,
"owner_email": "[email protected]"
}
}
GET/POST /company/data-flows/api/groups/ List or create groups ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/groups/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"name": "Hosting", "nodes": ["5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"]}'
{
"ok": true,
"group": {
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
}
GET/PATCH/DEL /company/data-flows/api/groups/<uuid>/ Rename a group, set (nodes), add (add) or remove (remove) nodes, or delete the group ▶
curl -X PATCH https://portal.cybertell.io/company/data-flows/api/groups/4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"add": ["8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20"]}'
{
"ok": true,
"group": {
"id": "g_4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"uuid": "4f6a8c0e-2b4d-4e69-8a1c-3e5f7a9c1b35",
"name": "Hosting",
"nodes": [
"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26"
]
}
}
POST /company/data-flows/api/simulation/ Simulate an outage without saving anything (trigger by node or by supplier, asset, process) ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/simulation/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "outage_hours": 24}'
{
"ok": true,
"outage_hours": 24,
"counts": {
"total": 2,
"critical": 1,
"high": 1,
"mtpd_breached": 0,
"rto_breached": 1
},
"affected": [
{
"id": "n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20",
"label": "Auftragsabwicklung",
"kind": "process",
"via_rule": "single",
"via_source_label": "Hosting AG"
}
],
"processes": [
{
"label": "Auftragsabwicklung",
"rto": 8,
"mtpd": 24,
"rto_breached": true
}
],
"affected_edges": [
"e_9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47"
]
}
GET/POST /company/data-flows/api/scenarios/ List saved scenarios or save a simulation as a scenario ▶
curl -X POST https://portal.cybertell.io/company/data-flows/api/scenarios/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"kind": "supplier", "ref_uuid": "6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82", "outage_hours": 24, "name": "Hoster 24 h weg"}'
{
"ok": true,
"scenario": {
"uuid": "2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81",
"name": "Hoster 24 h weg",
"trigger_label": "Hosting AG",
"trigger_kind": "supplier",
"trigger_node": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"outage_hours": 24,
"counts": {
"total": 2,
"mtpd_breached": 0
},
"has_assessment": false,
"result": {},
"ai_assessment": "",
"ai_assessed_at": null,
"created_at": "2026-05-14T10:00:00+00:00"
}
}
GET/DEL /company/data-flows/api/scenarios/<uuid>/ Read a scenario with its result or delete it ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/scenarios/2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81/
{
"ok": true,
"scenario": {
"uuid": "2a4c6e80-1b3d-4f57-9a6b-8c0d2e4f6a81",
"name": "Hoster 24 h weg",
"trigger_label": "Hosting AG",
"trigger_kind": "supplier",
"trigger_node": "5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"outage_hours": 24,
"counts": {
"total": 2,
"mtpd_breached": 0
},
"has_assessment": false,
"result": {},
"ai_assessment": "",
"ai_assessed_at": null,
"created_at": "2026-05-14T10:00:00+00:00"
}
}
GET /company/data-flows/api/status/ Status page state per node and the impact of ongoing disruptions ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/status/
{
"ok": true,
"nodes": [
{
"id": "n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26",
"url": "https://status.hosting.example",
"state": "outage",
"label": "Ausfall",
"tone": "critical",
"summary": "Rechenzentrum offline",
"since": "2026-05-14T09:12:00+00:00",
"disrupted": true
}
],
"impact": {
"total": 2,
"processes": [
"Auftragsabwicklung"
],
"affected": [
"n_8c0e2a46-3b5d-4f79-9c14-7e1a3d5f9b20"
],
"edges": [
"e_9e1b3d5f-7a9c-4e0b-8d2f-4a6c8e0b2d47"
]
}
}
GET /company/data-flows/api/outages/ Provider disruption history, newest first; ?open=1 only ongoing ones ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/data-flows/api/outages/
{
"outages": [
{
"url": "https://status.hosting.example",
"source": "Hosting AG Status",
"state": "outage",
"label": "Ausfall",
"summary": "Rechenzentrum offline",
"started_at": "2026-05-14T09:12:00+00:00",
"ended_at": null,
"open": true,
"duration_minutes": null,
"affected": [
"Hosting AG"
]
}
]
}
GET/PUT /company/data-flows/api/layout/ Read and set node positions ▶
curl -X PUT https://portal.cybertell.io/company/data-flows/api/layout/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"positions": {"n_5a7c9e13-2b4d-4f68-8a0c-1e3f5b7d9a26": {"x": 0, "y": 160}}}'
{
"ok": true,
"updated": 1
}
Backup & Recovery
1 EndpointGET /company/backups/api/mobile/ Backup plans with restore tests and unprotected assets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/backups/api/mobile/
{
"is_admin": true,
"kpi": {
"active": 1,
"tests_overdue": 0,
"not_resilient": 0,
"unprotected": 1,
"exempted": 0
},
"plans": [
{
"id": "3b5d7f91-2c4e-4a68-8d0b-1f3a5c7e9b02",
"name": "Fileserver täglich",
"scope": "Alle Freigaben",
"status": "active",
"status_display": "Aktiv",
"frequency": "daily",
"frequency_display": "Täglich",
"weekdays": [],
"schedule_display": "Täglich",
"location": "cloud",
"location_display": "Cloud",
"location_detail": "",
"tool": "Veeam",
"template_key": "",
"retention_days": 30,
"rpo_hours": 24,
"rpo_gap": false,
"has_offline_copy": true,
"is_immutable": false,
"is_encrypted": true,
"is_monitored": true,
"is_ransomware_resilient": true,
"owner": "Alma Admin",
"test_interval_months": 6,
"next_test_due": "2026-11-12",
"test_overdue": false,
"asset_names": ["Fileserver"],
"tips": [],
"tests": [
{
"id": "9e1a3c5b-7d2f-4b46-8a80-2c4e6f8a0b13",
"tested_on": "2026-05-12",
"scope": "file",
"scope_display": "Einzelne Dateien",
"result": "success",
"result_display": "Erfolgreich",
"duration_minutes": 45,
"tested_by": "Alma Admin",
"findings": ""
}
]
}
],
"unprotected_assets": [
{
"id": "4c6e8a02-3d5f-4b79-9e1c-2a4b6d8f0c14",
"name": "ERP",
"criticality": "critical",
"criticality_display": "Kritisch"
}
],
"exempted_assets": []
}
Attack surface
1 EndpointGET /company/attack-surface/api/mobile/ Key figures, latest scan, open findings and assets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/attack-surface/api/mobile/
{
"is_admin": true,
"stats": {
"hosts": 3,
"ips": 2,
"open_ports": 5,
"cves": 1,
"open_findings": 1,
"by_severity": {"critical": 0, "high": 1, "medium": 0, "low": 0, "info": 0}
},
"budget": {"limit": 200, "used": 26, "remaining": 174, "blocked": false},
"scan": {
"id": "8a0c2e4a-7b9d-4f13-8a2b-6c8d0e2f4a57",
"domain": "beispiel.ch",
"status": "done",
"status_display": "Abgeschlossen",
"created_at": "2026-05-16T07:00:00+00:00",
"completed_at": "2026-05-16T07:02:10+00:00",
"new_assets": 1,
"new_findings": 1,
"changes": {"new_assets": 1, "new_ports": 2},
"error": ""
},
"findings": [
{
"id": "0c2e4a6c-9d1f-4b35-9c4d-8e0f2a4b6c79",
"kind": "risky_port",
"kind_display": "Riskanter Port",
"severity": "high",
"severity_display": "Hoch",
"subject": "203.0.113.5:3389",
"domain": "beispiel.ch",
"status": "open",
"status_display": "Offen",
"first_seen_at": "2026-05-16T07:02:00+00:00",
"last_seen_at": "2026-05-16T07:02:00+00:00",
"note": "Hoster informiert",
"asset_id": "2e4a6c8e-1f3b-4d57-8e6f-0a2b4c6d8e91",
"risk": {"id": "4a6c8e0a-3b5d-4f79-8a8b-2c4d6e8f0a13", "title": "RDP offen", "level": "high", "status": "assessed"}
}
],
"assets": [
{
"id": "2e4a6c8e-1f3b-4d57-8e6f-0a2b4c6d8e91",
"kind": "ip",
"kind_display": "IP-Adresse",
"value": "203.0.113.5",
"domain": "beispiel.ch",
"ports": [443, 3389],
"vuln_count": 1,
"last_seen": "2026-05-16T07:02:00+00:00",
"technologies": ["nginx 1.24.0"],
"note": "",
"excluded": false,
"shared": false,
"register_asset": null
}
]
}
Banning orders
3 EndpointsGET /company/banning-orders/api/list/ List banning orders (newest 100) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/banning-orders/api/list/
{
"hausverbote": [
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"firstname": "Unbekannt",
"lastname": "männlich",
"status": "aktiv",
"reason": "Hausfriedensbruch",
"location": "Filiale Tannenhof",
"ban_date": "2026-05-16",
"ban_until": "2027-05-16",
"photo_url": null,
"violation_count": 0
}
]
}
POST /company/banning-orders/api/create/ Create banning order ▶
curl -X POST https://portal.cybertell.io/company/banning-orders/api/create/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -F "firstname=Unbekannt" \ -F "lastname=männlich" \ -F "reason=Hausfriedensbruch" \ -F "location=Filiale Tannenhof" \ -F "ban_date=2026-05-16" \ -F "ban_until=2027-05-16" \ -F "[email protected]"
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"status": "ok"
}
GET/PATCH/PUT/DEL /company/banning-orders/api/<uuid>/ Banning order detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/banning-orders/api/8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60/
{
"id": "8f0b2d46-1a3c-4e75-9b82-5d7f1a3c9e60",
"firstname": "Unbekannt",
"lastname": "männlich",
"date_of_birth": null,
"photo_url": null,
"description": "",
"street": "",
"postal_code": "",
"city": "",
"country": "",
"reason": "Hausfriedensbruch",
"location": "Filiale Tannenhof",
"ban_date": "2026-05-16",
"ban_until": "2027-05-16",
"status": "aktiv",
"notes": "",
"violations": [
{
"id": "0a2c4e68-1b3d-4f75-9c18-5e7a9c1d3f60",
"date": "2026-06-01",
"description": "Erneut im Laden",
"reported_to_police": true,
"notes": ""
}
],
"can_edit": true,
"can_manage": true
}
Tabletop exercises
6 EndpointsGET /company/tabletop/api/scenarios/ List scenarios ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/scenarios/
{
"scenarios": [
{
"id": "1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02",
"title": "Ransomware Krisenfall",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "hard",
"difficulty_display": "Schwer",
"narrative": "Montagmorgen, 07:15 Uhr …",
"duration_min": 90,
"target_roles": "Geschäftsleitung, IT",
"phase_count": 6,
"created_at": "2026-05-02T09:00:00+00:00"
}
]
}
POST /company/tabletop/api/scenarios/generate/ Generate scenario (AI) ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/scenarios/generate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"scenario_type": "ransomware", "difficulty": "hard", "extra_context": "", "phase_count": 8}'
{
"job_id": "6d8f0a24-5c7e-4b91-8a36-2f4a6c8e0d51",
"status": "generating"
}
GET /company/tabletop/api/scenarios/<uuid>/ Scenario detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/scenarios/1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02/
{
"id": "1a3c5e79-2b4d-4f80-9c16-7e9a1d3f5b02",
"title": "Ransomware Krisenfall",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "hard",
"narrative": "Montagmorgen, 07:15 Uhr …",
"duration_min": 90,
"target_roles": "Geschäftsleitung, IT",
"learning_goals": "Entscheidungswege unter Zeitdruck üben",
"phases": [
{
"id": "2b4d6f80-3c5e-4a91-8b27-3e5a7c9e1b02",
"order": 1,
"title": "Erste Meldung",
"situation": "Der Fileserver antwortet nicht mehr.",
"time_pressure": "15 Minuten",
"discussion_question": "Wer wird sofort informiert?",
"choices": [
{ "label": "A", "text": "IT-Leitung informieren", "consequence": "…", "is_recommended": true }
]
}
]
}
GET /company/tabletop/api/negotiations/ List negotiations ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/negotiations/
{
"negotiations": [
{
"id": "7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24",
"scenario_type": "ransomware",
"scenario_type_display": "Ransomware",
"difficulty": "medium",
"status": "active",
"initial_ransom": 250000,
"current_ransom": 125000,
"trust_level": 40,
"threat_level": 70,
"score": null,
"outcome": "",
"message_count": 6,
"started_at": "2026-05-16T09:00:00+00:00",
"completed_at": null
}
]
}
GET /company/tabletop/api/negotiations/<uuid>/ Negotiation detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/
{
"id": "7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24",
"scenario_type": "ransomware",
"scenario_briefing": "Ihre Server sind verschlüsselt …",
"difficulty": "medium",
"status": "active",
"initial_ransom": 250000,
"current_ransom": 125000,
"deadline_hours": 48,
"trust_level": 40,
"threat_level": 70,
"score": null,
"outcome": "",
"ai_feedback": "",
"messages": [
{ "role": "attacker", "content": "Sie haben 48 Stunden.", "timestamp": "2026-05-16T09:00:00+00:00" }
],
"started_at": "2026-05-16T09:00:00+00:00"
}
POST /company/tabletop/api/negotiations/<uuid>/message/ Send message ▶
curl -X POST https://portal.cybertell.io/company/tabletop/api/negotiations/7c9e1b35-4a2d-4f68-8b90-1e5d3a7c9f24/message/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"message": "Wir benötigen mehr Zeit."}'
{
"message": "Sie haben 24 Stunden.",
"current_ransom": 125000,
"trust_level": 35,
"threat_level": 75,
"status": "active",
"outcome": ""
}
SOC, device fleet & threat report
8 EndpointsGET /company/api/soc/status/ SOC hub status (configured firewall) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/status/
{
"firewalla": true,
"sophos": false,
"defender": false,
"pfsense": false,
"waf": true
}
GET/POST /company/api/threat-reports/config/ Read / save threat report configuration (role_id as UUID or internal integer) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/threat-reports/config/
{
"configs": [
{
"id": 3,
"role_id": 12,
"role_uuid": "b2c3d4e5-2222-4b3c-9d4e-5f6a7b8c9d01",
"role_name": "Geschäftsleitung",
"frequency": "monthly",
"send_hour": 8,
"send_weekday": 0,
"send_day": 1,
"sections": ["lage_schweiz", "eigene_vorfaelle"],
"is_active": true,
"include_ai_summary": true
}
],
"available_sections": [
{ "key": "lage_schweiz", "label": "Lage Schweiz" }
]
}
GET /company/api/soc/<provider>/live/ Live data of a SOC provider (provider = firewalla, pfsense, sophos, defender, graylog; time window ?start_ts=&end_ts=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/firewalla/live/?start_ts=1778914800&end_ts=1778918400
{
"provider": "firewalla",
"capabilities": { "label": "Firewalla", "device_assignments": true },
"soc_stats": {
"threat_level": "medium",
"alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
"total_alarms": 7,
"boxes_online": 2,
"boxes_total": 2,
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880
},
"flow_map": [
{ "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
],
"recent_blocked": [
{ "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
],
"suspicious": [
{ "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
],
"company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
"blocked_countries": ["RU", "KP"]
}
GET /company/api/soc/<provider>/device-flows/ Aggregated flows of one device in the last hour (?device= required, optional ?region=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/soc/firewalla/device-flows/?device=WS-042
{
"device": "WS-042",
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880,
"filter_region": "",
"top_domains": [
{ "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
],
"top_regions": [
{ "region": "CH", "count": 640, "blocked": 0 }
]
}
GET/POST/DEL /company/api/soc/<provider>/device-assignments/ Assign devices to employees (admin; mitarbeiter_id as UUID or internal integer) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/device-assignments/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"device_key": "AA:BB:CC:DD:EE:FF", "device_name": "WS-042", "context_id": "0a1b2c3d", "mitarbeiter_id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "notes": ""}'
{
"ok": true,
"created": true,
"assignment": {
"id": 7,
"provider": "firewalla",
"device_key": "AA:BB:CC:DD:EE:FF",
"device_name": "WS-042",
"context_id": "0a1b2c3d",
"mitarbeiter_id": 42,
"mitarbeiter_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"mitarbeiter_name": "Max Muster",
"assigned_at": "2026-05-16T08:10:00+00:00",
"notes": ""
}
}
POST /company/api/soc/<provider>/alarm-ai/ AI analysis of an alarm (form fields; also at /company/api/firewalla/alarm-ai/) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/alarm-ai/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'alarm_type=Abnormal Upload' \ --data-urlencode 'severity=high' \ --data-urlencode 'device=NAS-Buero' \ --data-urlencode 'target=203.0.113.50' \ --data-urlencode 'message=2.1 GB in 10 min' \ --data-urlencode 'timestamp=2026-05-16T07:40:00Z'
{
"analysis": "ZUSAMMENFASSUNG: …"
}
POST /company/api/soc/<provider>/suspicious-analyse/ Check a suspicious destination (action=vt|ai|both; also at /company/api/firewalla/suspicious-analyse/) ▶
curl -X POST https://portal.cybertell.io/company/api/soc/firewalla/suspicious-analyse/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'action=both' \ --data-urlencode 'type=blocked_flow' \ --data-urlencode 'title=Blockiertes Ziel' \ --data-urlencode 'detail=WS-042 nach RU' \ --data-urlencode 'domains=198.51.100.7' \ --data-urlencode 'severity=low' \ --data-urlencode 'region=RU'
{
"vt": [
{ "url": "198.51.100.7", "verdict": "malicious", "source": "ipsum", "score": 4 }
],
"ai": "ZUSAMMENFASSUNG: …"
}
GET /company/api/threat-report/latest/ Latest threat report ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/threat-report/latest/
{
"report": {
"sent_at": "2026-05-01T06:00:00+00:00",
"recipient_count": 3,
"ai_summary": "Im April dominierten QR-Phishing und Rechnungsbetrug.",
"sections": ["lage_schweiz", "eigene_vorfaelle"],
"role": "Geschäftsleitung"
}
}
Firewalla integration
13 EndpointsGET /company/api/firewalla/overview/ Dashboard overview ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/overview/
{
"stats": {
"box_count": 2,
"online_count": 2,
"offline_count": 0,
"alarm_count": 7,
"alarm_severity": { "high": 1, "medium": 2, "info": 4 },
"rule_count": 64,
"block_rule_count": 40,
"allow_rule_count": 24,
"target_list_count": 3,
"blocked_domain_count": 12
},
"boxes": [
{
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
}
],
"recent_alarms": [
{
"id": "a-901",
"type": "Sicherheitsaktivität",
"message": "Verbindung zu bekannter Malware-Domain",
"device": "WS-042",
"target": "boese-domain.example",
"timestamp": "16.05.2026 08:05",
"severity": "high",
"box_id": "0a1b2c3d"
}
],
"rules": [
{
"id": "55",
"type": "dns",
"target": "boese-domain.example",
"action": "block",
"direction": "outbound",
"protocol": "",
"scope": "",
"expire": 0,
"created_at": "10.05.2026 09:00",
"paused": false
}
],
"target_lists": [
{ "id": "TL-1", "name": "CyberTell Blocklist", "target_count": 12, "owner": "" }
],
"blocked_domains": ["boese-domain.example"]
}
GET /company/api/firewalla/boxes/ List devices (boxes) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/
{
"boxes": [
{
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
}
]
}
GET /company/api/firewalla/boxes/<box_id>/ Box detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/
{
"box_id": "0a1b2c3d",
"box": {
"id": "0a1b2c3d",
"name": "Gold Murmelibach",
"model": "gold",
"version": "1.979",
"license": "MSP",
"ip": "203.0.113.20",
"local_ip": "10.0.0.1",
"mac": "AA:BB:CC:00:11:22",
"mode": "router",
"network_count": 3,
"device_count": 38,
"uptime": 864000,
"last_active": "16.05.2026 08:00",
"online": true,
"location": "Murmelibach"
},
"alarms": [
{
"id": "a-901",
"type": "Sicherheitsaktivität",
"message": "Verbindung zu bekannter Malware-Domain",
"device": "WS-042",
"target": "boese-domain.example",
"timestamp": "16.05.2026 08:05",
"severity": "high",
"box_id": "0a1b2c3d"
}
],
"rules": [
{
"id": "55",
"type": "dns",
"target": "boese-domain.example",
"action": "block",
"direction": "outbound",
"protocol": "",
"scope": "",
"expire": 0,
"created_at": "10.05.2026 09:00",
"paused": false
}
],
"devices": [
{
"id": "AA:BB:CC:DD:EE:FF",
"mac": "AA:BB:CC:DD:EE:FF",
"mac_vendor": "Dell",
"ip": "10.0.0.42",
"name": "WS-042",
"online": true,
"last_seen": "16.05.2026 08:00",
"total_download": 41984000,
"total_upload": 5242880,
"assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
}
]
}
GET /company/api/firewalla/boxes/<box_id>/devices/ Devices of a box ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/boxes/0a1b2c3d/devices/
{
"box_id": "0a1b2c3d",
"devices": [
{
"id": "AA:BB:CC:DD:EE:FF",
"mac": "AA:BB:CC:DD:EE:FF",
"mac_vendor": "Dell",
"ip": "10.0.0.42",
"name": "WS-042",
"online": true,
"last_seen": "16.05.2026 08:00",
"total_download": 41984000,
"total_upload": 5242880,
"assignment": { "mitarbeiter_id": 42, "mitarbeiter_name": "Max Muster", "assigned_at": "2026-05-16T08:10:00+00:00" }
}
],
"count": 1
}
GET /company/api/firewalla/flows/ Traffic flows (?query=, ?groupBy=, ?sortBy=, ?cursor=, ?limit= default 50, max. 500) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/flows/?limit=200
{
"flows": [
{
"ts": "16.05.2026 08:00",
"ts_epoch": 1778918400.0,
"protocol": "tcp",
"dport": "443",
"sport": "",
"direction": "outbound",
"download": 10240,
"upload": 2048,
"category": "",
"region": "US",
"device": "WS-042",
"device_ip": "10.0.0.42",
"source": "",
"destination": "example.com",
"dest_ip": "93.184.216.34",
"blocked": false,
"duration": 0.4,
"count": 1
}
],
"count": 1,
"next_cursor": ""
}
GET /company/api/firewalla/device-flows/ Device traffic (?device= required, optional ?region=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/device-flows/?device=WS-042
{
"device": "WS-042",
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880,
"filter_region": "",
"top_domains": [
{ "domain": "example.ch", "count": 120, "blocked": 0, "download": 10485760, "upload": 524288 }
],
"top_regions": [
{ "region": "CH", "count": 640, "blocked": 0 }
]
}
GET /company/api/firewalla/stats/ Fleet statistics ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/stats/
{
"stats": { "onlineBoxes": 2, "offlineBoxes": 0, "alarms": 7, "rules": 64 }
}
GET /company/api/firewalla/soc-live/ Live SOC feed ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/firewalla/soc-live/
{
"provider": "firewalla",
"capabilities": { "label": "Firewalla", "device_assignments": true },
"soc_stats": {
"threat_level": "medium",
"alarm_counts": { "critical": 0, "high": 1, "medium": 2, "low": 0, "info": 4 },
"total_alarms": 7,
"boxes_online": 2,
"boxes_total": 2,
"total_flows": 812,
"blocked_flows": 14,
"blocked_ratio": 1.72,
"total_download": 41984000,
"total_upload": 5242880
},
"flow_map": [
{ "key": "US_Ashburn", "region": "US", "city": "Ashburn", "lat": 39.04, "lng": -77.49, "count": 120, "blocked_count": 0, "download": 10485760, "upload": 524288, "critical": false, "vpn": false, "top_devices": [{ "name": "WS-042", "count": 80 }], "top_domains": [{ "name": "example.com", "count": 40 }] }
],
"recent_blocked": [
{ "ts_epoch": 1778918700.0, "destination": "boese-domain.example", "device": "WS-042", "region": "RU" }
],
"suspicious": [
{ "type": "critical_country", "severity": "high", "icon": "alert-triangle", "title": "Verbindungen nach RU", "detail": "…", "devices": ["WS-042"], "region": "RU" }
],
"company_location": { "country_code": "CH", "lat": 46.82, "lng": 8.23 },
"blocked_countries": ["RU", "KP"]
}
GET/POST/DEL /company/api/firewalla/blocked-countries/ Blocked countries ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/blocked-countries/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"country_code": "RU"}'
{
"success": true,
"country_code": "RU",
"action": "blocked"
}
GET/POST/DEL /company/api/firewalla/blocked-domains/ Manage blocked domains ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/blocked-domains/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"domain": "boese-domain.example"}'
{
"ok": true,
"message": "boese-domain.example blockiert."
}
GET/POST/DEL /company/api/firewalla/device-assignments/ Manage device assignments (mitarbeiter_id as UUID or internal integer) ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/device-assignments/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"mac": "AA:BB:CC:DD:EE:FF", "device_name": "WS-042", "box_id": "0a1b2c3d", "mitarbeiter_id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "notes": ""}'
{
"ok": true,
"created": true,
"assignment": {
"id": 7,
"device_mac": "AA:BB:CC:DD:EE:FF",
"device_name": "WS-042",
"box_id": "0a1b2c3d",
"mitarbeiter_id": 42,
"mitarbeiter_uuid": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64",
"mitarbeiter_name": "Max Muster"
}
}
POST /company/api/firewalla/rules/<rule_id>/pause/ Pause rule ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/pause/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"message": "Regel 55 pausiert."
}
POST /company/api/firewalla/rules/<rule_id>/resume/ Resume rule ▶
curl -X POST https://portal.cybertell.io/company/api/firewalla/rules/55/resume/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"message": "Regel 55 fortgesetzt."
}
Playbooks (incident response)
14 EndpointsGET /company/playbooks/api/list/ List playbooks ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/list/
{
"playbooks": [
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"description": "Sofortmassnahmen bei Verschlüsselung",
"topic": "ransomware",
"topic_display": "Ransomware-Angriff",
"version": "1.0",
"updated_at": "2026-05-02T10:00:00+00:00",
"scope": "standard",
"has_steps": true
}
]
}
POST /company/playbooks/api/create/ Create playbook (optionally with AI content, ai_generate) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/create/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"title": "Ransomware Response", "topic": "ransomware", "version": "1.0", "description": "Sofortmassnahmen bei Verschlüsselung", "scope": "standard", "ai_generate": true}'
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response"
}
GET /company/playbooks/api/<uuid>/ Playbook detail ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/
{
"id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"description": "Sofortmassnahmen bei Verschlüsselung",
"topic": "ransomware",
"topic_display": "Ransomware-Angriff",
"version": "1.0",
"updated_at": "2026-05-02T10:00:00+00:00",
"scope": "standard",
"has_steps": true,
"sections": [
{
"id": "4a6c8e02-1b3d-4f59-9c87-2e5a7d1f3b06",
"title": "Sofortmassnahmen",
"content": "Betroffene Hosts isolieren …",
"order": 0,
"intro": "",
"preparation": "",
"condition": "",
"block_key": "",
"has_steps": true,
"steps": [
{ "id": "e4b8c2d6-1a3f-4c57-9e80-2b4d6f8a0c13", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Incident Lead", "time_mark": "", "condition": "", "module_key": "", "order": 0 }
]
}
],
"roles": [
{ "id": "5b7d9f21-3c4e-4a86-9b05-1d3f5a7c9e20", "role_type": "intern", "name": "Max Muster", "role_title": "Incident Lead", "email": "[email protected]", "phone": "", "notes": "" }
]
}
GET /company/playbooks/api/<uuid>/pdf/ Playbook as PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o playbook.pdf https://portal.cybertell.io/company/playbooks/api/3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="playbook.pdf" %PDF-1.7 …
GET /company/playbooks/api/runs/ List runs (?status=laufend|finished|abgeschlossen|abgebrochen, ?kind=drill|incident) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/?status=laufend
{
"runs": [
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"playbook_id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44",
"title": "Ransomware Response",
"kind": "incident", "kind_display": "Ernstfall",
"status": "laufend", "status_display": "Laufend", "is_running": true,
"started_at": "2026-10-11T08:15:00+00:00",
"warroom": { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" },
"ticket": null,
"counts": { "done": 2, "open": 5, "skipped": 0, "na": 1, "visible": 7, "percent": 29 }
}
]
}
GET /company/playbooks/api/runs/options/ Options for activation: playbooks with case-check questions, systems, service providers, war rooms, tickets ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/options/
{
"playbooks": [ { "id": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "title": "Ransomware Response", "topic": "ransomware", "questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ] } ],
"asset_groups": [ { "key": "system", "label": "System", "assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster" } ] } ],
"supplier_groups": [ { "key": "it_infrastructure", "label": "IT-Infrastruktur", "assets": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "criticality": "active", "criticality_label": "Aktiv", "owner": "" } ] } ],
"warrooms": [ { "id": "0c9e2b14-6d7f-4a35-8b19-5e3c1d7a9f62", "title": "Vorfall Buchhaltung", "short_code": "WR-0012" } ],
"tickets": [ { "id": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "title": "Verschlüsselte Dateien", "short_code": "T-0481" } ],
"can_pick_assets": true
}
POST /company/playbooks/api/runs/activate/ Start a run (drill or incident) with systems, service providers, link and case check ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/activate/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"playbook": "3f2a9c10-7b4e-4c21-9a8d-1e5f6b2c0d44", "kind": "incident", "link": "ticket", "ticket": "9d2f4b61-8e0a-4c47-9f36-1b5d7e9a3c84", "assets": ["a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91"], "suppliers": ["b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02"], "answers": {"ransom_demand": true, "data_exfiltrated": null}}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"title": "Ransomware Response", "kind": "incident", "status": "laufend", "is_running": true,
"answers": { "ransom_demand": true },
"questions": [ { "key": "ransom_demand", "kind": "case", "label": "Lösegeldforderung" } ],
"sections": [ { "index": 0, "title": "Sofortmassnahmen", "intro": "Erste Stunde.", "preparation": "", "condition": "", "block_key": "", "state": null, "hidden": false,
"steps": [ { "id": "e4b8c2d6-1f3a-4e59-9b07-2c6d8a0f4e12", "title": "Betroffene Hosts isolieren", "detail": "", "role_title": "Technischer IR-Lead", "time_mark": "0–15 min", "condition": "", "module_key": "warroom", "module": { "key": "warroom", "label": "War Room", "url": "/company/incidents/warroom/" }, "state": "offen", "applicable": true, "open_question": false, "assignee": null, "done_by": null, "done_at": null, "note": "", "ticket": null, "asset_hint": "", "can_change": true } ] } ],
"assets": [ { "uuid": "a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91", "name": "Fileserver Zürich", "asset_type_label": "System", "criticality": "critical", "criticality_label": "Kritisch", "owner": "Max Muster", "supplier": "Hosting AG", "backup_plans": [], "no_backup": true, "open_findings": [], "url": "/company/asset-register/a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91/" } ],
"suppliers": [ { "uuid": "b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02", "name": "Hosting AG", "category_label": "IT-Infrastruktur", "status": "active", "status_label": "Aktiv", "contact_name": "", "contact_email": "[email protected]", "contact_phone": "", "data_access": true, "scope": "", "contingency": "Hotline 24/7", "url": "/company/suppliers/b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02/" } ],
"counts": { "done": 0, "open": 7, "skipped": 0, "na": 0, "visible": 7, "percent": 0 },
"permissions": { "can_operate": true, "can_finish": true, "can_delete": true, "can_edit_assets": true }
}
GET /company/playbooks/api/runs/<uuid>/ Run detail: sections and steps with state, case check, affected systems and service providers, permissions ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"title": "Ransomware Response", "status": "laufend",
"sections": [], "assets": [], "suppliers": [],
"permissions": { "can_operate": true, "can_finish": true, "can_delete": false, "can_edit_assets": true }
}
POST /company/playbooks/api/runs/<uuid>/assets/ Replace affected systems and service providers (without the suppliers key the providers stay unchanged) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/assets/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"assets": ["a1f0c3e5-2b4d-4e68-9a17-6c8d0e2f4a91"], "suppliers": ["b2e1d4f6-3c5e-4f79-8b28-7d9e1f3a5b02"]}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"assets": [], "suppliers": []
}
POST /company/playbooks/api/runs/<uuid>/answers/ Set case-check answers (true, false or null = open) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/answers/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"answers": {"ransom_demand": true, "data_exfiltrated": false, "customers_affected": null}}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"answers": { "ransom_demand": true, "data_exfiltrated": false },
"sections": []
}
POST /company/playbooks/api/runs/<uuid>/steps/<uuid>/state/ Tick, skip or reopen a step (offen|erledigt|uebersprungen), optionally with a note ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/steps/e4b8c2d6-1f3a-4e59-9b07-2c6d8a0f4e12/state/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"state": "erledigt", "note": "Kabel gezogen, 08:21"}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"counts": { "done": 1, "open": 6, "skipped": 0, "na": 0, "visible": 7, "percent": 14 },
"sections": []
}
POST /company/playbooks/api/runs/<uuid>/finish/ Finish or abort a run (action=finish|abort), closing note, optionally create a review ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/finish/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{"action": "finish", "notes": "Wiederanlauf um 14:30 abgeschlossen.", "create_review": true}'
{
"id": "7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40",
"status": "abgeschlossen", "is_running": false,
"review": { "id": "5a3c7e91-2d4f-4b68-8c17-9e1b3d5f7a20", "status": "entwurf" }
}
POST/DEL /company/playbooks/api/runs/<uuid>/delete/ Delete a run (company admin only) ▶
curl -X POST https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/delete/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true
}
GET /company/playbooks/api/runs/<uuid>/pdf/ Run as PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o playbook-lauf.pdf https://portal.cybertell.io/company/playbooks/api/runs/7c1e3a52-9b4d-4f08-8e26-3a5c7d9e1b40/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="playbook-lauf.pdf" %PDF-1.7 …
Security policy
3 EndpointsEmployees retrieve the current security policy and acknowledge it. Acknowledgements are logged as compliance evidence.
GET /company/policy/api/ Fetch current policy ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/policy/api/
{
"version": "4",
"published_at": "2026-04-30T12:00:00+00:00",
"sections": [
{ "key": "password", "title": "Passwort-Richtlinien", "extra": "", "icon": "Key", "sort_order": 1, "is_custom": false,
"body_html": "<ul><li>Passwörter haben mindestens 12 Zeichen.</li></ul>" }
],
"pw_rules": { "min_length": 12, "require_uppercase": true, "require_numbers": true, "require_special": false, "expiry_days": 0, "no_reuse": true },
"incident_contact": { "name": "Max Muster", "email": "[email protected]", "phone": "+41 31 000 00 00" },
"acknowledged": false,
"acknowledged_at": null,
"acknowledged_version": null
}
POST /company/policy/api/acknowledge/ Acknowledge policy (employee) ▶
curl -X POST https://portal.cybertell.io/company/policy/api/acknowledge/ \
-H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "ok"
}
GET /company/policy/api/mobile/pdf/ Policy as PDF ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ -o sicherheitsrichtlinie.pdf https://portal.cybertell.io/company/policy/api/mobile/pdf/?lang=de
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="sicherheitsrichtlinie.pdf" %PDF-1.7 …
Secure documents
1 EndpointGET /company/api/documents/ Shared company documents ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/documents/
{
"documents": [
{
"id": "2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02",
"title": "Notfallkonzept",
"description": "",
"category": "Notfall",
"filename": "notfallkonzept.pdf",
"size": 284120,
"download_url": "/secure-file/2f4a6c80-1b3d-4e75-9a18-5c7e9b1d3f02/",
"can_read": true,
"uploaded_at": "2026-04-02T10:00:00+00:00"
}
]
}
Points
1 EndpointGET /company/api/points/me/ Own points and leaderboard ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/points/me/
{
"points": {
"total": 1840,
"this_month": 260,
"this_month_chf": 26.0,
"monthly_budget_chf": 50.0,
"enabled": true,
"level": "Wachsam",
"level_progress": 0.6,
"next_level_points": 2000,
"my_rank": 3,
"leaderboard": [
{ "rank": 1, "name": "Erika Muster", "points": 2410, "is_me": false },
{ "rank": 3, "name": "Max Muster", "points": 1840, "is_me": true }
]
}
}
Roadmap
2 EndpointsGET /company/roadmap/api/mobile/ Phases, progress and next steps ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/roadmap/api/mobile/
{
"progress": 35,
"phases": [
{
"key": "grundschutz",
"label": "Grundschutz",
"desc": "…",
"done": 6,
"total": 12,
"items": [
{
"key": "module:incidents",
"label": "Vorfall-Meldung aktivieren",
"desc": "…",
"icon": "Shield",
"status": "done",
"cadence": "",
"recurring": false,
"last_done": "2026-05-02T09:00:00+00:00",
"snoozed_until": null,
"planned_date": null,
"overdue": false
}
]
}
],
"next_steps": []
}
POST /company/roadmap/api/mobile/action/ Complete or postpone a step ▶
curl -X POST https://portal.cybertell.io/company/roadmap/api/mobile/action/ \ -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ --data-urlencode 'action=done' \ --data-urlencode 'item_key=module:incidents'
{
"ok": true,
"progress": 38
}
DMARC
2 EndpointsGET /company/dmarc/api/mobile/ DMARC metrics and reports ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/dmarc/api/mobile/
{
"pass_rate": 96,
"failing_sources": 2,
"reporters": 5,
"total_messages": 18240,
"reports": [
{
"uuid": "7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91",
"policy_domain": "murmelibach-ag.ch",
"org_name": "google.com",
"date_begin": "2026-05-14T00:00:00+00:00",
"date_end": "2026-05-15T00:00:00+00:00",
"total_count": 420,
"pass_count": 404,
"pass_rate": 96
}
]
}
GET /company/dmarc/api/mobile/<uuid>/ Report with alignment and failing sources ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/dmarc/api/mobile/7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91/
{
"uuid": "7e9b1d35-4a6c-4f82-8b10-2d4f6a8c0e91",
"policy_domain": "murmelibach-ag.ch",
"org_name": "google.com",
"date_begin": "2026-05-14T00:00:00+00:00",
"date_end": "2026-05-15T00:00:00+00:00",
"total_count": 420,
"pass_count": 404,
"pass_rate": 96,
"pol_p": "quarantine",
"pol_sp": "",
"pol_pct": 100,
"pol_adkim": "r",
"pol_aspf": "r",
"alignment": { "both": 390, "dkim_only": 10, "spf_only": 4, "none": 16 },
"failing_records": [
{
"source_ip": "203.0.113.7",
"count": 16,
"disposition": "quarantine",
"dkim_result": "fail",
"spf_result": "fail",
"dkim_aligned": false,
"spf_aligned": false,
"header_from": "murmelibach-ag.ch"
}
]
}
Incident response
1 EndpointGET /company/api/mobile/incident-response/ Investigations and metrics (?severity=) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/api/mobile/incident-response/?status=aktiv
{
"investigations": [
{
"id": "1d3f5a79-2b4c-4e86-9a01-7c9e1b3d5f40",
"title": "Kompromittiertes Notebook",
"description": "",
"status": "aktiv",
"status_display": "Aktiv",
"severity": "hoch",
"severity_display": "Hoch",
"lead": "Max Muster",
"created_at": "2026-05-15T14:00:00+00:00"
}
],
"stats": { "active": 1, "critical": 0, "indicators": 24, "draft_rules": 2 }
}
Audit log
1 EndpointGET /company/tickets/api/audit-log/ Company audit log (last 100 events, company admins only) ▶
curl -H "Authorization: Bearer ctk_7f3a9c1e2b4d6f80_Qm9yZ2Vu…" \ https://portal.cybertell.io/company/tickets/api/audit-log/
{
"events": [
{
"id": 9001,
"action": "login",
"success": true,
"actor_email": "[email protected]",
"target_label": "B2B-Portal",
"ip_address": "203.0.113.10",
"ip_country": "CH",
"ip_city": "Bern",
"user_agent": "Safari 18 · macOS",
"failure_reason": "",
"created_at": "2026-05-16T07:02:00+00:00",
"lat": 46.95,
"lng": 7.45,
"location_precision": "city"
}
]
}
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 EndpointsGET /individual/api/dashboard/ Dashboard overview (courses_* counts exam attempts) ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/dashboard/
{
"dashboard": {
"leak_checks": 3,
"total_breaches": 5,
"verified_emails": 2,
"incidents": 1,
"canary_tokens": 2,
"canary_hits": 0,
"simulations": 4,
"courses_total": 5,
"courses_passed": 2
}
}
GET /individual/api/profile/ Profile data ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/profile/
{
"profile": {
"id": "3d4e5f6a-9b1c-4d46-8e72-8c0d2f4a6e79",
"firstname": "Max",
"lastname": "Muster",
"email": "[email protected]",
"phone": "+41790000000",
"plan": "family",
"subscription_status": "active",
"language": "de",
"created_at": "2026-01-12T09:00:00+00:00",
"family": { "is_owner": true, "member_count": 2, "members": [ { "id": "9e1c3a57-2b4d-4f86-8a09-3c5e7a9b1d40", "name": "Erika Muster", "email": "[email protected]" } ] }
}
}
Email leak checks
2 EndpointsGET /individual/api/leak-checks/ Leak check list ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/leak-checks/
{
"leak_checks": [
{
"id": "d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92",
"email": "[email protected]",
"breach_count": 3,
"risk_level": "high",
"checked_at": "2026-05-15T20:00:00+00:00"
}
],
"verified_emails": [
{ "id": "8b0d2f46-1a3c-4e75-9b18-5d7f9a1c3e60", "email": "[email protected]", "verified_at": "2026-01-12T09:05:00+00:00" }
]
}
GET /individual/api/leak-checks/<uuid>/ Detail with breaches ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/leak-checks/d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92/
{
"leak_check": {
"id": "d4f6a8c0-2b4e-4c70-9a13-6e8d1f3a5b92",
"email": "[email protected]",
"breach_count": 3,
"risk_level": "high",
"checked_at": "2026-05-15T20:00:00+00:00",
"breaches": [
{ "name": "ExampleBreach2024", "date": "2024-11-02", "domain": "example.com", "pwn_count": 1420000, "data_classes": ["E-Mail-Adressen", "Passwörter"], "description": "…", "logo_path": "" }
]
}
}
Courses
1 EndpointGET /individual/api/courses/ The person's courses with progress (same selection as /individual/courses/api/certifications/) ▶
curl -H "Authorization: Bearer ctk_9e1b3d5f7a9c0e2b_SGVpbWF1…" \ https://app.cybertell.io/individual/api/courses/
{
"courses": [
{
"id": "4e5f6a7b-0c2d-4e57-9f83-9d1e3f5a7b80",
"title": "Phishing erkennen",
"topic_count": 4,
"content_count": 12,
"completed_count": 7,
"progress_pct": 58,
"exam": { "id": "2c4e6a80-1b3d-4f57-9a29-6d8f0b2d4e61", "passed": true, "score": "14/16", "finished_at": "2026-05-16T09:00:00+00:00" }
}
]
}
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 EndpointGET /reseller/api/dashboard/ Overview ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/dashboard/
{
"dashboard": {
"type": "reseller",
"company_count": 12,
"active_companies": 10,
"total_employees": 240,
"open_tickets": 5,
"sponsored_persons": 0
}
}
Companies
6 EndpointsGET /reseller/api/companies/ List managed companies ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/
{
"companies": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"email": "[email protected]",
"industry": "finance",
"plan": "tier_10",
"subscription_status": "active",
"employee_count": 24,
"open_tickets": 1,
"created_at": "2026-01-12T09:00:00+00:00"
}
]
}
GET /reseller/api/companies/<uuid>/ Company detail ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"email": "[email protected]",
"industry": "finance",
"company_size": "11-50",
"plan": "tier_10",
"subscription_status": "active",
"country": "Schweiz",
"employees": [
{ "id": "c4e1a9b2-3f8d-4a21-9c7e-5b2d1f0a8e64", "name": "Max Muster", "email": "[email protected]", "is_admin": true }
]
}
}
GET /reseller/api/companies/security/ Security posture of all customers ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/
{
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"own_company": false,
"migrated": false,
"assets": 42,
"assets_critical": 3,
"systems": 12,
"cves": 9,
"findings": {
"critical": 2,
"high": 4,
"medium": 5,
"low": 1
},
"kev": 1,
"support_expired": 1,
"support_ending": 2,
"surface_findings": 4,
"surface_severe": 1,
"last_run_at": "2026-11-15T02:30:00+00:00"
}
],
"totals": {
"companies": 8,
"with_radar": 5,
"attention": 2,
"assets": 214,
"systems": 61,
"cves": 37,
"kev": 2,
"kev_companies": 2,
"critical_companies": 3,
"support_expired": 2,
"support_ending": 5
},
"shared_cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"kev": true,
"cvss": 9.8,
"companies": 3,
"systems": 4,
"customer_names": [
"Murmelibach AG",
"Seeblick GmbH"
]
}
]
}
GET /reseller/api/companies/security/cves/ Open CVEs of all customers ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/cves/?kev=1
{
"cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"cvss": 9.8,
"kev": true,
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG"
}
],
"systems": 2,
"findings": 2,
"products": [
"Fortinet FortiOS"
],
"fixed_in": [
"7.4.9"
],
"first_seen_at": "2026-11-02T02:31:00+00:00"
}
],
"truncated": false,
"kev_total": 1
}
GET /reseller/api/companies/security/assets/ Active assets of all customers ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/security/assets/?criticality=critical
{
"assets": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Firewall Hauptsitz",
"asset_type": "network",
"asset_type_display": "Netzwerk",
"criticality": "critical",
"criticality_display": "Kritisch",
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"open_cves": 2
}
]
}
GET /reseller/api/companies/<uuid>/security/ Security posture of one customer ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/companies/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/security/
{
"security": {
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"migrated": false,
"radar": {
"systems": 12,
"cves": 9,
"open_findings": 12,
"findings_by_severity": {
"critical": 2,
"high": 4,
"medium": 5,
"low": 1
},
"kev": 1,
"support_expired": 1,
"packages": 0,
"last_run_at": "2026-11-15T02:30:00+00:00",
"cve_total": 9,
"affected_systems": 5,
"system_total": 12,
"open_cves": [
{
"cve_id": "CVE-2026-24858",
"title": "FortiOS: Umgehung der Authentifizierung",
"severity": "critical",
"kev": true,
"cvss": 9.8,
"findings": 2,
"products": [
"Fortinet FortiOS"
],
"fixed_in": [
"7.4.9"
]
}
],
"system_list": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"name": "Firewall Hauptsitz",
"kind": "firewall",
"kind_display": "Firewall",
"product": "Fortinet FortiOS",
"version": "7.4.3",
"open_findings": 2,
"support_end": "2027-09-30",
"support_stage": ""
}
]
},
"assets": {
"total": 42,
"critical": 3,
"items": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"name": "Firewall Hauptsitz",
"asset_type": "network",
"asset_type_display": "Netzwerk",
"criticality": "critical",
"criticality_display": "Kritisch",
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"open_cves": 2
}
]
},
"attack_surface": null
}
}
Billing
6 EndpointsConsolidated 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 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/
{
"billing": {
"model": "it_partner",
"currency": "CHF",
"discount_percent": 30.0,
"invoices": {
"count": 12,
"open_count": 1,
"overdue_count": 0,
"gross_total_chf": 29760.0,
"discount_total_chf": 8928.0,
"net_total_chf": 20832.0,
"open_net_chf": 1736.0,
"overdue_net_chf": 0.0,
"latest_id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24"
},
"current_period": {
"period_start": "2026-11-01",
"period_end": "2026-11-30",
"priced": true,
"customer_count": 8,
"line_count": 9,
"gross_chf": 2565.0,
"discount_chf": 769.5,
"net_chf": 1795.5
},
"sponsor": null
}
}
GET /reseller/api/billing/customers/ Customers with employees, plan, subscription and current period costs ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/customers/?include_own=0
{
"customers": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 24,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"active_employee_count": 22,
"subscription_plan": "tier_50",
"billing_cycle": "yearly",
"subscription_status": "active"
}
],
"totals": { "priced": true, "gross_chf": 2565.0, "discount_chf": 769.5, "net_chf": 1795.5 }
}
GET /reseller/api/billing/customers/<uuid>/ Customer with current state, subscription and invoice history ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/customers/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"customer": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG",
"own_company": false,
"billed": true,
"current": {
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 24,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main"
},
"active_employee_count": 22,
"subscription_plan": "tier_50",
"billing_cycle": "yearly",
"subscription_status": "active",
"history": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 22,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"invoice_id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"invoice_status": "sent"
}
]
}
}
GET /reseller/api/billing/invoices/ Invoices with customers and employee total, filterable by status; ?include=lines adds the line items ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/invoices/?status=open
{
"invoices": [
{
"id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"gross_chf": 2480.0,
"discount_chf": 744.0,
"net_chf": 1736.0,
"currency": "CHF",
"status": "sent",
"status_display": "Gesendet",
"line_count": 9,
"customer_count": 8,
"employee_total": 186,
"companies": [
{ "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "company_name": "Murmelibach AG", "own_company": false }
],
"has_pdf": true,
"issued_at": "2026-11-01T05:00:00+00:00",
"due_at": "2026-12-01T05:00:00+00:00",
"paid_at": null
}
]
}
GET /reseller/api/billing/invoices/<uuid>/ Invoice with all line items per customer ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/
{
"invoice": {
"id": "3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24",
"invoice_number": "CT-202610-0042",
"period_start": "2026-10-01",
"period_end": "2026-10-31",
"gross_chf": 2480.0,
"discount_chf": 744.0,
"net_chf": 1736.0,
"currency": "CHF",
"status": "sent",
"status_display": "Gesendet",
"line_count": 9,
"customer_count": 8,
"employee_total": 186,
"companies": [
{ "company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "company_name": "Murmelibach AG", "own_company": false }
],
"has_pdf": true,
"issued_at": "2026-11-01T05:00:00+00:00",
"due_at": "2026-12-01T05:00:00+00:00",
"paid_at": null,
"lines": [
{
"company_id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"company_name": "Murmelibach AG",
"domain": "murmelibach-ag.ch",
"employee_count": 22,
"plan": "tier_50",
"plan_label": "Bis 50 Mitarbeiter (CHF 85/Monat)",
"quantity": 1,
"unit": "month",
"unit_price_chf": 85.0,
"gross_chf": 85.0,
"discount_percent": 30.0,
"discount_chf": 25.5,
"net_chf": 59.5,
"discounted": true,
"own_company": false,
"hosting": "main",
"period_start": "2026-10-01",
"period_end": "2026-10-31"
}
]
}
}
GET /reseller/api/billing/invoices/<uuid>/pdf/ Invoice as PDF ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o rechnung.pdf https://portal.cybertell.io/reseller/api/billing/invoices/3a5c7e91-2e4f-4b68-8d03-9c1e3a5b7d24/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="CT-202610-0042.pdf" %PDF-1.7 …
developers.api.group.r-eng.title
24 Endpointsdevelopers.api.group.r-eng.desc
GET /reseller/api/engagements/ developers.api.ep.r-eng.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/
{
"items": [
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/ developers.api.ep.r-eng.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest ERP 2026", "company": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "pentest_type": "internal", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-2026-17"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.2 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
PATCH /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.3 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"testing_hours": "Mo-Fr 08-18 Uhr"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
DELETE /reseller/api/engagements/<uuid>/ developers.api.ep.r-eng.4 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
{
"ok": true,
"result": "deleted"
}
POST /reseller/api/engagements/<uuid>/complete-definition/ developers.api.ep.r-eng.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/complete-definition/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/
{
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
PUT /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.7 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest ERP 2026 v2", "company": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60", "pentest_type": "internal", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-2026-17"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
PATCH/DELETE /reseller/api/engagements/by-ref/<ref>/ developers.api.ep.r-eng.8 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"testing_hours": "Mo-Fr 08-18 Uhr"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "definition",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/assets/ developers.api.ep.r-eng.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/
{
"items": [
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/assets/ developers.api.ep.r-eng.11 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"kind": "ip_range", "label": "Server-LAN", "value": "10.0.0.0/24", "scope_keys": ["internal_pentest"]}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
GET /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
PATCH /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.13 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"label": "Server-LAN Süd"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
DELETE /reseller/api/engagements/<uuid>/assets/<asset_uuid>/ developers.api.ep.r-eng.14 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
{
"ok": true,
"result": "deleted",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
PUT /reseller/api/engagements/<uuid>/assets/by-ref/<ref>/ developers.api.ep.r-eng.15 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"kind": "ip_range", "label": "Server-LAN", "value": "10.0.0.0/24", "scope_keys": ["internal_pentest"]}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/assets/by-ref/<ref>/ developers.api.ep.r-eng.16 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/assets/by-ref/erp-2026-17/
{
"id": "70a3c1e9-2b4d-4c86-9f15-3e7a1c5b9d02",
"external_ref": "fw-hq",
"kind": "ip_range",
"label": "Server-LAN",
"value": "10.0.0.0/24",
"in_scope": true,
"scope_keys": [
"internal_pentest"
],
"notes": "",
"sort_order": 0
}
POST /reseller/api/engagements/<uuid>/rules/apply-template/ developers.api.ep.r-eng.17 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/apply-template/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
PATCH /reseller/api/engagements/<uuid>/rules/categories/<cat_uuid>/ developers.api.ep.r-eng.18 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"relevant": true}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
PUT /reseller/api/engagements/<uuid>/rules/items/<item_uuid>/ developers.api.ep.r-eng.19 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/items/6e8a0c23-4b1d-4f97-9c05-3a7e1d5f9b82/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"answer": "yes"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
POST /reseller/api/engagements/<uuid>/rules/compile/ developers.api.ep.r-eng.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/rules/compile/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"name": "Social Engineering",
"relevant": true,
"items": []
}
],
"compiled_at": null,
"has_rules": false
}
}
POST /reseller/api/engagements/<uuid>/provision/ developers.api.ep.r-eng.21 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/provision/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "provisioned",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "delivery",
"signature_state": "signed",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
POST /reseller/api/engagements/<uuid>/cancel/ developers.api.ep.r-eng.22 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/cancel/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"reason": "Auftrag zurückgezogen"}'
{
"ok": true,
"result": "cancelled",
"notices": [],
"data": {
"id": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"external_ref": "erp-2026-17",
"title": "Pentest ERP 2026",
"company": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"name": "Murmelibach AG"
},
"phase": "cancelled",
"signature_state": "unsigned",
"updated_at": "2026-11-16T09:12:00+00:00",
"pentest_type": "internal",
"engagement_scope": [
"internal_pentest"
],
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"testing_hours": "Mo-Fr 08-18 Uhr",
"scope_targets": "10.0.0.0/24",
"scope_excluded": "",
"definition_step": "scope",
"pentests": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"short_code": "PT-206",
"status": "scheduled"
}
],
"audits": [],
"reports": [],
"locked": false,
"cancelled_at": null,
"documents": {
"pdf": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/",
"docx": "/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/"
}
}
}
GET /reseller/api/engagements/<uuid>/document/pdf/ developers.api.ep.r-eng.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o roe.pdf https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="roe.pdf" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/<uuid>/document/docx/ developers.api.ep.r-eng.24 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o roe.docx https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/document/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="roe.docx" X-Content-Type-Options: nosniff
developers.api.group.r-eng-runs.title
16 Endpointsdevelopers.api.group.r-eng-runs.desc
GET /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/
{
"items": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/pentests/ developers.api.ep.r-eng-runs.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "ERP-Server", "pentest_type": "internal", "pentester": "Max Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-pt-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
PUT /reseller/api/engagements/<uuid>/pentests/by-ref/<ref>/ developers.api.ep.r-eng-runs.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "ERP-Server", "pentest_type": "internal", "pentester": "Max Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-pt-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/pentests/by-ref/<ref>/ developers.api.ep.r-eng-runs.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/pentests/by-ref/erp-2026-17/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
GET /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
PATCH /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.5 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"end_date": "2026-12-20"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "scheduled",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
DELETE /reseller/api/engagements/pentests/<run_uuid>/ developers.api.ep.r-eng-runs.6 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
POST /reseller/api/engagements/pentests/<run_uuid>/status/ developers.api.ep.r-eng-runs.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "active"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-pt-1",
"short_code": "PT-206",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"target": "ERP-Server",
"pentest_type": "internal",
"scope_key": "internal_pentest",
"pentester": "Max Muster",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "active",
"allowed_transitions": [
"active",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET /reseller/api/engagements/<uuid>/audits/ developers.api.ep.r-eng-runs.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/
{
"items": [
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/<uuid>/audits/ developers.api.ep.r-eng-runs.9 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "IKT-Audit ERP", "scope": "ERP und Anbindungen", "language": "de", "lead": "Erika Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-au-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
PUT /reseller/api/engagements/<uuid>/audits/by-ref/<ref>/ developers.api.ep.r-eng-runs.10 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "IKT-Audit ERP", "scope": "ERP und Anbindungen", "language": "de", "lead": "Erika Muster", "start_date": "2026-12-01", "end_date": "2026-12-15", "external_ref": "erp-au-1"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
GET/PATCH/DELETE /reseller/api/engagements/<uuid>/audits/by-ref/<ref>/ developers.api.ep.r-eng-runs.11 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/audits/by-ref/erp-2026-17/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
GET /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/
{
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
PATCH /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.13 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"end_date": "2026-12-20"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "draft",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
DELETE /reseller/api/engagements/audits/<run_uuid>/ developers.api.ep.r-eng-runs.14 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
POST /reseller/api/engagements/audits/<run_uuid>/status/ developers.api.ep.r-eng-runs.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "preparing"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71",
"external_ref": "erp-au-1",
"short_code": "AU-31",
"engagement": "5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60",
"name": "IKT-Audit ERP",
"scope": "ERP und Anbindungen",
"scope_key": "ikt_audit",
"language": "de",
"lead": "Erika Muster",
"extra_scope_notes": "",
"start_date": "2026-12-01",
"end_date": "2026-12-15",
"status": "preparing",
"allowed_transitions": [
"preparing",
"cancelled"
],
"started_at": null,
"finished_at": null,
"findings_critical": 0,
"findings_high": 1,
"findings_medium": 2,
"findings_low": 0,
"content_locked": false
}
}
developers.api.group.r-eng-plan.title
26 Endpointsdevelopers.api.group.r-eng-plan.desc
POST /reseller/api/engagements/pentests/<run_uuid>/apply-methodology/ developers.api.ep.r-eng-plan.0 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/apply-methodology/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
]
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/categories/ developers.api.ep.r-eng-plan.1 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
{
"items": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/categories/ developers.api.ep.r-eng-plan.2 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Authentisierung", "external_ref": "athn"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.3 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Authentisierung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/ developers.api.ep.r-eng-plan.5 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
]
}
GET /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/
{
"items": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwörter prüfen", "severity_default": "high", "external_ref": "wstg-athn-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.8 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwörter prüfen"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/ developers.api.ep.r-eng-plan.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
PUT /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/result/ developers.api.ep.r-eng-plan.11 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/result/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "vulnerable", "note": "Anmeldung mit admin/admin möglich"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": []
}
}
POST /reseller/api/engagements/pentests/<run_uuid>/topics/<topic_uuid>/raise-finding/ developers.api.ep.r-eng-plan.12 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/raise-finding/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": null,
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open"
}
}
POST /reseller/api/engagements/audits/<run_uuid>/apply-template/ developers.api.ep.r-eng-plan.13 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/apply-template/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "mode": "append"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"categories": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
]
}
}
GET /reseller/api/engagements/audits/<run_uuid>/categories/ developers.api.ep.r-eng-plan.14 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/
{
"items": [
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/categories/ developers.api.ep.r-eng-plan.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Zugriffssteuerung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.16 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"name": "Zugriffssteuerung"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/by-ref/<ref>/ developers.api.ep.r-eng-plan.17 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/by-ref/erp-2026-17/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/ developers.api.ep.r-eng-plan.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/
{
"id": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"external_ref": "athn",
"name": "Authentisierung",
"description": "",
"sort_order": 0,
"topics": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
]
}
GET /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.19 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/
{
"items": [
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/ developers.api.ep.r-eng-plan.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Rollenkonzept vorhanden"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.21 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Rollenkonzept vorhanden"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/categories/<cat_uuid>/topics/by-ref/<ref>/ developers.api.ep.r-eng-plan.22 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/categories/3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24/topics/by-ref/erp-2026-17/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/topics/<topic_uuid>/ developers.api.ep.r-eng-plan.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/
{
"id": "9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35",
"external_ref": "wstg-athn-01",
"category": "3b5d7f91-2c4e-4a68-8b0d-1f3a5c7e9b24",
"title": "Standardkennwörter prüfen",
"description": "",
"tools": "hydra",
"commands": "",
"reference_id": "WSTG-ATHN-02",
"severity_default": "high",
"sort_order": 0,
"status": "open",
"notes": "",
"finding": null,
"results": [],
"purpose": "",
"reference_kind": "",
"customer_response": "",
"customer_note": ""
}
POST /reseller/api/engagements/audits/<run_uuid>/topics/<topic_uuid>/raise-finding/ developers.api.ep.r-eng-plan.24 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/topics/9d0e1f2a-5b7c-4d02-8e38-4c6d8e0f2a35/raise-finding/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": null,
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/questionnaire/pdf/ developers.api.ep.r-eng-plan.25 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o fragebogen.pdf https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/questionnaire/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="fragebogen.pdf" X-Content-Type-Options: nosniff
developers.api.group.r-eng-findings.title
24 Endpointsdevelopers.api.group.r-eng-findings.desc
GET /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
{
"items": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/ developers.api.ep.r-eng-findings.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwort aktiv", "severity": "high", "affected": "erp.murmelibach.example", "external_ref": "f-erp-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Standardkennwort aktiv", "severity": "high", "affected": "erp.murmelibach.example", "external_ref": "f-erp-01"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/ developers.api.ep.r-eng-findings.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "open",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/status/ developers.api.ep.r-eng-findings.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "fixed"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-erp-01",
"identifier": "F-01",
"title": "Standardkennwort aktiv",
"severity": "high",
"status": "fixed",
"vuln_type": "Authentisierung",
"category": "",
"description": "Der Administrator-Zugang akzeptiert das Standardkennwort.",
"observation": "",
"remediation": "Kennwort ändern",
"remediation_complexity": "low",
"priority": "",
"references": "",
"poc": "",
"tools": "",
"commands": "",
"affected": "erp.murmelibach.example",
"cve": "",
"cwe": "CWE-1392",
"wstg_id": "",
"cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N",
"custom_fields": {},
"cvss_score": 9.1,
"cvss_severity": "critical"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/ developers.api.ep.r-eng-findings.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/
{
"items": [
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/ developers.api.ep.r-eng-findings.7 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Kein Rollenkonzept"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.8 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Kein Rollenkonzept"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/by-ref/<ref>/ developers.api.ep.r-eng-findings.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/by-ref/erp-2026-17/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/ developers.api.ep.r-eng-findings.10 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/
{
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "open",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/status/ developers.api.ep.r-eng-findings.11 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/status/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"status": "accepted"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61",
"external_ref": "f-ikt-01",
"title": "Kein Rollenkonzept",
"severity": "medium",
"status": "accepted",
"description": "",
"affected": "",
"cve": "",
"recommendation": "Rollenkonzept erstellen",
"cvss_vector": "",
"cvss_score": null,
"cvss_severity": ""
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.12 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.13 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske" \ -F "external_ref=login-png"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
POST /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.14 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.15 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/ developers.api.ep.r-eng-findings.16 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET /reseller/api/engagements/pentests/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/file/ developers.api.ep.r-eng-findings.17 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o login.png https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/
HTTP/1.1 200 OK Content-Type: image/png Content-Disposition: attachment; filename="login.png" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/ developers.api.ep.r-eng-findings.19 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske" \ -F "external_ref=login-png"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
POST /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.20 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -F "[email protected]" \ -F "caption=Anmeldemaske"
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/by-ref/<ref>/ developers.api.ep.r-eng-findings.21 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/by-ref/erp-2026-17/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/ developers.api.ep.r-eng-findings.22 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"external_ref": "login-png",
"filename": "login.png",
"caption": "Anmeldemaske",
"sort_order": 0,
"is_image": true,
"file": "/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/",
"created_at": "2026-11-16T09:30:00+00:00"
}
GET /reseller/api/engagements/audits/<run_uuid>/findings/<finding_uuid>/evidence/<ev_uuid>/file/ developers.api.ep.r-eng-findings.23 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o login.png https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/findings/4d6f8a0c-1e3b-4c57-9a24-6b8d0f2c4e61/evidence/8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71/file/
HTTP/1.1 200 OK Content-Type: image/png Content-Disposition: attachment; filename="login.png" X-Content-Type-Options: nosniff
developers.api.group.r-eng-reports.title
26 Endpointsdevelopers.api.group.r-eng-reports.desc
GET /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
{
"items": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/pentests/<run_uuid>/reports/ developers.api.ep.r-eng-reports.1 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
PUT /reseller/api/engagements/pentests/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.2 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/pentests/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/pentests/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
GET /reseller/api/engagements/audits/<run_uuid>/reports/ developers.api.ep.r-eng-reports.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/
{
"items": [
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/audits/<run_uuid>/reports/ developers.api.ep.r-eng-reports.5 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
PUT /reseller/api/engagements/audits/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.6 ▶
curl -X PUT https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Pentest-Report ERP 2026", "language": "de", "template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71", "external_ref": "erp-report"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/audits/<run_uuid>/reports/by-ref/<ref>/ developers.api.ep.r-eng-reports.7 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/audits/2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71/reports/by-ref/erp-2026-17/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
GET /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/
{
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
PATCH /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.9 ▶
curl -X PATCH https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"title": "Report ERP, Fassung 2"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
DELETE /reseller/api/engagements/reports/<report_uuid>/ developers.api.ep.r-eng-reports.10 ▶
curl -X DELETE https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/ \ -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…"
GET /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.11 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/
{
"items": [
{
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
POST /reseller/api/engagements/reports/<report_uuid>/sections/ developers.api.ep.r-eng-reports.12 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"heading": "Management Summary", "body": "<p>Text</p>"}'
{
"ok": true,
"result": "created",
"notices": [],
"data": {
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
}
GET/PATCH/DELETE /reseller/api/engagements/reports/<report_uuid>/sections/<section_uuid>/ developers.api.ep.r-eng-reports.13 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82/
{
"id": "1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82",
"kind": "custom",
"heading": "Management Summary",
"body": "<p>Text</p>",
"sort_order": 0,
"created_at": "2026-11-16T10:05:00+00:00"
}
POST /reseller/api/engagements/reports/<report_uuid>/finalize/ developers.api.ep.r-eng-reports.14 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/finalize/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "final",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/unfinalize/ developers.api.ep.r-eng-reports.15 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/unfinalize/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "draft",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": null,
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/deliver/ developers.api.ep.r-eng-reports.16 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/deliver/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"delivered_to": "[email protected]", "delivered_at": "2026-11-18", "note": "Per verschlüsselter Mail"}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "delivered",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "[email protected]",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
POST /reseller/api/engagements/reports/<report_uuid>/undeliver/ developers.api.ep.r-eng-reports.17 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/undeliver/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "updated",
"notices": [],
"data": {
"id": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"external_ref": "erp-report",
"title": "Pentest-Report ERP 2026",
"language": "de",
"template": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"status": "final",
"run": {
"kind": "pentest",
"id": "2d4f6a80-1c3e-4b57-9a29-7b9d1f3a5c71"
},
"generated_at": null,
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"delivered_note": "",
"docx": null,
"pdf": null,
"created_at": "2026-11-16T10:00:00+00:00"
}
}
GET /reseller/api/engagements/reports/<report_uuid>/files/docx/ developers.api.ep.r-eng-reports.18 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report.docx https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="report.docx" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/reports/<report_uuid>/files/pdf/ developers.api.ep.r-eng-reports.19 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report.pdf https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/pdf/
HTTP/1.1 200 OK Content-Type: application/pdf Content-Disposition: attachment; filename="report.pdf" X-Content-Type-Options: nosniff
GET /reseller/api/engagements/reports/<report_uuid>/versions/ developers.api.ep.r-eng-reports.20 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/
{
"items": [
{
"id": "7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13",
"sha256": "9f2c…e41a",
"status_at_time": "final",
"finalized_at": "2026-11-17T08:00:00+00:00",
"delivered_at": null,
"delivered_to": "",
"created_by": "Integration ERP",
"created_at": "2026-11-17T08:00:00+00:00",
"docx": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13/docx/"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/reports/<report_uuid>/versions/<version_uuid>/docx/ developers.api.ep.r-eng-reports.21 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ -o report-v1.docx https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/versions/7c9e1b35-4d6f-4a80-9b2c-2e4a6c8e0b13/docx/
HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document Content-Disposition: attachment; filename="report-v1.docx" X-Content-Type-Options: nosniff
POST /reseller/api/engagements/<uuid>/ai-draft/ developers.api.ep.r-eng-reports.22 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/ai-draft/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
POST /reseller/api/engagements/reports/<report_uuid>/sections/<section_uuid>/ai-text/ developers.api.ep.r-eng-reports.23 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/sections/1a3c5e70-2b4d-4f86-9a17-5c7e9b1d3f82/ai-text/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{"target": "body", "instruction": "Kürzer und für die Geschäftsleitung formulieren"}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
POST /reseller/api/engagements/reports/<report_uuid>/generate/ developers.api.ep.r-eng-reports.24 ▶
curl -X POST https://portal.cybertell.io/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/generate/ \
-H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \
-H "Content-Type: application/json" \
-d '{}'
{
"ok": true,
"result": "accepted",
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "queued",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": null,
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
GET /reseller/api/engagements/jobs/<job_uuid>/ developers.api.ep.r-eng-reports.25 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/jobs/0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53/
{
"ok": true,
"data": {
"id": "0f2a4c68-3e5b-4d79-8a91-6b8d0f2c4e53",
"kind": "report_generate",
"status": "done",
"target": "c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60",
"result": {
"docx": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/docx/",
"pdf": "/reseller/api/engagements/reports/c1e3a5b7-9d2f-4a64-8b08-3e7d1f5a9c60/files/pdf/"
},
"error": null,
"created_at": "2026-11-17T08:10:00+00:00",
"finished_at": null
}
}
developers.api.group.r-eng-library.title
10 Endpointsdevelopers.api.group.r-eng-library.desc
GET /reseller/api/engagements/library/roe-templates/ developers.api.ep.r-eng-library.0 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Interner Pentest",
"description": "",
"pentest_type": "internal",
"translations": {}
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/roe-templates/<uuid>/ developers.api.ep.r-eng-library.1 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/roe-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Interner Pentest",
"description": "",
"pentest_type": "internal",
"translations": {}
}
GET /reseller/api/engagements/library/methodologies/ developers.api.ep.r-eng-library.2 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/methodologies/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/methodologies/<uuid>/ developers.api.ep.r-eng-library.3 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/methodologies/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
GET /reseller/api/engagements/library/audit-templates/ developers.api.ep.r-eng-library.4 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/audit-templates/<uuid>/ developers.api.ep.r-eng-library.5 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/audit-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "IKT-Minimalstandard",
"description": ""
}
GET /reseller/api/engagements/library/report-templates/ developers.api.ep.r-eng-library.6 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/report-templates/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Pentest-Report Standard",
"description": ""
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/report-templates/<uuid>/ developers.api.ep.r-eng-library.7 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/report-templates/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"name": "Pentest-Report Standard",
"description": ""
}
GET /reseller/api/engagements/library/vulnerabilities/ developers.api.ep.r-eng-library.8 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/
{
"items": [
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"title": "Standardkennwörter",
"severity": "high",
"cwe": "CWE-1392",
"cvss_score": "9.1"
}
],
"page": 1,
"page_size": 50,
"total": 1,
"has_next": false
}
GET /reseller/api/engagements/library/vulnerabilities/<uuid>/ developers.api.ep.r-eng-library.9 ▶
curl -H "Authorization: Bearer ctk_2c4e6a8b0d1f3a5c_UGFydG5l…" \ https://portal.cybertell.io/reseller/api/engagements/library/vulnerabilities/5e7a9c13-4b6d-4f80-9a25-1c3e5a7d9b60/
{
"id": "8b0d2f46-7c9e-4a13-8b58-4d6f8a0c2e71",
"is_system": true,
"updated_at": "2026-10-01T08:00:00+00:00",
"title": "Standardkennwörter",
"severity": "high",
"cwe": "CWE-1392",
"cvss_score": "9.1"
}
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.
Rate limits & notes.
- 100 requests / min per token. If exceeded, a
429with aRetry-Afterheader 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_sizeparameters in the OpenAPI specification support?page=and?page_size=(default 50, max. 200). With pagination the response additionally containspage,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.
Technical questions about the API. Reply usually within one working day.
Sales, demos, partner enquiries. Reply usually within one working day.