[deif]

I think that these gripes are insignificant compared to the main claim that the platform is dying. I'd advise to not make bold statements such as 'a token in the URL path is unconventional and prone to errors'. Is it prone to errors? As prone as putting it in a header or query param? I'd say that they're exactly the same.

'This is confusing, non-standard, and creates additional complexity'. Is it confusing and adding complexity? All you have to do is look down the list for what you want, it's hardly complex. It's not as if they're naming methods 'obtainChat', 'getUser', 'retrieveLogs', etc.

Which leaves the documentation on the website, which I find quite easy to follow. But let's say it is confusing and it's not as good as it should be. Does that mean the platform is dying? I didn't realise that designing an API to not use all HTTP verbs was such a big deal.