STG-1443 Add section in docs for baseUrl

Closed
MO
3mo ago
+150-5

What

Add clearer documentation for using baseUrl / base_url to select a regional Stagehand API endpoint in generated SDK docs. Also mark browserbaseSessionCreateParams.region as deprecated in the generated spec/docs.

Note that our bugbots are complaining about not using zod meta for deprecated field but they are inaccurate - I tried this.

Why

For hosted Stagehand, the API endpoint the client calls is what determines the pod region. In the hosted server, any client-provided browserbaseSessionCreateParams.region is overridden to the API instance's AWS_REGION, so baseUrl is the correct user-facing mechanism to document.

Testing

  • validated local Mintlify preview against the local v3 OpenAPI spec