Hey @fool I just spent a few minutes thinking about how to surface the API docs. You’re totally right that it’s clearly listed on the Netlify Docs sidebar. I think the main reason I never investigated it was because there was no “entry point” for me. I think if you sprinkled examples around the Docs that pointed to different API endpoints that would be really really valuable.
For example, I noticed you have a short mention of the API endpoints here: Create deploys | Netlify Docs but if you designed it more like a callout box with a specific color or icon that would be helpful. And then use that same design pattern around the docs like in the build configuration section and other places as well. Just to give some examples to devs of how they can automate or leverage the API in specific ways instead of just having it sit on the sidebar on the docs.
Hope that makes sense. I’d love to be a part of this discussion moving forward so keep me in the loop!