Für Entwickler

Gefährdungsbeurteilung psychischer Belastung, per API.

Die Safe Mind Public API stellt die wichtigsten Abläufe als schlanke REST-Endpunkte bereit: Unternehmen einrichten, Tätigkeitsbereiche und Standorte anlegen, Befragungen erstellen und aggregierte Ergebnisse abrufen. Dazu gibt es ein CLI und einen MCP-Server für KI-Assistenten. Gedacht für Fachkräfte für Arbeitssicherheit mit mehreren Betreuungsfirmen, HR-Integrationen und Automatisierung.

REST-API

Authentifizierung per API-Key (Authorization: Bearer sm_live_…), gescoped auf Ihr Unternehmen. Beispiel: Befragungs-Entwurf mit Bereichen in einem Aufruf anlegen.

curl -X POST https://api.safe-mind.de/v1/surveys \
  -H "Authorization: Bearer sm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2026-10-01",
    "durationWeeks": 4,
    "employeeCount": 220,
    "departments": ["Produktion (Halle 1, 2)", "Verwaltung", "Vertrieb"]
  }'

Methode	Endpunkt	Beschreibung
POST	/v1/auth/register	Account und Unternehmen anlegen (E-Mail-Bestätigung folgt)
POST	/v1/auth/verify-email	E-Mail-Adresse mit Code bestätigen
POST	/v1/auth/api-keys	API-Key ausstellen (verifizierter Account)
GET	/v1/me	Account und Unternehmen
GET/POST	/v1/departments	Tätigkeitsbereiche auflisten und anlegen
GET/POST	/v1/locations	Standorte auflisten und anlegen
POST	/v1/surveys	Befragungs-Entwurf anlegen, Bereiche werden bei Bedarf automatisch erstellt
GET	/v1/surveys	Befragungen mit Status und Zeitraum
GET	/v1/surveys/:id	Einzelne Befragung inkl. Teilnahme-Link
GET	/v1/surveys/:id/analytics	Aggregierte Ergebnisse, optional gruppiert nach Bereich, Standort, Altersgruppe oder Geschlecht

CLI

Das npm-Paket safe-mind bringt alle Endpunkte ins Terminal, ohne weitere Abhängigkeiten.

npm install -g safe-mind

safe-mind login --email sie@firma.de --password '...'
safe-mind surveys create --start 2026-10-01 --weeks 4 --employees 220 \
  --department "Produktion (Halle 1, 2)" --department "Verwaltung"
safe-mind analytics <surveyId> --group-by department

MCP-Server für KI-Assistenten

Über den MCP-Server safe-mind-mcp können MCP-fähige Assistenten wie Claude, ChatGPT oder Gemini Befragungen anlegen und Ergebnisse abrufen - zum Beispiel eine Bereichsliste aus einer E-Mail direkt in einen fertigen Befragungs-Entwurf verwandeln.

{
  "mcpServers": {
    "safe-mind": {
      "command": "npx",
      "args": ["-y", "safe-mind-mcp"],
      "env": { "SAFE_MIND_API_KEY": "sm_live_..." }
    }
  }
}

Anonymität gilt auch per API

Auswertungs-Endpunkte liefern ausschließlich aggregierte Ergebnisse. Gruppen unterhalb der Mindestgruppengröße werden serverseitig herausgefiltert - dieselben Regeln wie in der Safe Mind App, unabhängig davon, wer den Endpunkt aufruft. Antwort-Rohdaten sind über die API nicht zugänglich. Details im Anonymitätskonzept.

Häufige Fragen zur GB-Psych-API

Gibt es eine API für die psychische Gefährdungsbeurteilung?

Ja. Die Safe Mind Public API stellt die Abläufe der Gefährdungsbeurteilung psychischer Belastung (GB Psych) als REST-Endpunkte bereit: Unternehmen einrichten, Tätigkeitsbereiche und Standorte anlegen, Befragungen erstellen und aggregierte, anonymitätsgeschützte Ergebnisse abrufen. Authentifiziert wird per API-Key, gescoped auf das eigene Unternehmen.

Was ist ein MCP-Server für die Gefährdungsbeurteilung?

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Assistenten wie Claude, ChatGPT oder Gemini externe Werkzeuge aufrufen. Der Safe Mind MCP-Server (npm-Paket safe-mind-mcp) stellt die Schritte der PsychGB als solche Werkzeuge bereit - ein Assistent kann damit z.B. eine Bereichsliste aus einer E-Mail direkt in einen fertigen Befragungs-Entwurf verwandeln.

Bleiben die Ergebnisse über die API anonym?

Ja. Auswertungs-Endpunkte liefern ausschließlich aggregierte Ergebnisse, Gruppen unterhalb der Mindestgruppengröße werden serverseitig herausgefiltert und Antwort-Rohdaten sind über die API nicht zugänglich - dieselben Regeln wie in der Safe Mind App.

Für wen ist die GB-Psych-API gedacht?

Für Fachkräfte für Arbeitssicherheit (SiFa), die mehrere Betreuungsfirmen anlegen und Befragungen vorbereiten, für HR-Integrationen und für Automatisierung per CLI oder KI-Assistent. Ein API-Key lässt sich für jeden verifizierten Safe-Mind-Account in den Einstellungen oder per CLI ausstellen.

Zugang

Ein API-Key lässt sich für jeden verifizierten Safe-Mind-Account ausstellen (safe-mind login oder POST /v1/auth/api-keys). Fragen zur Integration: Kontakt.