SwissHuman API openapi.json
SwissHuman API

An API for the physical world.

KI kann denken, Software handelt digital – Menschen handeln in der physischen Welt. Diese API verbindet die drei: Deine App, dein Agent oder ChatGPT beauftragt geprüfte Menschen in der Schweiz. Wir kümmern uns um Matching, Nachfassen, Eskalation, Nachweise und Abrechnung.

API-Referenz OpenAPI herunterladen
objective→NEEDS_INFORMATION→QUOTED→ASSIGNING→ASSIGNED→IN_PROGRESS⇄WAITING_FOR_CLIENT / WAITING_FOR_HUMAN→RESULT_SUBMITTED→COMPLETED

POST /v1/tasks

Freitext-Ziel, Deadline, Budget. Wir wählen den Skill, füllen den Task Contract und lösen gemäss Freigabe-Regeln aus.


      

      

        
MCP für ChatGPT, Claude und Agenten

        
Streamable-HTTP-Endpoint mit Tools wie human_create_task, human_approve_task, human_get_status.

        

      

      

        
Whitelabel-Chat

        
Unser Concierge führt das Gespräch mit deinen Nutzer:innen – unter deiner Marke. Du leitest nur Nachrichten durch.

        

      

    


    

      

        
Freigabestufen

        
0 Recherche · 1 Kommunikation · 2 Physische Handlung · 3 Buchung/Kauf · 4 Vertrag/Finanzen. Pro Person: «auto bis CHF X», «fragen» oder «nie». Stufe 4 ist nie automatisch.

      

      

        
Webhooks

        
task.created, task.quoted, task.assigned, task.started, human.question, task.delayed, task.escalated, task.result_submitted, task.completed, task.failed … signiert mit HMAC-SHA256.

      

      

        
Human Availability Graph

        
GET /v1/availability?near=Zürich&transport=car&skill=courier – wer ist jetzt verfügbar, wie weit weg, wie zuverlässig (anonymisiert).

      

    

  


  

    
Referenz
Endpunkte

    
    Authentifizierung: Authorization: Bearer sh_live_… · X-End-User-Id