Creo que es completamente razonable que el cambio lleve tiempo. Dirigí las Relaciones con Desarrolladores en mi última empresa y, por Dios… tardamos más de dos años en mejorar nuestras API. Había tantas cosas complejas a considerar (¡y a ingeniería le odiaba la idea de crear un punto final estable que no pudiera cambiar!).
Sin embargo, creo que los cambios más pequeños también pueden ocurrir con el tiempo y en un plazo más corto. Admito que no he investigado cómo se definen sus rutas (o cómo se definen las rutas en Ruby), pero supongo que algunas mejoras fáciles podrían abordarse con bastante facilidad. Por ejemplo:
No puedo hablar por todos, pero siento que incluso tener los puntos finales en su especificación de API actual, aunque no tuvieran descripciones y ejemplos, y aunque el modelo de respuesta fuera fluido, sería una gran victoria. A veces, simplemente saber que algo existe es la mitad de la batalla.