Deprecations

As our product evolves we sometimes make way for newer features to replace older ones. This can involve potentially breaking changes to existing features. To keep the operational impact small we announce such changes here before their sunset.

Announced October 28, 2026 Due November 25, 2026 Pending
Deprecation of driver-only booking attributes1

Three attributes on booking payloads are deprecated and will be removed on 2026-11-25. They were only ever used internally by our driver app2.

Announced September 9, 2026 Due October 7, 2026 Completed
Deprecation of large synchronous route optimizations3

Route optimization requests carrying more than 10 stops are deprecated on Optimize Route4 and will be rejected from 2026-10-07. Every integration that sends large problems has to move to the asynchronous flow announced in Optimize large routes without waiting on the request5, which explains how to submit an optimization and fetch its result.

Announced July 15, 2026 Due October 7, 2026 Completed
Deprecation of the completion_requirements.fail indicator6

The boolean fail indicator inside the completion_requirements object on stop payloads is now deprecated and will be removed on 2026-10-07.

Announced June 24, 2026 Due September 30, 2026 Pending
Deprecation of the admin.places permission indicator7

The admin.places indicator on the permissions endpoint (GET /api/user/permissions) is now deprecated and will be removed on 2026-09-30.

Announced May 27, 2026 Due May 27, 2026 Completed
Removal of the Fleet management feature8

The Fleet management feature has been removed from the MotionTools platform, effective with the production release on 2026-05-27.

Announced May 7, 2026 Due November 6, 2026 Pending
Deprecation of tour earnings attribute and webhook9

The legacy tour earnings surface — the PUT /api/hailing/bookings/:booking_id/earnings endpoint, the tour.earnings_updated webhook, and the earnings field on tour responses — is now deprecated and will be removed on 2026-11-06.

Announced April 29, 2026 Due September 16, 2026 Completed
Deprecation of hailing/failure_reasons endpoint10

The public GET /api/hailing/failure_reasons endpoint is now deprecated and will be removed on 2026-09-16. Package failure reasons are now served through the unified reasons API at GET /api/reasons/package_failure, in the same shape used by the other reason categories such as stop failure reasons.

Announced March 11, 2026 Due June 4, 2026 Completed
Deprecation of active_hailing_booking_ids user field11

The active_hailing_booking_ids field on the User resource is now deprecated and will be removed in a future release. This only affects List Users and Show User endpoints.

Announced February 24, 2026 Due August 24, 2026 Completed
Deprecation of on_active_hailing_booking users filter12

The on_active_hailing_booking filter parameter on the List Users endpoint is now deprecated and will be removed in a future release.

Announced January 28, 2026 Due July 28, 2026 Completed
Deprecation of gradual_rollout_frequency_seconds13

The gradual_rollout_frequency_seconds field on scheduling configs is now deprecated and will be removed in a future release.

Announced November 19, 2025 Due February 12, 2026 Completed
Removal of hailing_booking/preferred_drivers endpoint14

To align the existing endpoints with our new naming conventions, we are removing the /api/hailing_bookings/:id/preferred_drivers endpoint.

Announced June 19, 2025 Due August 19, 2025 Completed
Removal of return_to_hub property on tour response15

We are removing the return_to_hub property returned on the standard response for bookings & tours.

Announced May 22, 2025 Due August 6, 2025 Completed
Removal of generic force_delivery package transition16

Due to the introduction of configurable off-tour package delivery proofs we are replacing the generic force_delivery transition with a dedicated endpoint.

Announced February 26, 2025 Due August 13, 2025 Completed
Adjusted indication for ability to remove package from tour17

On the package lookup endpoint we are renaming the removable_from_dropoff_tour permission indicator to the standardized permissions.removable property.

Announced January 15, 2025 Due September 2, 2025 Completed
Removal of hailing_booking.* webhooks18

Due to the ongoing split between bookings and tours, we are deprecating a wide range of webhook events that were shared between both bookings and tours in the past, replacing them with booking and tour specific replacements where suitable.

Announced August 13, 2024 Due March 11, 2026 Completed
Simplified stop update routes19

We have added simplified routes for granular stop data editing endpoints.

You can also subscribe20 to our Deprecations Atom feed21 to receive updates.

Links in this article

  1. https://docs.motiontools.io/announcements/deprecations/2026/10/28/deprecation-of-driver-only-booking-attributes.html
  2. https://help.motiontools.io/driver-app-workforce-management/driver-app
  3. https://docs.motiontools.io/announcements/deprecations/2026/09/09/large-synchronous-route-optimizations.html
  4. https://docs.motiontools.io/#operation/OptimizeRoute
  5. https://docs.motiontools.io/announcements/changelog/2026/09/09/asynchronous-route-optimization.html
  6. https://docs.motiontools.io/announcements/deprecations/2026/07/15/deprecation-of-completion-requirements-fail-indicator.html
  7. https://docs.motiontools.io/announcements/deprecations/2026/06/24/deprecation-of-admin-places-permission-indicator.html
  8. https://docs.motiontools.io/announcements/deprecations/2026/05/27/removal-of-fleet-management.html
  9. https://docs.motiontools.io/announcements/deprecations/2026/05/07/tour-earnings-attribute-and-webhook.html
  10. https://docs.motiontools.io/announcements/deprecations/2026/04/29/deprecation-of-hailing-failure-reasons-endpoint.html
  11. https://docs.motiontools.io/announcements/deprecations/2026/03/11/deprecation-of-active-hailing-booking-ids.html
  12. https://docs.motiontools.io/announcements/deprecations/2026/02/24/deprecation-of-on-active-hailing-booking-filter.html
  13. https://docs.motiontools.io/announcements/deprecations/2026/01/28/deprecation-of-gradual-rollout-frequency-seconds.html
  14. https://docs.motiontools.io/announcements/deprecations/2025/11/19/removal-of-hailing-bookings-preferred-drivers-endpoint.html
  15. https://docs.motiontools.io/announcements/deprecations/2025/06/19/removal-of-tour-return_to_hub-property.html
  16. https://docs.motiontools.io/announcements/deprecations/2025/05/22/removal-of-generic-force_delivery.html
  17. https://docs.motiontools.io/announcements/deprecations/2025/02/26/package-lookup-removal-permissions.html
  18. https://docs.motiontools.io/announcements/deprecations/2025/01/15/removal-of-hailing_booking-webhook-namespace.html
  19. https://docs.motiontools.io/announcements/deprecations/2024/08/13/simplified-stop-update-routes.html
  20. https://docs.motiontools.io/announcements/feeds.html
  21. https://docs.motiontools.io/announcements/feed/Deprecations.xml