Stop a session and disconnect WhatsApp
POST/api/sessions/:sessionId/stop
Stop a session and disconnect WhatsApp
Request
Responses
- 200
- 404
- 409
- 502
Session stopped
Session not found
Another node currently holds this session's live engine (multi-node deployments): stopping it here would report the session down while the owner keeps running it, so the request is refused. Retry against the owning node, or once its lease has lapsed.
Session was stopped locally, but the engine teardown did not complete (the graceful disconnect and the force-destroy escalation both failed, so the engine process may still be running). Retryable — the body carries code: 'SESSION_STOP_INCOMPLETE'; the status is settled to disconnected and no success audit is written. Retry the stop; restart the node to reap a leaked process.