Skip to content

SDK consistency (tenants.list) and v0.14 upgrade guide#751

Merged
leggetter merged 7 commits intomainfrom
fix/sdk-consistency
Mar 13, 2026
Merged

SDK consistency (tenants.list) and v0.14 upgrade guide#751
leggetter merged 7 commits intomainfrom
fix/sdk-consistency

Conversation

@leggetter
Copy link
Collaborator

Summary

  • SDK: Rename tenants.listTenantstenants.list (and Tenants.List / tenants.list) with a single request object in all SDKs (TypeScript, Go, Python), consistent with events.list and attempts.list.
  • Docs: Add full v0.14 upgrade guide (docs/pages/guides/upgrade-v0.14.mdx) including the new List tenants: method rename and request object section, plus nav link in guides.mdx.

Supersedes

Closes / supersedes #745 (docs/upgrade-v0.14). This PR includes the complete v0.14 upgrade guide (PostgreSQL TEXT migration, array query params, Python body=, relaxed URL validation, empty custom_headers) and adds the tenants.list breaking-change section and the guides nav link.

Checklist

  • Upgrade guide covers all v0.14 breaking changes
  • List tenants section with before/after for TS, Go, Python
  • Upgrade to v0.14 linked from Migration Guides in guides.mdx

Made with Cursor

- Add upgrade-v0.14.mdx with full v0.14 breaking changes and new section
  for list tenants: method rename (listTenants → list) and request object
  in all SDKs (TypeScript, Go, Python)
- Add Upgrade to v0.14 link to docs/pages/guides.mdx

Supersedes PR #745 (docs/upgrade-v0.14) with complete guide.

Made-with: Cursor
Copilot AI review requested due to automatic review settings March 13, 2026 12:12
@vercel
Copy link

vercel bot commented Mar 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
outpost-docs Ready Ready Preview, Comment Mar 13, 2026 0:23am
outpost-website Ready Ready Preview, Comment Mar 13, 2026 0:23am

Request Review

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Aligns the “list tenants” SDK surface area across languages (intended rename to tenants.list with a single request object, consistent with events.list / attempts.list) and adds a comprehensive v0.14 upgrade guide to the docs.

Changes:

  • Adds a new spec SDK test for listing tenants via tenants.list(request).
  • Updates docs navigation and adds a v0.14 upgrade guide (including the tenants list breaking change section).
  • Updates SDK regeneration scripts and several language examples to use the new tenants.list API shape.

Reviewed changes

Copilot reviewed 13 out of 14 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
spec-sdk-tests/tests/tenants.test.ts New TS spec test for tenants.list(request)
spec-sdk-tests/scripts/regenerate-sdk.sh Adjusts Go regeneration/build behavior and environment handling
sdks/schemas/speakeasy-modifications-overlay.yaml Adds Speakeasy overlay intending to rename /tenants GET to list + request object
examples/sdk-typescript/auth.ts Adds TS example call to list tenants
examples/sdk-python/run-auth.sh Adds helper script to run Python example via venv
examples/sdk-python/requirements.txt Adds pip requirements for the Python example
examples/sdk-python/example/auth.py Adds Python example call to list tenants via request object
examples/sdk-python/README.md Documents the new run script / setup options
examples/sdk-go/go.mod Updates indirect deps
examples/sdk-go/go.sum Updates checksums for Go example deps
examples/sdk-go/auth.go Adds Go example call to list tenants via request object
docs/pages/guides/upgrade-v0.14.mdx Adds full v0.14 upgrade guide
docs/pages/guides.mdx Adds nav link to the v0.14 upgrade guide
contributing/sdks.md Notes Go cache env vars workaround for regeneration

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

Comment on lines +209 to +218
- target: $["paths"]["/tenants"]["get"]
update:
x-speakeasy-name-override: list
x-speakeasy-max-method-params: 0
x-speakeasy-metadata:
after: sdk.tenants.list()
before: sdk.Tenants.listTenants()
created_at: 1745611620645
reviewed_at: 1745611624395
type: method-name
…-params test

- Upgrade guide: use simple []string for Go (tenantId/topic), not tagged unions
- spec-sdk-tests: add test that events.list accepts array params (tenantId, topic)

Made-with: Cursor
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@leggetter leggetter merged commit eb4ee1a into main Mar 13, 2026
5 checks passed
@leggetter leggetter deleted the fix/sdk-consistency branch March 13, 2026 12:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants