Update REST API docs: add get team endpoint and minor fixes

[caseyyh]

Proposed changes

Fixes https://github.com/pulumi/pulumi-service/issues/21535

1. Adds GetTeam REST API endpoint
2. Corrects typo in List OIDC API
3. Adds default response for List Updates API

[meagancojocar]

Any chance we can combine Deployments REST API docs with our Pulumi Cloud REST API docs as part of this work?

[pulumi-bot]

Your site preview for commit f73e882 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-13758-f73e8820.s3-website.us-west-2.amazonaws.com.

[caseyyh]

Any chance we can combine Deployments REST API docs with our Pulumi Cloud REST API docs as part of this work?

like move the link to here?

[meagancojocar]

Any chance we can combine Deployments REST API docs with our Pulumi Cloud REST API docs as part of this work?

like move the link to here?

No, like combine them into one API doc! We have schedules and TTL in the non-deploy docs now, its a mess. @komalali let me know if you disagree

[komalali]

@meagancojocar yeah, I agree with you. We'll need redirects / aliases to make sure existing links don't break.

[caseyyh]

The URL wouldn't change, it's just moving where the tab is in the navbar.

If it's migrating the deploy docs in its entirety, feels like it should be its own issue + PR. I like small PRs.

[caseyyh]

But my opinion is that the REST API doc page is already huge, rather than lean in on a single uber-huge page, we should split it out by product maybe?