API Status after the release


#1

Post-rename and mostly-release.

I see machine-man is still required. Are all APIs now usable by GH Apps, or is the list still limited as before? I can no longer find the page listing supported APIs as an App-installation user.


#2

I can still find APIs that aren’t supported, for example here: https://developer.github.com/v3/repos/branches/#remove-required-status-checks-of-protected-branch

When is the support for all these APIs going to be finished?


#3

Hey, @ramonsnir – sorry the delay in getting back to you on this. Yeah, some API endpoints have not been enabled for GitHub Apps yet. I’ve asked the team for input to see what the plans are around that (covering other API endpoints) and we’ll followup as soon as we have any updates.

Thanks for the thoughtful question/feedback!


#4

@ramonsnir Okay, here are some more answers (and more detailed answers):

I see machine-man is still required.

That’s true – it’s still required. But it should be required only for API endpoints related to the GitHub Apps feature, I believe, e.g. fetching the list of installations for a GitHub App. It should not be required to use other API endpoints, such as fetching an issue. Is that not the behavior you observed?

The preview will continue to be required as we are still working on improving the API endpoints related to GitHub Apps, and might make changes. The preview mode allows us to make those changes, because that’s one of the defining characteristics of the preview: it allows us to make potentially breaking changes if we need to (based on internal and external feedback).

Are all APIs now usable by GH Apps, or is the list still limited as before?

It’s limited as before. If there are any endpoints you’d like to see enabled for GitHub Apps – please create a topic on this forum, state your request and explain your use-case a bit. We’ll then open an internal issue to discuss the request, what the permissions around that would looks like, and if/when we can enable the endpoint. Does that sound okay?

I can no longer find the page listing supported APIs as an App-installation user.

It should now be available again here:

https://developer.github.com/v3/apps/available-endpoints/

Thanks again for reporting this!