New(ish) API docs for oauth seem pretty whack


I’ve noticed a few problems with the API docs, but the issue that made me open this topic is as follows:


  1. expires_in is listed in the docs as one of the values returned in the hash, but in my testing, it is non-existent. For your debugging purposes, the provided POST:

  2. The grant_type explanation is whack and needs revisiting. It talks about an authentication_code which is not accurate. The required value is authorization_code.


  1. Similar issue, but for response_type. The docs suggest a value of authentication_code but for this one, the appropriate value is code.


@jamesmeador thanks for the corrections - there are a few things I would like to update on our OAuth implementation but we want to keep things stable as folks build against it.