{"name":"whatsoup API","version":"2.0.0","description":"Multi-User & Multi-WhatsApp Web Automation and Webhook Relay API","authentication":{"type":"Bearer Token or X-API-Key","format":"wsp_...","headers":{"Authorization":"Bearer wsp_<token>","X-Session-Id":"<target-session-id> (optional if token is restricted to a session)"}},"permissions":["admin","messages:read","messages:send","webhook:manage","session:manage","screenshot:read"],"endpoints":[{"method":"POST","path":"/api/auth/login","description":"Authenticate user and receive session cookie & token.","requestBody":{"username":"admin","password":"password"}},{"method":"GET","path":"/api/sessions","description":"List all WhatsApp instances accessible by user."},{"method":"POST","path":"/api/sessions","description":"Create a new WhatsApp instance for the current user.","requestBody":{"name":"Sales WhatsApp"}},{"method":"GET","path":"/api/tokens","description":"List API tokens owned by current user."},{"method":"POST","path":"/api/tokens","description":"Create an API token with custom permissions and optional WhatsApp session restriction.","requestBody":{"name":"Discord Bot Token","sessionId":"wapp_123456","permissions":["messages:read","messages:send"]}},{"method":"POST","path":"/api/send","description":"Send a message to a phone number or contact name via WhatsApp.","headers":{"Authorization":"Bearer wsp_<your_token>","X-Session-Id":"wapp_123456"},"requestBody":{"phone":"+33670556111","message":"Hello from whatsoup!"}},{"method":"GET","path":"/api/messages","description":"Retrieve incoming messages for a WhatsApp instance.","headers":{"Authorization":"Bearer wsp_<your_token>"}},{"method":"GET","path":"/status","description":"Get connection status of the targeted WhatsApp instance."},{"method":"GET","path":"/qr","description":"Get QR Code PNG when WhatsApp instance is awaiting scan."},{"method":"GET","path":"/screenshot","description":"Get live browser screenshot for debugging."}]}