Add plugin_runs to open-api

[vbrown608]

This adds a PluginRun creation endpoint to open-api. This is a Netlify-internal endpoint that's only accessible from within our build system, but needs to be added here in order to included in the Javascript client.

I kept the specification very minimal, especially in terms of acceptable values and required fields, so we can iterate quickly as we approach GA.

I was reading through the redoc docs and saw this line: https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md#usage-in-redoc

please make sure you add all tags to a group, since a tag that is not in a group, will not be displayed at all!

I think we can use it to our advantage to omit endpoints from the UI. You can verify here: https://deploy-preview-232--open-api.netlify.app

I added an x-internal tag, which doesn't do anything but provide a bit of information to readers of the YAML file.

@verythorough I would like to know what you think of this as a short-term solution while we develop our internal API docs approach.

[netlify]

Deploy preview for open-api ready!

Built with commit e0fdc4a

https://deploy-preview-232--open-api.netlify.app

[vbrown608]

@verythorough I would like to know what you think of this as a short-term solution while we develop our internal API docs approach.

Merging so @ehmicky can proceed but let's still talk about it 😺

[verythorough]

Oh, sorry I missed the question, @vbrown608 ! Nice find in the ReDocs docs. I like your approach as an intermediate step as we work on the long term solution @keiko713 is now organizing.

[vbrown608]

Great 👍

No worries on missing, it was more like, I asked the question and then realized I wanted to merge two minutes later 😝