Epic: Private beta of initial public APIs

[loujaybee]

This epic is for the exposure of the initial API's in our public documentation, following the completion of:

• Epic: MVC Public Gitpod API #7900

Remaining items

• https://github.com/gitpod-io/website/issues/3112
• https://github.com/gitpod-io/website/issues/3174
• https://github.com/gitpod-io/website/issues/3172
• https://github.com/gitpod-io/website/issues/3173
• Introduce mechanism to opt-in to private beta

Completed actions:

• https://github.com/gitpod-io/website/issues/2911
• Documenting Go SDK
• Adding an API doc page to references
• Documenting authentication approach (https://www.gitpod.io/docs/configure/user-settings/access-tokens)
• Some context for users on what the API is, why we have it, what you can do with it, etc.

Relates to:

• Epic: Private beta of initial public APIs #10798
• Epic: Prebuild Public APIs #15213
• Epic: Resource Usage (Billing) Public APIs #11335
• Epic: Automate off + onboarding via Public API (users, teams & projects) #10799
• Epic: Personal Access Tokens #14280
• Epic: Create external workspace dashboards or clients (e.g. CLI or IdP) via Public API #10427
• Epic: Service accounts (Auth tokens not tied to users) #15419
• Epic: Foundations for Fine Grained Authorization #15632
• Epic: Automated workspace creation (e.g. in CI pipelines) via Public API #15829

Callout: 👋 Are you interested in this feature? We would be interested to talk to you to hear your feedback.