Skip to content

MV-21235 - Creating minor SDK release for upcoming TFV breaking changes - #314

Open
adamrbaldwin-bw wants to merge 1 commit into
mainfrom
MV-21235
Open

adamrbaldwin-bw wants to merge 1 commit into
mainfrom
MV-21235

Conversation

@adamrbaldwin-bw

Copy link
Copy Markdown

Summary

Regenerates this SDK from the spec changes in Bandwidth/api-specs#2566 (MV-21235) so a new minor version can be released ahead of upcoming Toll-Free Verification (TFV) changes. This lets customers adopt the new request shape before the API enforces it.

Upcoming TFV changes

  • October 19, 2026: TFV submissions must include businessEntityType. When it is anything other than SOLE_PROPRIETOR, businessRegistrationNumber, businessRegistrationType and businessRegistrationIssuingCountry are also required. SOLE_PROPRIETOR submissions must omit all three. Violations return 400 Bad Request.
  • January 2027: requests for a number that already has a verification in progress will be rejected with 409 Conflict (new 409 response documented on the submit and update endpoints; delete will cancel an in-progress verification).

Why release now

The API already accepts businessEntityType and the registration fields today, so the updated SDK is compatible with the current API. Releasing before the changes take effect lets customers upgrade and start sending the new fields on their own schedule.

SDK changes

  • businessEntityType is now required on the TFV request models. This is a compile/validation-time change for callers who omit it.
  • Updated TFV field docs and added 409 handling docs.
  • Includes unrelated Media API doc wording updates already on api-specs main.
  • Existing hand-written unit tests updated for the newly required field where needed.

Notes for review

  • bandwidth.yml comes from the unmerged api-specs PR, which is planned to merge Monday, Oct 19, before the next weekly update-sdks run. The weekly run should then produce no diff for this SDK.
  • Generated with combine-specs.sh and generate.sh; unrelated example-value churn was discarded.

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@adamrbaldwin-bw
adamrbaldwin-bw requested review from a team as code owners October 13, 2026 19:18
@bwappsec

bwappsec commented Oct 13, 2026 •

Copy link
Copy Markdown

✅ Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
✅ Open Source Security 0 0 0 0 0 issues
✅ Licenses 0 0 0 0 0 issues
✅ Code Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

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.

2 participants