Hello,
Here are the first real API calls in the v3 API. They are for managing your applications provisional users. Applications that don't need or don't yet have Full Access can, by default, authenticate only for the user who owns the application. It was possible to add additional users, "Provisional Users", but required emailing us and we would do it manually. Now this is available to application developers to do directly via the Provisional Users API calls. Here are the 3 calls:
Also submit your API key in the "x-api-key" header.
Application_ProvisionalUsers_Get
GET application/provisional-users
Returns all provisional users currently added for your application. Initially, this will be an empty list, []. This list does not include the user who owns the application, so seeing an empty list does not indicate that you can no longer authenticate as the application owner.
Application_ProvisionalUsers_Add
POST application/provisional-users/:user_id
Submit this request as a POST, and replace :user_id with the login name or ID of the user you would like to add as a provisional user. Once this user is added, your provisional application will be able to authenticate this user via OAuth. Note that this call only works for applications that do not yet have full access.
Application_ProvisionalUsers_Remove
DELETE application/provisional-users/:user_id
Submit this with the DELETE method, and again, replace :user_id with the login_name or ID of the user you would like to remove as a provisional user.
Please let me know if you have any questions about these methods or notice any unexpected behavior.
Thanks,
Matt