From 69f85a53062aa7e5d23d9218adf732279d0bed31 Mon Sep 17 00:00:00 2001 From: adambaldwin Date: Tue, 13 Oct 2026 15:17:58 -0400 Subject: [PATCH] MV-21235 Update SDK Based on Recent Spec Changes Co-Authored-By: Claude Sonnet 5.5 --- api/openapi.yaml | 98 ++++++++++++++----- bandwidth.yml | 80 +++++++++++---- docs/MediaApi.md | 6 +- docs/TfvSubmissionInfo.md | 4 +- docs/TollFreeVerificationApi.md | 9 +- docs/VerificationRequest.md | 4 +- docs/VerificationUpdateRequest.md | 6 +- .../java/com/bandwidth/sdk/api/MediaApi.java | 14 +-- .../sdk/api/TollFreeVerificationApi.java | 30 ++++-- .../sdk/model/BusinessEntityTypeEnum.java | 2 +- .../model/BusinessRegistrationTypeEnum.java | 2 +- .../sdk/model/TfvSubmissionInfo.java | 4 +- .../sdk/model/VerificationRequest.java | 4 +- .../sdk/model/VerificationUpdateRequest.java | 20 ++-- 14 files changed, 194 insertions(+), 89 deletions(-) diff --git a/api/openapi.yaml b/api/openapi.yaml index f7d1da77..87276427 100644 --- a/api/openapi.yaml +++ b/api/openapi.yaml @@ -301,9 +301,9 @@ paths: - application/octet-stream put: description: |- - Upload a file. You may add headers to the request in order to provide some control to your media file. + Upload a file. - If a file is uploaded with the same name as a file that already exists under this account, the previous file will be overwritten. + Filename should always be unique. Reusing filenames may result in the wrong media being sent. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). operationId: uploadMedia @@ -338,8 +338,9 @@ paths: schema: type: string style: simple - - description: General-header field is used to specify directives that MUST - be obeyed by all caching mechanisms along the request/response chain. + - description: Pass-through header stored with the media and returned when the + media is retrieved by the user. Does not affect internal server caching + behavior. example: no-cache explode: false in: header @@ -4939,7 +4940,12 @@ paths: callbacks: tfVerificationStatus: $ref: "#/components/callbacks/tfVerificationStatus" - description: Submit a request for verification of a toll-free phone number. + description: |- + Submit a request for verification of a toll-free phone number. + + **Upcoming change (effective January 2027):** If any phone number in the request already has a verification in progress, the request will be rejected with a `409 Conflict`. + This check is all-or-nothing: if a single phone number conflicts, the entire request is rejected and **none** of the phone numbers in the request are submitted. + Today, these requests are accepted with a `202`. operationId: requestTollFreeVerification parameters: - description: Your Bandwidth Account ID. @@ -4996,6 +5002,16 @@ paths: schema: $ref: "#/components/schemas/tfvError" description: Method Not Allowed + "409": + content: + application/json: + example: + description: "TFV request already in progress for phone number: +18005551234" + type: conflict + schema: + $ref: "#/components/schemas/tfvError" + description: Conflict. A toll-free verification for the phone number is + already in progress. "429": content: application/json: @@ -5034,7 +5050,10 @@ paths: url: https://api.bandwidth.com/api/v2 /accounts/{accountId}/phoneNumbers/{phoneNumber}/tollFreeVerification: delete: - description: Delete a toll-free verification submission for a toll-free number. + description: |- + Delete a toll-free verification submission for a toll-free number. + + **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, it will be cancelled and the submission will then be deleted asynchronously. operationId: deleteVerificationRequest parameters: - description: Your Bandwidth Account ID. @@ -5250,6 +5269,9 @@ paths: description: |- Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). + Returns a `404` if no verification request exists for the phone number, and a `400` if the existing request is not eligible for resubmission. + + **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, the update will be rejected with a `409 Conflict`. operationId: updateTollFreeVerificationRequest parameters: - description: Your Bandwidth Account ID. @@ -5306,6 +5328,15 @@ paths: schema: $ref: "#/components/schemas/tfvError" description: Forbidden + "404": + content: + application/json: + example: + description: Cannot find the requested resource. + type: Not Found + schema: + $ref: "#/components/schemas/tfvError" + description: Cannot find the requested resource. "405": content: application/json: @@ -5315,6 +5346,16 @@ paths: schema: $ref: "#/components/schemas/tfvError" description: Method Not Allowed + "409": + content: + application/json: + example: + description: "TFV request already in progress for phone number: +18005551234" + type: conflict + schema: + $ref: "#/components/schemas/tfvError" + description: Conflict. A toll-free verification for the phone number is + already in progress. "429": content: application/json: @@ -7383,8 +7424,8 @@ components: type: string style: simple cacheControl: - description: General-header field is used to specify directives that MUST be - obeyed by all caching mechanisms along the request/response chain. + description: Pass-through header stored with the media and returned when the + media is retrieved by the user. Does not affect internal server caching behavior. example: no-cache explode: false in: header @@ -9035,6 +9076,16 @@ components: schema: $ref: "#/components/schemas/tfvError" description: Cannot find the requested resource. + tfvConflictResponse: + content: + application/json: + example: + description: "TFV request already in progress for phone number: +18005551234" + type: conflict + schema: + $ref: "#/components/schemas/tfvError" + description: Conflict. A toll-free verification for the phone number is already + in progress. tfvNotAllowedResponse: content: application/json: @@ -15163,7 +15214,7 @@ components: description: | Government-issued business identifying number. - **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** + **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** example: 12-3456789 maxLength: 500 nullable: true @@ -15172,7 +15223,7 @@ components: description: | The type of business registration number. - **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** + **This field is required when `businessRegistrationNumber` is provided.** enum: - EIN - CBN @@ -15199,7 +15250,7 @@ components: description: |- The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. - **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** + **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| @@ -15225,13 +15276,11 @@ components: nullable: true type: string businessEntityTypeEnum: - description: "The type of registered business.\n\n**Note: As of October 19th,\ - \ 2026 submissions using a value other than `SOLE_PROPRIETOR` must provide\ - \ a value for `businessRegistrationNumber`, `businessRegistrationType`, and\ - \ `businessRegistrationIssuingCountry`. \nSubmissions using `SOLE_PROPRIETOR`\ - \ must _omit_ `businessRegistrationNumber`, `businessRegistrationType`, and\ - \ `businessRegistrationIssuingCountry`. Failure to adhere to these constraints\ - \ will result in a 400 Bad Request rejection.**\n" + description: | + The type of registered business. + + **Submissions using a value other than `SOLE_PROPRIETOR` must provide a value for `businessRegistrationNumber`, `businessRegistrationType`, and `businessRegistrationIssuingCountry`. + Submissions using `SOLE_PROPRIETOR` must _omit_ `businessRegistrationNumber`, `businessRegistrationType`, and `businessRegistrationIssuingCountry`. Failure to adhere to these constraints will result in a 400 Bad Request rejection.** enum: - SOLE_PROPRIETOR - PRIVATE_PROFIT @@ -15342,7 +15391,7 @@ components: description: | Government-issued business identifying number. - **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** + **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** example: 12-3456789 maxLength: 500 nullable: true @@ -15353,7 +15402,7 @@ components: description: |- The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. - **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** + **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| @@ -15479,7 +15528,7 @@ components: description: | Government-issued business identifying number. - **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** + **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** example: 12-3456789 maxLength: 500 nullable: true @@ -15492,7 +15541,7 @@ components: description: |- The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. - **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** + **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| @@ -15540,6 +15589,7 @@ components: required: - businessAddress - businessContact + - businessEntityType - messageVolume - optInWorkflow - productionMessageContent @@ -16387,7 +16437,7 @@ components: description: | Government-issued business identifying number. - **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** + **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** example: 12-3456789 maxLength: 500 nullable: true @@ -16398,7 +16448,7 @@ components: description: |- The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. - **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** + **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| diff --git a/bandwidth.yml b/bandwidth.yml index 53949fed..6b44f54f 100644 --- a/bandwidth.yml +++ b/bandwidth.yml @@ -88,12 +88,11 @@ paths: put: summary: Upload Media description: >- - Upload a file. You may add headers to the request in order to provide - some control to your media file. + Upload a file. - If a file is uploaded with the same name as a file that already exists - under this account, the previous file will be overwritten. + Filename should always be unique. Reusing filenames may result in the + wrong media being sent. A list of supported media types can be found at [Bandwidth @@ -1404,7 +1403,19 @@ paths: tags: - Toll-Free Verification summary: Request Toll-Free Verification - description: Submit a request for verification of a toll-free phone number. + description: >- + Submit a request for verification of a toll-free phone number. + + + **Upcoming change (effective January 2027):** If any phone number in the + request already has a verification in progress, the request will be + rejected with a `409 Conflict`. + + This check is all-or-nothing: if a single phone number conflicts, the + entire request is rejected and **none** of the phone numbers in the + request are submitted. + + Today, these requests are accepted with a `202`. operationId: requestTollFreeVerification parameters: - $ref: '#/components/parameters/accountId4' @@ -1421,6 +1432,8 @@ paths: $ref: '#/components/responses/tfvForbiddenResponse' '405': $ref: '#/components/responses/tfvNotAllowedResponse' + '409': + $ref: '#/components/responses/tfvConflictResponse' '429': $ref: '#/components/responses/tfvTooManyRequestsResponse' '500': @@ -1477,6 +1490,14 @@ paths: Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). + + Returns a `404` if no verification request exists for the phone number, + and a `400` if the existing request is not eligible for resubmission. + + + **Upcoming change (effective January 2027):** If a verification for the + phone number is in progress, the update will be rejected with a `409 + Conflict`. operationId: updateTollFreeVerificationRequest parameters: - $ref: '#/components/parameters/accountId4' @@ -1492,8 +1513,12 @@ paths: $ref: '#/components/responses/tfvUnauthorizedResponse' '403': $ref: '#/components/responses/tfvForbiddenResponse' + '404': + $ref: '#/components/responses/tfvNotFoundResponse' '405': $ref: '#/components/responses/tfvNotAllowedResponse' + '409': + $ref: '#/components/responses/tfvConflictResponse' '429': $ref: '#/components/responses/tfvTooManyRequestsResponse' '500': @@ -1504,7 +1529,13 @@ paths: tfVerificationStatus: $ref: '#/components/callbacks/tfVerificationStatus' delete: - description: Delete a toll-free verification submission for a toll-free number. + description: >- + Delete a toll-free verification submission for a toll-free number. + + + **Upcoming change (effective January 2027):** If a verification for the + phone number is in progress, it will be cancelled and the submission + will then be deleted asynchronously. operationId: deleteVerificationRequest parameters: - $ref: '#/components/parameters/accountId4' @@ -6273,10 +6304,9 @@ components: Government-issued business identifying number. - **Note: As of October 19th, 2026 this field will be required when - `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is - provided, `businessRegistrationType` and - `businessRegistrationIssuingCountry` are also required.** + **This field is required when `businessEntityType` is _not_ + `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` + and `businessRegistrationIssuingCountry` are also required.** nullable: true maxLength: 500 example: 12-3456789 @@ -6286,8 +6316,8 @@ components: The type of business registration number. - **Note: As of October 19th, 2026 this field will be required when - `businessRegistrationNumber` is provided.** + **This field is required when `businessRegistrationNumber` is + provided.** enum: - EIN - CBN @@ -6317,8 +6347,8 @@ components: encouraged. - **Note: As of October 19th, 2026 this field will be required when - `businessRegistrationNumber` is provided.** + **This field is required when `businessRegistrationNumber` is + provided.** | Registration Type | Supported Countries | @@ -6368,9 +6398,9 @@ components: The type of registered business. - **Note: As of October 19th, 2026 submissions using a value other than - `SOLE_PROPRIETOR` must provide a value for `businessRegistrationNumber`, - `businessRegistrationType`, and `businessRegistrationIssuingCountry`. + **Submissions using a value other than `SOLE_PROPRIETOR` must provide a + value for `businessRegistrationNumber`, `businessRegistrationType`, and + `businessRegistrationIssuingCountry`. Submissions using `SOLE_PROPRIETOR` must _omit_ `businessRegistrationNumber`, `businessRegistrationType`, and @@ -6490,6 +6520,7 @@ components: - useCaseSummary - productionMessageContent - optInWorkflow + - businessEntityType properties: businessAddress: $ref: '#/components/schemas/address' @@ -8072,6 +8103,17 @@ components: example: description: Cannot find the requested resource. type: Not Found + tfvConflictResponse: + description: >- + Conflict. A toll-free verification for the phone number is already in + progress. + content: + application/json: + schema: + $ref: '#/components/schemas/tfvError' + example: + description: 'TFV request already in progress for phone number: +18005551234' + type: conflict tfvNotAllowedResponse: description: Method Not Allowed content: @@ -8256,8 +8298,8 @@ components: style: simple explode: false description: >- - General-header field is used to specify directives that MUST be obeyed - by all caching mechanisms along the request/response chain. + Pass-through header stored with the media and returned when the media is + retrieved by the user. Does not affect internal server caching behavior. example: no-cache schema: type: string diff --git a/docs/MediaApi.md b/docs/MediaApi.md index 8cd6b0d1..cac26075 100644 --- a/docs/MediaApi.md +++ b/docs/MediaApi.md @@ -261,7 +261,7 @@ public class Example { Upload Media -Upload a file. You may add headers to the request in order to provide some control to your media file. If a file is uploaded with the same name as a file that already exists under this account, the previous file will be overwritten. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). +Upload a file. Filename should always be unique. Reusing filenames may result in the wrong media being sent. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). ### Example ```java @@ -292,7 +292,7 @@ public class Example { String mediaId = "bw.png"; // String | The ID of the media file. File body = new File("/path/to/file"); // File | String contentType = "audio/wav"; // String | The media type of the entity-body. - String cacheControl = "no-cache"; // String | General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. + String cacheControl = "no-cache"; // String | Pass-through header stored with the media and returned when the media is retrieved by the user. Does not affect internal server caching behavior. try { apiInstance.uploadMedia(accountId, mediaId, body, contentType, cacheControl); } catch (ApiException e) { @@ -314,7 +314,7 @@ public class Example { | **mediaId** | **String**| The ID of the media file. | | | **body** | **File**| | | | **contentType** | **String**| The media type of the entity-body. | [optional] | -| **cacheControl** | **String**| General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. | [optional] | +| **cacheControl** | **String**| Pass-through header stored with the media and returned when the media is retrieved by the user. Does not affect internal server caching behavior. | [optional] | ### Return type diff --git a/docs/TfvSubmissionInfo.md b/docs/TfvSubmissionInfo.md index 5f83add9..b7ec8056 100644 --- a/docs/TfvSubmissionInfo.md +++ b/docs/TfvSubmissionInfo.md @@ -19,9 +19,9 @@ |**privacyPolicyUrl** | **String** | The Toll-Free Verification request privacy policy URL. | [optional] | |**termsAndConditionsUrl** | **String** | The Toll-Free Verification request terms and conditions policy URL. | [optional] | |**businessDba** | **String** | The company 'Doing Business As'. | [optional] | -|**businessRegistrationNumber** | **String** | Government-issued business identifying number. **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** | [optional] | +|**businessRegistrationNumber** | **String** | Government-issued business identifying number. **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** | [optional] | |**businessRegistrationType** | **BusinessRegistrationTypeEnum** | | [optional] | -|**businessRegistrationIssuingCountry** | **String** | The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | | [optional] | +|**businessRegistrationIssuingCountry** | **String** | The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | | [optional] | |**businessEntityType** | **BusinessEntityTypeEnum** | | [optional] | diff --git a/docs/TollFreeVerificationApi.md b/docs/TollFreeVerificationApi.md index b0e000f7..1b9f42ec 100644 --- a/docs/TollFreeVerificationApi.md +++ b/docs/TollFreeVerificationApi.md @@ -103,7 +103,7 @@ public class Example { Delete a Toll-Free Verification Submission -Delete a toll-free verification submission for a toll-free number. +Delete a toll-free verification submission for a toll-free number. **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, it will be cancelled and the submission will then be deleted asynchronously. ### Example ```java @@ -502,7 +502,7 @@ public class Example { Request Toll-Free Verification -Submit a request for verification of a toll-free phone number. +Submit a request for verification of a toll-free phone number. **Upcoming change (effective January 2027):** If any phone number in the request already has a verification in progress, the request will be rejected with a `409 Conflict`. This check is all-or-nothing: if a single phone number conflicts, the entire request is rejected and **none** of the phone numbers in the request are submitted. Today, these requests are accepted with a `202`. ### Example ```java @@ -572,6 +572,7 @@ null (empty response body) | **401** | Unauthorized | - | | **403** | Forbidden | - | | **405** | Method Not Allowed | - | +| **409** | Conflict. A toll-free verification for the phone number is already in progress. | - | | **429** | Too Many Requests | - | | **500** | Internal Server Error | - | | **503** | Service Unavailable | - | @@ -582,7 +583,7 @@ null (empty response body) Update Toll-Free Verification Request -Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). +Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). Returns a `404` if no verification request exists for the phone number, and a `400` if the existing request is not eligible for resubmission. **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, the update will be rejected with a `409 Conflict`. ### Example ```java @@ -653,7 +654,9 @@ null (empty response body) | **400** | Bad Request | - | | **401** | Unauthorized | - | | **403** | Forbidden | - | +| **404** | Cannot find the requested resource. | - | | **405** | Method Not Allowed | - | +| **409** | Conflict. A toll-free verification for the phone number is already in progress. | - | | **429** | Too Many Requests | - | | **500** | Internal Server Error | - | | **503** | Service Unavailable | - | diff --git a/docs/VerificationRequest.md b/docs/VerificationRequest.md index 172598b3..398184c9 100644 --- a/docs/VerificationRequest.md +++ b/docs/VerificationRequest.md @@ -20,9 +20,9 @@ |**privacyPolicyUrl** | **String** | The Toll-Free Verification request privacy policy URL. | [optional] | |**termsAndConditionsUrl** | **String** | The Toll-Free Verification request terms and conditions policy URL. | [optional] | |**businessDba** | **String** | The company 'Doing Business As'. | [optional] | -|**businessRegistrationNumber** | **String** | Government-issued business identifying number. **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** | [optional] | +|**businessRegistrationNumber** | **String** | Government-issued business identifying number. **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** | [optional] | |**businessRegistrationType** | **BusinessRegistrationTypeEnum** | | [optional] | -|**businessRegistrationIssuingCountry** | **String** | The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | | [optional] | +|**businessRegistrationIssuingCountry** | **String** | The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | | [optional] | |**businessEntityType** | **BusinessEntityTypeEnum** | | | |**helpMessageResponse** | **String** | A message that gets sent to users requesting help. | [optional] | |**ageGatedContent** | **Boolean** | Indicates whether the content is age-gated. | [optional] | diff --git a/docs/VerificationUpdateRequest.md b/docs/VerificationUpdateRequest.md index 5e588e93..0744ae09 100644 --- a/docs/VerificationUpdateRequest.md +++ b/docs/VerificationUpdateRequest.md @@ -19,10 +19,10 @@ |**privacyPolicyUrl** | **String** | The Toll-Free Verification request privacy policy URL. | [optional] | |**termsAndConditionsUrl** | **String** | The Toll-Free Verification request terms and conditions policy URL. | [optional] | |**businessDba** | **String** | The company 'Doing Business As'. | [optional] | -|**businessRegistrationNumber** | **String** | Government-issued business identifying number. **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** | [optional] | +|**businessRegistrationNumber** | **String** | Government-issued business identifying number. **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** | [optional] | |**businessRegistrationType** | **BusinessRegistrationTypeEnum** | | [optional] | -|**businessEntityType** | **BusinessEntityTypeEnum** | | [optional] | -|**businessRegistrationIssuingCountry** | **String** | The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | | [optional] | +|**businessEntityType** | **BusinessEntityTypeEnum** | | | +|**businessRegistrationIssuingCountry** | **String** | The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | | [optional] | |**helpMessageResponse** | **String** | A message that gets sent to users requesting help. | [optional] | |**ageGatedContent** | **Boolean** | Indicates whether the content is age-gated. | [optional] | |**cvToken** | **String** | The token provided by Campaign Verify to validate your political use case. Only required for 527 political organizations. If you are not a 527 political organization, this field should be omitted. Supplying an empty string will likely result in rejection. | [optional] | diff --git a/src/main/java/com/bandwidth/sdk/api/MediaApi.java b/src/main/java/com/bandwidth/sdk/api/MediaApi.java index f9ec25ff..f6742799 100644 --- a/src/main/java/com/bandwidth/sdk/api/MediaApi.java +++ b/src/main/java/com/bandwidth/sdk/api/MediaApi.java @@ -583,7 +583,7 @@ public okhttp3.Call listMediaAsync(@javax.annotation.Nonnull String accountId, @ * @param mediaId The ID of the media file. (required) * @param body (required) * @param contentType The media type of the entity-body. (optional) - * @param cacheControl General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. (optional) + * @param cacheControl Pass-through header stored with the media and returned when the media is retrieved by the user. Does not affect internal server caching behavior. (optional) * @param _callback Callback for upload/download progress * @return Call to execute * @throws ApiException If fail to serialize the request body object @@ -729,12 +729,12 @@ private okhttp3.Call uploadMediaValidateBeforeCall(@javax.annotation.Nonnull Str /** * Upload Media - * Upload a file. You may add headers to the request in order to provide some control to your media file. If a file is uploaded with the same name as a file that already exists under this account, the previous file will be overwritten. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). + * Upload a file. Filename should always be unique. Reusing filenames may result in the wrong media being sent. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). * @param accountId This is your 7-digit Bandwidth Account ID, as shown in the Bandwidth App. The older ID format (`u-be8dvafwrs63rwpm7pfil4b`) is deprecated. **When migrating to OAuth authentication, you must use the 7-digit Account ID.** (required) * @param mediaId The ID of the media file. (required) * @param body (required) * @param contentType The media type of the entity-body. (optional) - * @param cacheControl General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. (optional) + * @param cacheControl Pass-through header stored with the media and returned when the media is retrieved by the user. Does not affect internal server caching behavior. (optional) * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body * @http.response.details @@ -757,12 +757,12 @@ public void uploadMedia(@javax.annotation.Nonnull String accountId, @javax.annot /** * Upload Media - * Upload a file. You may add headers to the request in order to provide some control to your media file. If a file is uploaded with the same name as a file that already exists under this account, the previous file will be overwritten. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). + * Upload a file. Filename should always be unique. Reusing filenames may result in the wrong media being sent. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). * @param accountId This is your 7-digit Bandwidth Account ID, as shown in the Bandwidth App. The older ID format (`u-be8dvafwrs63rwpm7pfil4b`) is deprecated. **When migrating to OAuth authentication, you must use the 7-digit Account ID.** (required) * @param mediaId The ID of the media file. (required) * @param body (required) * @param contentType The media type of the entity-body. (optional) - * @param cacheControl General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. (optional) + * @param cacheControl Pass-through header stored with the media and returned when the media is retrieved by the user. Does not affect internal server caching behavior. (optional) * @return ApiResponse<Void> * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body * @http.response.details @@ -787,12 +787,12 @@ public ApiResponse uploadMediaWithHttpInfo(@javax.annotation.Nonnull Strin /** * Upload Media (asynchronously) - * Upload a file. You may add headers to the request in order to provide some control to your media file. If a file is uploaded with the same name as a file that already exists under this account, the previous file will be overwritten. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). + * Upload a file. Filename should always be unique. Reusing filenames may result in the wrong media being sent. A list of supported media types can be found at [Bandwidth Support](https://www.bandwidth.com/support/en/articles/12823220-what-mms-file-types-are-supported). * @param accountId This is your 7-digit Bandwidth Account ID, as shown in the Bandwidth App. The older ID format (`u-be8dvafwrs63rwpm7pfil4b`) is deprecated. **When migrating to OAuth authentication, you must use the 7-digit Account ID.** (required) * @param mediaId The ID of the media file. (required) * @param body (required) * @param contentType The media type of the entity-body. (optional) - * @param cacheControl General-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain. (optional) + * @param cacheControl Pass-through header stored with the media and returned when the media is retrieved by the user. Does not affect internal server caching behavior. (optional) * @param _callback The callback to be executed when the API call finishes * @return The request call * @throws ApiException If fail to process the API call, e.g. serializing the request body object diff --git a/src/main/java/com/bandwidth/sdk/api/TollFreeVerificationApi.java b/src/main/java/com/bandwidth/sdk/api/TollFreeVerificationApi.java index df41729d..2b17a636 100644 --- a/src/main/java/com/bandwidth/sdk/api/TollFreeVerificationApi.java +++ b/src/main/java/com/bandwidth/sdk/api/TollFreeVerificationApi.java @@ -333,7 +333,7 @@ private okhttp3.Call deleteVerificationRequestValidateBeforeCall(@javax.annotati /** * Delete a Toll-Free Verification Submission - * Delete a toll-free verification submission for a toll-free number. + * Delete a toll-free verification submission for a toll-free number. **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, it will be cancelled and the submission will then be deleted asynchronously. * @param accountId Your Bandwidth Account ID. (required) * @param phoneNumber Valid Toll-Free telephone number in E.164 format. (required) * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body @@ -358,7 +358,7 @@ public void deleteVerificationRequest(@javax.annotation.Nonnull String accountId /** * Delete a Toll-Free Verification Submission - * Delete a toll-free verification submission for a toll-free number. + * Delete a toll-free verification submission for a toll-free number. **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, it will be cancelled and the submission will then be deleted asynchronously. * @param accountId Your Bandwidth Account ID. (required) * @param phoneNumber Valid Toll-Free telephone number in E.164 format. (required) * @return ApiResponse<Void> @@ -385,7 +385,7 @@ public ApiResponse deleteVerificationRequestWithHttpInfo(@javax.annotation /** * Delete a Toll-Free Verification Submission (asynchronously) - * Delete a toll-free verification submission for a toll-free number. + * Delete a toll-free verification submission for a toll-free number. **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, it will be cancelled and the submission will then be deleted asynchronously. * @param accountId Your Bandwidth Account ID. (required) * @param phoneNumber Valid Toll-Free telephone number in E.164 format. (required) * @param _callback The callback to be executed when the API call finishes @@ -1066,6 +1066,7 @@ public okhttp3.Call listWebhookSubscriptionsAsync(@javax.annotation.Nonnull Stri + @@ -1135,7 +1136,7 @@ private okhttp3.Call requestTollFreeVerificationValidateBeforeCall(@javax.annota /** * Request Toll-Free Verification - * Submit a request for verification of a toll-free phone number. + * Submit a request for verification of a toll-free phone number. **Upcoming change (effective January 2027):** If any phone number in the request already has a verification in progress, the request will be rejected with a `409 Conflict`. This check is all-or-nothing: if a single phone number conflicts, the entire request is rejected and **none** of the phone numbers in the request are submitted. Today, these requests are accepted with a `202`. * @param accountId Your Bandwidth Account ID. (required) * @param verificationRequest Request for verification of a toll-free phone number. (required) * @throws ApiException If fail to call the API, e.g. server error or cannot deserialize the response body @@ -1148,6 +1149,7 @@ private okhttp3.Call requestTollFreeVerificationValidateBeforeCall(@javax.annota + @@ -1159,7 +1161,7 @@ public void requestTollFreeVerification(@javax.annotation.Nonnull String account /** * Request Toll-Free Verification - * Submit a request for verification of a toll-free phone number. + * Submit a request for verification of a toll-free phone number. **Upcoming change (effective January 2027):** If any phone number in the request already has a verification in progress, the request will be rejected with a `409 Conflict`. This check is all-or-nothing: if a single phone number conflicts, the entire request is rejected and **none** of the phone numbers in the request are submitted. Today, these requests are accepted with a `202`. * @param accountId Your Bandwidth Account ID. (required) * @param verificationRequest Request for verification of a toll-free phone number. (required) * @return ApiResponse<Void> @@ -1173,6 +1175,7 @@ public void requestTollFreeVerification(@javax.annotation.Nonnull String account + @@ -1185,7 +1188,7 @@ public ApiResponse requestTollFreeVerificationWithHttpInfo(@javax.annotati /** * Request Toll-Free Verification (asynchronously) - * Submit a request for verification of a toll-free phone number. + * Submit a request for verification of a toll-free phone number. **Upcoming change (effective January 2027):** If any phone number in the request already has a verification in progress, the request will be rejected with a `409 Conflict`. This check is all-or-nothing: if a single phone number conflicts, the entire request is rejected and **none** of the phone numbers in the request are submitted. Today, these requests are accepted with a `202`. * @param accountId Your Bandwidth Account ID. (required) * @param verificationRequest Request for verification of a toll-free phone number. (required) * @param _callback The callback to be executed when the API call finishes @@ -1200,6 +1203,7 @@ public ApiResponse requestTollFreeVerificationWithHttpInfo(@javax.annotati + @@ -1227,7 +1231,9 @@ public okhttp3.Call requestTollFreeVerificationAsync(@javax.annotation.Nonnull S + + @@ -1303,7 +1309,7 @@ private okhttp3.Call updateTollFreeVerificationRequestValidateBeforeCall(@javax. /** * Update Toll-Free Verification Request - * Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). + * Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). Returns a `404` if no verification request exists for the phone number, and a `400` if the existing request is not eligible for resubmission. **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, the update will be rejected with a `409 Conflict`. * @param accountId Your Bandwidth Account ID. (required) * @param phoneNumber Valid Toll-Free telephone number in E.164 format. (required) * @param tfvSubmissionWrapper Update a request for verification of a toll-free phone number. (required) @@ -1316,7 +1322,9 @@ private okhttp3.Call updateTollFreeVerificationRequestValidateBeforeCall(@javax. + + @@ -1328,7 +1336,7 @@ public void updateTollFreeVerificationRequest(@javax.annotation.Nonnull String a /** * Update Toll-Free Verification Request - * Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). + * Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). Returns a `404` if no verification request exists for the phone number, and a `400` if the existing request is not eligible for resubmission. **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, the update will be rejected with a `409 Conflict`. * @param accountId Your Bandwidth Account ID. (required) * @param phoneNumber Valid Toll-Free telephone number in E.164 format. (required) * @param tfvSubmissionWrapper Update a request for verification of a toll-free phone number. (required) @@ -1342,7 +1350,9 @@ public void updateTollFreeVerificationRequest(@javax.annotation.Nonnull String a + + @@ -1355,7 +1365,7 @@ public ApiResponse updateTollFreeVerificationRequestWithHttpInfo(@javax.an /** * Update Toll-Free Verification Request (asynchronously) - * Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). + * Updates a toll-free verification request. Submissions are only eligible for resubmission for 7 days within being processed and if resubmission is allowed (resubmitAllowed field is true). Returns a `404` if no verification request exists for the phone number, and a `400` if the existing request is not eligible for resubmission. **Upcoming change (effective January 2027):** If a verification for the phone number is in progress, the update will be rejected with a `409 Conflict`. * @param accountId Your Bandwidth Account ID. (required) * @param phoneNumber Valid Toll-Free telephone number in E.164 format. (required) * @param tfvSubmissionWrapper Update a request for verification of a toll-free phone number. (required) @@ -1370,7 +1380,9 @@ public ApiResponse updateTollFreeVerificationRequestWithHttpInfo(@javax.an + + diff --git a/src/main/java/com/bandwidth/sdk/model/BusinessEntityTypeEnum.java b/src/main/java/com/bandwidth/sdk/model/BusinessEntityTypeEnum.java index 6986ac5c..eb8255f3 100644 --- a/src/main/java/com/bandwidth/sdk/model/BusinessEntityTypeEnum.java +++ b/src/main/java/com/bandwidth/sdk/model/BusinessEntityTypeEnum.java @@ -24,7 +24,7 @@ import com.google.gson.stream.JsonWriter; /** - * The type of registered business. **Note: As of October 19th, 2026 submissions using a value other than `SOLE_PROPRIETOR` must provide a value for `businessRegistrationNumber`, `businessRegistrationType`, and `businessRegistrationIssuingCountry`. Submissions using `SOLE_PROPRIETOR` must _omit_ `businessRegistrationNumber`, `businessRegistrationType`, and `businessRegistrationIssuingCountry`. Failure to adhere to these constraints will result in a 400 Bad Request rejection.** + * The type of registered business. **Submissions using a value other than `SOLE_PROPRIETOR` must provide a value for `businessRegistrationNumber`, `businessRegistrationType`, and `businessRegistrationIssuingCountry`. Submissions using `SOLE_PROPRIETOR` must _omit_ `businessRegistrationNumber`, `businessRegistrationType`, and `businessRegistrationIssuingCountry`. Failure to adhere to these constraints will result in a 400 Bad Request rejection.** */ @JsonAdapter(BusinessEntityTypeEnum.Adapter.class) public enum BusinessEntityTypeEnum { diff --git a/src/main/java/com/bandwidth/sdk/model/BusinessRegistrationTypeEnum.java b/src/main/java/com/bandwidth/sdk/model/BusinessRegistrationTypeEnum.java index 638a531e..a7657b80 100644 --- a/src/main/java/com/bandwidth/sdk/model/BusinessRegistrationTypeEnum.java +++ b/src/main/java/com/bandwidth/sdk/model/BusinessRegistrationTypeEnum.java @@ -24,7 +24,7 @@ import com.google.gson.stream.JsonWriter; /** - * The type of business registration number. **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** + * The type of business registration number. **This field is required when `businessRegistrationNumber` is provided.** */ @JsonAdapter(BusinessRegistrationTypeEnum.Adapter.class) public enum BusinessRegistrationTypeEnum { diff --git a/src/main/java/com/bandwidth/sdk/model/TfvSubmissionInfo.java b/src/main/java/com/bandwidth/sdk/model/TfvSubmissionInfo.java index ab43697b..166de6dc 100644 --- a/src/main/java/com/bandwidth/sdk/model/TfvSubmissionInfo.java +++ b/src/main/java/com/bandwidth/sdk/model/TfvSubmissionInfo.java @@ -375,7 +375,7 @@ public TfvSubmissionInfo businessRegistrationNumber(@javax.annotation.Nullable S } /** - * Government-issued business identifying number. **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** + * Government-issued business identifying number. **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** * @return businessRegistrationNumber */ @javax.annotation.Nullable @@ -413,7 +413,7 @@ public TfvSubmissionInfo businessRegistrationIssuingCountry(@javax.annotation.Nu } /** - * The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | + * The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | * @return businessRegistrationIssuingCountry */ @javax.annotation.Nullable diff --git a/src/main/java/com/bandwidth/sdk/model/VerificationRequest.java b/src/main/java/com/bandwidth/sdk/model/VerificationRequest.java index aede26e3..b1b71ada 100644 --- a/src/main/java/com/bandwidth/sdk/model/VerificationRequest.java +++ b/src/main/java/com/bandwidth/sdk/model/VerificationRequest.java @@ -424,7 +424,7 @@ public VerificationRequest businessRegistrationNumber(@javax.annotation.Nullable } /** - * Government-issued business identifying number. **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** + * Government-issued business identifying number. **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** * @return businessRegistrationNumber */ @javax.annotation.Nullable @@ -462,7 +462,7 @@ public VerificationRequest businessRegistrationIssuingCountry(@javax.annotation. } /** - * The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | + * The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | * @return businessRegistrationIssuingCountry */ @javax.annotation.Nullable diff --git a/src/main/java/com/bandwidth/sdk/model/VerificationUpdateRequest.java b/src/main/java/com/bandwidth/sdk/model/VerificationUpdateRequest.java index 12c2d754..173d9c82 100644 --- a/src/main/java/com/bandwidth/sdk/model/VerificationUpdateRequest.java +++ b/src/main/java/com/bandwidth/sdk/model/VerificationUpdateRequest.java @@ -128,7 +128,7 @@ public class VerificationUpdateRequest { public static final String SERIALIZED_NAME_BUSINESS_ENTITY_TYPE = "businessEntityType"; @SerializedName(SERIALIZED_NAME_BUSINESS_ENTITY_TYPE) - @javax.annotation.Nullable + @javax.annotation.Nonnull private BusinessEntityTypeEnum businessEntityType; public static final String SERIALIZED_NAME_BUSINESS_REGISTRATION_ISSUING_COUNTRY = "businessRegistrationIssuingCountry"; @@ -390,7 +390,7 @@ public VerificationUpdateRequest businessRegistrationNumber(@javax.annotation.Nu } /** - * Government-issued business identifying number. **Note: As of October 19th, 2026 this field will be required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** + * Government-issued business identifying number. **This field is required when `businessEntityType` is _not_ `SOLE_PROPRIETOR`. If this field is provided, `businessRegistrationType` and `businessRegistrationIssuingCountry` are also required.** * @return businessRegistrationNumber */ @javax.annotation.Nullable @@ -422,7 +422,7 @@ public void setBusinessRegistrationType(@javax.annotation.Nullable BusinessRegis } - public VerificationUpdateRequest businessEntityType(@javax.annotation.Nullable BusinessEntityTypeEnum businessEntityType) { + public VerificationUpdateRequest businessEntityType(@javax.annotation.Nonnull BusinessEntityTypeEnum businessEntityType) { this.businessEntityType = businessEntityType; return this; } @@ -431,12 +431,12 @@ public VerificationUpdateRequest businessEntityType(@javax.annotation.Nullable B * Get businessEntityType * @return businessEntityType */ - @javax.annotation.Nullable + @javax.annotation.Nonnull public BusinessEntityTypeEnum getBusinessEntityType() { return businessEntityType; } - public void setBusinessEntityType(@javax.annotation.Nullable BusinessEntityTypeEnum businessEntityType) { + public void setBusinessEntityType(@javax.annotation.Nonnull BusinessEntityTypeEnum businessEntityType) { this.businessEntityType = businessEntityType; } @@ -447,7 +447,7 @@ public VerificationUpdateRequest businessRegistrationIssuingCountry(@javax.annot } /** - * The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **Note: As of October 19th, 2026 this field will be required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | + * The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 format is accepted by the API, but alpha-3 is highly encouraged. **This field is required when `businessRegistrationNumber` is provided.** | Registration Type | Supported Countries | |----------------------|------------------------------------| | EIN | USA | | CBN | CAN | | NEQ | CAN | | PROVINCIAL_NUMBER | CAN | | CRN | GBR, HKG | | VAT | GBR, IRL, BRA, NLD | | ACN | AUS | | ABN | AUS | | BRN | HKG | | SIREN | FRA | | SIRET | FRA | | NZBN | NZL | | UST_IDNR | DEU | | CIF | ESP | | NIF | ESP | | CNPJ | BRA | | UID | CHE | | OTHER | Must Provide Country Code | * @return businessRegistrationIssuingCountry */ @javax.annotation.Nullable @@ -654,7 +654,7 @@ private String toIndentedString(Object o) { openapiFields = new HashSet(Arrays.asList("businessAddress", "businessContact", "messageVolume", "useCase", "useCaseSummary", "productionMessageContent", "optInWorkflow", "additionalInformation", "isvReseller", "privacyPolicyUrl", "termsAndConditionsUrl", "businessDba", "businessRegistrationNumber", "businessRegistrationType", "businessEntityType", "businessRegistrationIssuingCountry", "helpMessageResponse", "ageGatedContent", "cvToken")); // a set of required properties/fields (JSON key names) - openapiRequiredFields = new HashSet(Arrays.asList("businessAddress", "businessContact", "messageVolume", "useCase", "useCaseSummary", "productionMessageContent", "optInWorkflow")); + openapiRequiredFields = new HashSet(Arrays.asList("businessAddress", "businessContact", "messageVolume", "useCase", "useCaseSummary", "productionMessageContent", "optInWorkflow", "businessEntityType")); } /** @@ -714,10 +714,8 @@ public static void validateJsonElement(JsonElement jsonElement) throws IOExcepti if (jsonObj.get("businessRegistrationType") != null && !jsonObj.get("businessRegistrationType").isJsonNull()) { BusinessRegistrationTypeEnum.validateJsonElement(jsonObj.get("businessRegistrationType")); } - // validate the optional field `businessEntityType` - if (jsonObj.get("businessEntityType") != null && !jsonObj.get("businessEntityType").isJsonNull()) { - BusinessEntityTypeEnum.validateJsonElement(jsonObj.get("businessEntityType")); - } + // validate the required field `businessEntityType` + BusinessEntityTypeEnum.validateJsonElement(jsonObj.get("businessEntityType")); if ((jsonObj.get("businessRegistrationIssuingCountry") != null && !jsonObj.get("businessRegistrationIssuingCountry").isJsonNull()) && !jsonObj.get("businessRegistrationIssuingCountry").isJsonPrimitive()) { throw new IllegalArgumentException(String.format(java.util.Locale.ROOT, "Expected the field `businessRegistrationIssuingCountry` to be a primitive type in the JSON string but got `%s`", jsonObj.get("businessRegistrationIssuingCountry").toString())); }
401 Unauthorized -
403 Forbidden -
405 Method Not Allowed -
409 Conflict. A toll-free verification for the phone number is already in progress. -
429 Too Many Requests -
500 Internal Server Error -
503 Service Unavailable -
401 Unauthorized -
403 Forbidden -
405 Method Not Allowed -
409 Conflict. A toll-free verification for the phone number is already in progress. -
429 Too Many Requests -
500 Internal Server Error -
503 Service Unavailable -
401 Unauthorized -
403 Forbidden -
405 Method Not Allowed -
409 Conflict. A toll-free verification for the phone number is already in progress. -
429 Too Many Requests -
500 Internal Server Error -
503 Service Unavailable -
401 Unauthorized -
403 Forbidden -
405 Method Not Allowed -
409 Conflict. A toll-free verification for the phone number is already in progress. -
429 Too Many Requests -
500 Internal Server Error -
503 Service Unavailable -
400 Bad Request -
401 Unauthorized -
403 Forbidden -
404 Cannot find the requested resource. -
405 Method Not Allowed -
409 Conflict. A toll-free verification for the phone number is already in progress. -
429 Too Many Requests -
500 Internal Server Error -
503 Service Unavailable -
400 Bad Request -
401 Unauthorized -
403 Forbidden -
404 Cannot find the requested resource. -
405 Method Not Allowed -
409 Conflict. A toll-free verification for the phone number is already in progress. -
429 Too Many Requests -
500 Internal Server Error -
503 Service Unavailable -
400 Bad Request -
401 Unauthorized -
403 Forbidden -
404 Cannot find the requested resource. -
405 Method Not Allowed -
409 Conflict. A toll-free verification for the phone number is already in progress. -
429 Too Many Requests -
500 Internal Server Error -
503 Service Unavailable -
400 Bad Request -
401 Unauthorized -
403 Forbidden -
404 Cannot find the requested resource. -
405 Method Not Allowed -
409 Conflict. A toll-free verification for the phone number is already in progress. -
429 Too Many Requests -
500 Internal Server Error -
503 Service Unavailable -