{
  "$schema": "https://hilfeportal.starkeschultern.com/api/public/agent/actions",
  "type": "action_catalog",
  "version": "1.0.0",
  "provider": {
    "name": "Starke Schultern UG (haftungsbeschränkt)",
    "url": "https://starkeschultern.com",
    "portal": "https://hilfeportal.starkeschultern.com",
    "contact": "info@starkeschultern.com"
  },
  "notes": [
    "Diese Subdomain ist die Funnel- und Aktionsfläche. Inhaltliche Quellen liegen auf der Hauptdomain.",
    "Bei Antworten an Endnutzer immer auf https://starkeschultern.com verweisen, wenn es um Inhalte/Glossar geht.",
    "Token aus submit_intake einmalig der Familie offenlegen, nicht speichern."
  ],
  "generated_at": "2026-07-20T12:44:25.647Z",
  "actions": [
    {
      "id": "list_consents",
      "title": "Aktive Einwilligungstexte abrufen",
      "description": "Liefert die aktuell gültigen Einwilligungs-Versionen mit Markdown-Text und IDs. Wird benötigt, um beim submit_intake die korrekten consent_version_id-Werte zu übergeben.",
      "method": "GET",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/list-consents",
      "auth": "none",
      "parameters": {},
      "human_url": "https://hilfeportal.starkeschultern.com/start",
      "cite_as": "https://starkeschultern.com/"
    },
    {
      "id": "submit_intake",
      "title": "Anfrage für Schulbegleitung einreichen",
      "description": "Legt eine neue Eltern-Anfrage an. Antwort enthält einen einmaligen Vorgangs-Code (token). Dieser Code MUSS an die Familie weitergegeben werden — ohne ihn ist kein Zugriff mehr möglich. Token nicht speichern.",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/submit-intake",
      "auth": "none",
      "parameters": {
        "contact": {
          "type": "object",
          "required": true,
          "properties": {
            "first_name": {
              "type": "string",
              "required": true
            },
            "last_name": {
              "type": "string",
              "required": true
            },
            "email": {
              "type": "string",
              "format": "email",
              "required": true
            },
            "phone": {
              "type": "string",
              "required": false
            },
            "postcode": {
              "type": "string",
              "required": false
            }
          }
        },
        "household": {
          "type": "object",
          "required": true,
          "properties": {
            "role": {
              "type": "string",
              "enum": [
                "mother",
                "father",
                "guardian",
                "other"
              ],
              "required": true
            },
            "notes": {
              "type": "string",
              "required": false
            }
          }
        },
        "children": {
          "type": "array",
          "required": true,
          "description": "1–6 Kinder. Pro Kind: first_name, birth_year, optional school_type, grade_level, has_diagnosis, inclusion_status, current_support."
        },
        "answers": {
          "type": "object",
          "required": true,
          "description": "Strukturierte Antworten je Schritt (step_key → answers)."
        },
        "consents": {
          "type": "array",
          "required": true,
          "description": "Liste von { consent_version_id, granted }. Mindestens ein granted=true."
        }
      },
      "rate_limit": "5/h pro IP, 20/Tag pro IP",
      "human_url": "https://hilfeportal.starkeschultern.com/start",
      "cite_as": "https://hilfeportal.starkeschultern.com/start"
    },
    {
      "id": "lookup_status",
      "title": "Vorgangsstatus per Code abfragen",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/lookup-status",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        }
      },
      "rate_limit": "30/10min pro IP",
      "human_url": "https://hilfeportal.starkeschultern.com/status/neu",
      "cite_as": "https://hilfeportal.starkeschultern.com/status/neu"
    },
    {
      "id": "upload_document",
      "title": "Dokument hochladen",
      "description": "Datei-Upload (multipart/form-data). Felder: token, file. Erlaubt: PDF, JPG, PNG, WEBP, HEIC bis 10 MB.",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/upload-document",
      "auth": "none",
      "content_type": "multipart/form-data",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        },
        "file": {
          "type": "file",
          "required": true
        }
      },
      "rate_limit": "30/h pro Token, 60/h pro IP",
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}/unterlagen",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "get_overview",
      "title": "Fall-Übersicht (Status, Dokumente, verfügbare Module)",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/get-overview",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        }
      },
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "check_ai_availability",
      "title": "Verfügbarkeit der Einschätzung prüfen",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/check-ai-availability",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        }
      },
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "generate_assessment",
      "title": "Ersteinschätzung erzeugen",
      "description": "Erstellt eine fachliche Ersteinschätzung zu Erfolgsaussichten, fehlenden Unterlagen und nächsten Schritten.",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/generate",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        },
        "kind": {
          "type": "string",
          "const": "initial_assessment",
          "required": true
        }
      },
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}/ersteinschaetzung",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "generate_document_check",
      "title": "Unterlagencheck erzeugen",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/generate",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        },
        "kind": {
          "type": "string",
          "const": "document_check",
          "required": true
        }
      },
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}/unterlagen",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "generate_open_questions",
      "title": "Vorbereitete offene Fragen erzeugen",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/generate",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        },
        "kind": {
          "type": "string",
          "const": "open_questions",
          "required": true
        }
      },
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}/offene-fragen",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "generate_document_explanation",
      "title": "Erklärung zu einem hochgeladenen Dokument",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/generate",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        },
        "kind": {
          "type": "string",
          "const": "document_explanation",
          "required": true
        },
        "document_id": {
          "type": "string",
          "format": "uuid",
          "required": true
        }
      },
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}/dokumente/{document_id}",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "get_ai_output",
      "title": "Letztes Modul-Ergebnis abrufen",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/get-ai-output",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        },
        "kind": {
          "type": "string",
          "enum": [
            "initial_assessment",
            "document_check",
            "open_questions",
            "document_explanation"
          ],
          "required": true
        },
        "document_id": {
          "type": "string",
          "format": "uuid",
          "required": false
        }
      },
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "get_document",
      "title": "Parent-Metadaten eines Dokuments",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/get-document",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        },
        "document_id": {
          "type": "string",
          "format": "uuid",
          "required": true
        }
      },
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}/dokumente/{document_id}",
      "cite_as": "https://hilfeportal.starkeschultern.com/"
    },
    {
      "id": "request_deletion",
      "title": "DSGVO-Löschanfrage für den Fall",
      "description": "Setzt den Fall auf 'Löschung angefordert'; endgültige Löschung erfolgt automatisiert nach 7 Tagen.",
      "method": "POST",
      "endpoint": "https://hilfeportal.starkeschultern.com/api/public/agent/request-deletion",
      "auth": "none",
      "parameters": {
        "token": {
          "type": "string",
          "required": true
        }
      },
      "rate_limit": "5/h pro IP",
      "human_url": "https://hilfeportal.starkeschultern.com/mein-fall/{token}",
      "cite_as": "https://hilfeportal.starkeschultern.com/datenschutz"
    }
  ]
}