Refresh Isochrones
(Re)compute the org’s in-person tutors’ drive-time isochrones from Mapbox, caching them for the accurate coverage overlay + the gate’s ST_Contains leg.
Skips serves_all_areas / online tutors (no bounded reach to model) and any tutor
whose home coordinate has not moved since its cached isochrone (the skip-guard), so
repeat calls cost nothing. When MAPBOX_TOKEN is unset, enabled is false and nothing
is computed — the map keeps using the max_travel_km radius circle. Intended for a
cron / Hermes trigger; bounded by MAPBOX_ISOCHRONE_MAX_PER_REFRESH per call.
Authorizations
Org API key as Token token=ei_live_...
Query Parameters
Only refresh tutors who teach this subject id
Drive-time contour in minutes (default from config)
5 <= x <= 60Response
Successful Response
Outcome of POST /v1/coverage/isochrones/refresh. enabled is false when no
MAPBOX_TOKEN is configured (nothing was computed; the map uses radius circles).
computed were fetched from Mapbox, cached were already fresh (skip-guard),
failed errored, considered is how many in-person tutors were in scope.