fix: api v2 calendars/busy-times docs

[supalarry]

Fixes #27791

---

Summary by cubic

Updated API v2 /calendars/busy-times docs to require dateFrom/dateTo and calendarsToLoad (bracket-notation array), and clarified that loggedInUsersTz is deprecated in favor of timeZone. This aligns Swagger/OpenAPI and examples with the actual request per CAL-7189.

• Bug Fixes
  • Added explicit ApiQuery for calendarsToLoad with schema and URL example.
  • Hid nested Calendar fields and calendarsToLoad in Swagger so credentialId/externalId don’t appear as top-level query params.
  • Synced OpenAPI and oasdiff ignore with these changes (removed credentialId/externalId, marked calendarsToLoad required, made dateFrom/dateTo required).

^{Written for commit f8bb959. Summary will update on new commits.}

[linear]

CAL-7189 fix: api v2 calendars/get-busy times docs

[paragon-review]

Paragon Review Unavailable

Hi @supalarry! To enable Paragon reviews on this repository, please register at https://home.polarity.cc

Once registered, connect your GitHub account and Paragon will automatically review your pull requests.

[cubic-dev-ai]

No issues found across 3 files

[github-actions]

Devin AI is resolving merge conflicts

This PR has merge conflicts with the main branch. A Devin session has been created to automatically resolve them.

View Devin Session

Devin will:

1. Merge the latest main into this branch
2. Resolve any conflicts intelligently
3. Run lint/type checks to ensure validity
4. Push the resolved changes

If you prefer to resolve conflicts manually, you can close the Devin session and handle it yourself.

[github-actions]

This PR has been marked as stale due to inactivity. If you're still working on it or need any help, please let us know or update the PR to keep it active.