API error type
Invalid pair-mode transition
HTTP 409 https://errors.driftstack.dev/pair-mode-invalid-transition
What it means
The requested pair-mode transition is not legal from the session’s current state (e.g. handback when no human is driving).
How to fix it
Read from and transition in the error body; fetch the session to see the current pair_mode_state and drive the state machine from there.
Where it appears
In the type field of the RFC 9457 application/problem+json error body, alongside title, status, detail, and an instance correlation id.
Related
- Pair-mode takeover already in flight
/pair-mode-conflict