Restrict drivers from going online

September 9, 2026

You can now stop a driver from going online without blocking their account. A restricted driver stays signed in and can still reach support and look at their past tours — they simply cannot go online until the restriction is lifted. Every restriction carries a reason, names the person who applied it, and is written into the driver’s notes.

Blocking an account signs the driver out and keeps them signed out. A restriction is the lighter measure, for the situations that come up day to day: a vehicle that does not match the account, proof-of-completion photos that keep coming back unusable, an incident that needs looking into before the driver takes more work. Those are temporary situations, and taking the driver out of the pool while keeping their support channel open is usually what resolves them fastest.

Every restriction states its reason

List Online Restriction Reasons serves the reasons you can choose from. They are the same twelve for every operation, translated into the driver’s language, and the order in the response is the order to display them in. Four of them — account compliance issue, policy violation, safety incident and “Other” — carry note_required: true and need a note of up to 250 characters alongside them; on the rest the note is yours to add or leave out.

Applying and lifting a restriction

Restrict driver from going online applies one, Lift driver online restriction lifts it again and clears the reason and note. The driver payloads from List Users and Show a user carry an online_restricted boolean for list views and an online_restriction object with the reason, note, timestamp and the ID of the user who applied it, so a driver list and a driver profile can both be rendered from what you already fetch.

Restrictions sit next to the account block rather than inside it: a driver can be restricted, blocked, or both, and the two are lifted independently. To change the reason on an active restriction, lift it and apply a new one — that way the history keeps both entries.

Work in progress is finished, not dropped

Restricting a driver acts on their work immediately. Scheduled tours they had claimed return to the claimable pool, and the driver gets the same notification they would get if a dispatcher had unclaimed them. The driver is then sent offline through the regular offlining, so your integration sees an ordinary offline event rather than a special case.

A driver who is in the middle of a tour is the exception worth knowing about. That tour is finished undisturbed — the restriction waits and takes effect the moment the tour ends, however it ends. Until then the driver cannot claim or pick up anything new, so no fresh work reaches them in the meantime.

When a restricted driver tries to go online, the request is refused with the failure code going_online_restricted and a message naming the reason, translated into the driver’s language, followed by your note exactly as you wrote it — for example “Your account has been restricted. Reason: Repeated delays. Late on six of the last ten tours.” That refusal takes precedence over anything else that would have blocked them from going online, so the driver is told about the restriction rather than about a missing capability.

The history stays readable after the fact

Each restriction and each lift writes a note on the driver, so months later it is still possible to see who restricted them, when, and why — even though lifting clears the reason from the driver’s payload. The notes are written by the platform with the system source, wording the reason in your operation’s default language, and are readable through List notes. The Notes overview covers the rest of that surface, including who gets to read them.

What comes next

Support in our own apps is on its way. In the web dashboard, your team will apply and lift restrictions from the driver’s profile and see the restricted state in the drivers list. In the driver app, a restricted driver gets a “You can’t go online” alert showing the reason together with a Contact support action.

Until those app versions have rolled out to your fleet, drivers on current versions see the app’s generic “having issues sending you online” message instead of the reason you picked, because older apps only recognise one go-online error. The restriction itself works exactly as described — it is only the explanation that does not reach the driver yet — so it is worth telling your dispatch team to expect questions from restricted drivers in the meantime.