Improvements to BulkSendJob response; reduces nullability, sets defaults

openapi-raw.yaml

@@ -9915,11 +9915,15 @@ components:
       x-internal-class: true
     BulkSendJobResponse:
       description: '_t__BulkSendJobResponse::DESCRIPTION'
+      required:
+        - bulk_send_job_id
+        - created_at
+        - is_creator
+        - total
       properties:
         bulk_send_job_id:
           description: '_t__BulkSendJobResponse::BULK_SEND_JOB_ID'
           type: string
-          nullable: true
         total:
           description: '_t__BulkSendJobResponse::TOTAL'
           type: integer

openapi-sdk.yaml

@@ -10523,11 +10523,15 @@ components:
       x-internal-class: true
     BulkSendJobResponse:
       description: 'Contains information about the BulkSendJob such as when it was created and how many signature requests are queued.'
+      required:
+        - bulk_send_job_id
+        - created_at
+        - is_creator
+        - total
       properties:
         bulk_send_job_id:
           description: 'The id of the BulkSendJob.'
           type: string
-          nullable: true
         total:
           description: 'The total amount of Signature Requests queued for sending.'
           type: integer

openapi.yaml

@@ -10501,11 +10501,15 @@ components:
       x-internal-class: true
     BulkSendJobResponse:
       description: 'Contains information about the BulkSendJob such as when it was created and how many signature requests are queued.'
+      required:
+        - bulk_send_job_id
+        - created_at
+        - is_creator
+        - total
       properties:
         bulk_send_job_id:
           description: 'The id of the BulkSendJob.'
           type: string
-          nullable: true
         total:
           description: 'The total amount of Signature Requests queued for sending.'
           type: integer

sdks/dotnet/docs/BulkSendJobResponse.md

@@ -5,7 +5,7 @@ Contains information about the BulkSendJob such as when it was created and how m
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**BulkSendJobId** | **string** |  The id of the BulkSendJob.  | [optional] **Total** | **int** |  The total amount of Signature Requests queued for sending.  | [optional] **IsCreator** | **bool** |  True if you are the owner of this BulkSendJob, false if it's been shared with you by a team member.  | [optional] **CreatedAt** | **int** |  Time that the BulkSendJob was created.  | [optional] 
+**BulkSendJobId** | **string** |  The id of the BulkSendJob.  | **Total** | **int** |  The total amount of Signature Requests queued for sending.  | **IsCreator** | **bool** |  True if you are the owner of this BulkSendJob, false if it's been shared with you by a team member.  | **CreatedAt** | **int** |  Time that the BulkSendJob was created.  | 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

sdks/dotnet/src/Dropbox.Sign/Model/BulkSendJobResponse.cs

@@ -41,13 +41,18 @@ protected BulkSendJobResponse() { }
         /// <summary>
         /// Initializes a new instance of the <see cref="BulkSendJobResponse" /> class.
         /// </summary>
-        /// <param name="bulkSendJobId">The id of the BulkSendJob..</param>
-        /// <param name="total">The total amount of Signature Requests queued for sending..</param>
-        /// <param name="isCreator">True if you are the owner of this BulkSendJob, false if it&#39;s been shared with you by a team member..</param>
-        /// <param name="createdAt">Time that the BulkSendJob was created..</param>
+        /// <param name="bulkSendJobId">The id of the BulkSendJob. (required).</param>
+        /// <param name="total">The total amount of Signature Requests queued for sending. (required).</param>
+        /// <param name="isCreator">True if you are the owner of this BulkSendJob, false if it&#39;s been shared with you by a team member. (required).</param>
+        /// <param name="createdAt">Time that the BulkSendJob was created. (required).</param>
         public BulkSendJobResponse(string bulkSendJobId = default(string), int total = default(int), bool isCreator = default(bool), int createdAt = default(int))
         {
 
+            // to ensure "bulkSendJobId" is required (not null)
+            if (bulkSendJobId == null)
+            {
+                throw new ArgumentNullException("bulkSendJobId is a required property for BulkSendJobResponse and cannot be null");
+            }
             this.BulkSendJobId = bulkSendJobId;
             this.Total = total;
             this.IsCreator = isCreator;
@@ -74,28 +79,28 @@ public static BulkSendJobResponse Init(string jsonData)
         /// The id of the BulkSendJob.
         /// </summary>
         /// <value>The id of the BulkSendJob.</value>
-        [DataMember(Name = "bulk_send_job_id", EmitDefaultValue = true)]
+        [DataMember(Name = "bulk_send_job_id", IsRequired = true, EmitDefaultValue = true)]
         public string BulkSendJobId { get; set; }
 
         /// <summary>
         /// The total amount of Signature Requests queued for sending.
         /// </summary>
         /// <value>The total amount of Signature Requests queued for sending.</value>
-        [DataMember(Name = "total", EmitDefaultValue = true)]
+        [DataMember(Name = "total", IsRequired = true, EmitDefaultValue = true)]
         public int Total { get; set; }
 
         /// <summary>
         /// True if you are the owner of this BulkSendJob, false if it&#39;s been shared with you by a team member.
         /// </summary>
         /// <value>True if you are the owner of this BulkSendJob, false if it&#39;s been shared with you by a team member.</value>
-        [DataMember(Name = "is_creator", EmitDefaultValue = true)]
+        [DataMember(Name = "is_creator", IsRequired = true, EmitDefaultValue = true)]
         public bool IsCreator { get; set; }
 
         /// <summary>
         /// Time that the BulkSendJob was created.
         /// </summary>
         /// <value>Time that the BulkSendJob was created.</value>
-        [DataMember(Name = "created_at", EmitDefaultValue = true)]
+        [DataMember(Name = "created_at", IsRequired = true, EmitDefaultValue = true)]
         public int CreatedAt { get; set; }
 
         /// <summary>

sdks/java-v1/docs/BulkSendJobResponse.md

@@ -8,10 +8,10 @@ Contains information about the BulkSendJob such as when it was created and how m
 
 | Name | Type | Description | Notes |
 |------------ | ------------- | ------------- | -------------|
-| `bulkSendJobId` | ```String``` |  The id of the BulkSendJob.  |  |
-| `total` | ```Integer``` |  The total amount of Signature Requests queued for sending.  |  |
-| `isCreator` | ```Boolean``` |  True if you are the owner of this BulkSendJob, false if it's been shared with you by a team member.  |  |
-| `createdAt` | ```Integer``` |  Time that the BulkSendJob was created.  |  |
+| `bulkSendJobId`<sup>*_required_</sup> | ```String``` |  The id of the BulkSendJob.  |  |
+| `total`<sup>*_required_</sup> | ```Integer``` |  The total amount of Signature Requests queued for sending.  |  |
+| `isCreator`<sup>*_required_</sup> | ```Boolean``` |  True if you are the owner of this BulkSendJob, false if it&#39;s been shared with you by a team member.  |  |
+| `createdAt`<sup>*_required_</sup> | ```Integer``` |  Time that the BulkSendJob was created.  |  |
 
 
 

sdks/java-v1/src/main/java/com/dropbox/sign/model/BulkSendJobResponse.java

@@ -76,14 +76,15 @@ public BulkSendJobResponse bulkSendJobId(String bulkSendJobId) {
      *
      * @return bulkSendJobId
      */
-    @javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_BULK_SEND_JOB_ID)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @javax.annotation.Nonnull
+    @JsonProperty(JSON_PROPERTY_BULK_SEND_JOB_ID)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public String getBulkSendJobId() {
         return bulkSendJobId;
     }
 
     @JsonProperty(JSON_PROPERTY_BULK_SEND_JOB_ID)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public void setBulkSendJobId(String bulkSendJobId) {
         this.bulkSendJobId = bulkSendJobId;
     }
@@ -98,14 +99,15 @@ public BulkSendJobResponse total(Integer total) {
      *
      * @return total
      */
-    @javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_TOTAL)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @javax.annotation.Nonnull
+    @JsonProperty(JSON_PROPERTY_TOTAL)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public Integer getTotal() {
         return total;
     }
 
     @JsonProperty(JSON_PROPERTY_TOTAL)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public void setTotal(Integer total) {
         this.total = total;
     }
@@ -121,14 +123,15 @@ public BulkSendJobResponse isCreator(Boolean isCreator) {
      *
      * @return isCreator
      */
-    @javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_IS_CREATOR)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @javax.annotation.Nonnull
+    @JsonProperty(JSON_PROPERTY_IS_CREATOR)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public Boolean getIsCreator() {
         return isCreator;
     }
 
     @JsonProperty(JSON_PROPERTY_IS_CREATOR)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public void setIsCreator(Boolean isCreator) {
         this.isCreator = isCreator;
     }
@@ -143,14 +146,15 @@ public BulkSendJobResponse createdAt(Integer createdAt) {
      *
      * @return createdAt
      */
-    @javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_CREATED_AT)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @javax.annotation.Nonnull
+    @JsonProperty(JSON_PROPERTY_CREATED_AT)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public Integer getCreatedAt() {
         return createdAt;
     }
 
     @JsonProperty(JSON_PROPERTY_CREATED_AT)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public void setCreatedAt(Integer createdAt) {
         this.createdAt = createdAt;
     }

sdks/java-v2/docs/BulkSendJobResponse.md

@@ -8,10 +8,10 @@ Contains information about the BulkSendJob such as when it was created and how m
 
 | Name | Type | Description | Notes |
 |------------ | ------------- | ------------- | -------------|
-| `bulkSendJobId` | ```String``` |  The id of the BulkSendJob.  |  |
-| `total` | ```Integer``` |  The total amount of Signature Requests queued for sending.  |  |
-| `isCreator` | ```Boolean``` |  True if you are the owner of this BulkSendJob, false if it's been shared with you by a team member.  |  |
-| `createdAt` | ```Integer``` |  Time that the BulkSendJob was created.  |  |
+| `bulkSendJobId`<sup>*_required_</sup> | ```String``` |  The id of the BulkSendJob.  |  |
+| `total`<sup>*_required_</sup> | ```Integer``` |  The total amount of Signature Requests queued for sending.  |  |
+| `isCreator`<sup>*_required_</sup> | ```Boolean``` |  True if you are the owner of this BulkSendJob, false if it&#39;s been shared with you by a team member.  |  |
+| `createdAt`<sup>*_required_</sup> | ```Integer``` |  Time that the BulkSendJob was created.  |  |
 
 
 

sdks/java-v2/src/main/java/com/dropbox/sign/model/BulkSendJobResponse.java

@@ -80,17 +80,17 @@ public BulkSendJobResponse bulkSendJobId(String bulkSendJobId) {
    * The id of the BulkSendJob.
    * @return bulkSendJobId
    */
-  @jakarta.annotation.Nullable
+  @jakarta.annotation.Nonnull
   @JsonProperty(JSON_PROPERTY_BULK_SEND_JOB_ID)
-  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
 
   public String getBulkSendJobId() {
     return bulkSendJobId;
   }
 
 
   @JsonProperty(JSON_PROPERTY_BULK_SEND_JOB_ID)
-  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
   public void setBulkSendJobId(String bulkSendJobId) {
     this.bulkSendJobId = bulkSendJobId;
   }
@@ -105,17 +105,17 @@ public BulkSendJobResponse total(Integer total) {
    * The total amount of Signature Requests queued for sending.
    * @return total
    */
-  @jakarta.annotation.Nullable
+  @jakarta.annotation.Nonnull
   @JsonProperty(JSON_PROPERTY_TOTAL)
-  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
 
   public Integer getTotal() {
     return total;
   }
 
 
   @JsonProperty(JSON_PROPERTY_TOTAL)
-  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
   public void setTotal(Integer total) {
     this.total = total;
   }
@@ -130,17 +130,17 @@ public BulkSendJobResponse isCreator(Boolean isCreator) {
    * True if you are the owner of this BulkSendJob, false if it's been shared with you by a team member.
    * @return isCreator
    */
-  @jakarta.annotation.Nullable
+  @jakarta.annotation.Nonnull
   @JsonProperty(JSON_PROPERTY_IS_CREATOR)
-  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
 
   public Boolean getIsCreator() {
     return isCreator;
   }
 
 
   @JsonProperty(JSON_PROPERTY_IS_CREATOR)
-  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
   public void setIsCreator(Boolean isCreator) {
     this.isCreator = isCreator;
   }
@@ -155,17 +155,17 @@ public BulkSendJobResponse createdAt(Integer createdAt) {
    * Time that the BulkSendJob was created.
    * @return createdAt
    */
-  @jakarta.annotation.Nullable
+  @jakarta.annotation.Nonnull
   @JsonProperty(JSON_PROPERTY_CREATED_AT)
-  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
 
   public Integer getCreatedAt() {
     return createdAt;
   }
 
 
   @JsonProperty(JSON_PROPERTY_CREATED_AT)
-  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  @JsonInclude(value = JsonInclude.Include.ALWAYS)
   public void setCreatedAt(Integer createdAt) {
     this.createdAt = createdAt;
   }

sdks/node/docs/model/BulkSendJobResponse.md

@@ -6,9 +6,9 @@ Contains information about the BulkSendJob such as when it was created and how m
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-| `bulkSendJobId` | ```string``` |  The id of the BulkSendJob.  |  |
-| `total` | ```number``` |  The total amount of Signature Requests queued for sending.  |  |
-| `isCreator` | ```boolean``` |  True if you are the owner of this BulkSendJob, false if it's been shared with you by a team member.  |  |
-| `createdAt` | ```number``` |  Time that the BulkSendJob was created.  |  |
+| `bulkSendJobId`<sup>*_required_</sup> | ```string``` |  The id of the BulkSendJob.  |  |
+| `total`<sup>*_required_</sup> | ```number``` |  The total amount of Signature Requests queued for sending.  |  |
+| `isCreator`<sup>*_required_</sup> | ```boolean``` |  True if you are the owner of this BulkSendJob, false if it&#39;s been shared with you by a team member.  |  |
+| `createdAt`<sup>*_required_</sup> | ```number``` |  Time that the BulkSendJob was created.  |  |
 
 [[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)

sdks/node/model/bulkSendJobResponse.ts

@@ -31,19 +31,19 @@ export class BulkSendJobResponse {
   /**
    * The id of the BulkSendJob.
    */
-  "bulkSendJobId"?: string | null;
+  "bulkSendJobId": string;
   /**
    * The total amount of Signature Requests queued for sending.
    */
-  "total"?: number;
+  "total": number;
   /**
    * True if you are the owner of this BulkSendJob, false if it\'s been shared with you by a team member.
    */
-  "isCreator"?: boolean;
+  "isCreator": boolean;
   /**
    * Time that the BulkSendJob was created.
    */
-  "createdAt"?: number;
+  "createdAt": number;
 
   static discriminator: string | undefined = undefined;
 

sdks/node/types/model/bulkSendJobResponse.d.ts

@@ -1,9 +1,9 @@
 import { AttributeTypeMap } from "./";
 export declare class BulkSendJobResponse {
-    "bulkSendJobId"?: string | null;
-    "total"?: number;
-    "isCreator"?: boolean;
-    "createdAt"?: number;
+    "bulkSendJobId": string;
+    "total": number;
+    "isCreator": boolean;
+    "createdAt": number;
     static discriminator: string | undefined;
     static attributeTypeMap: AttributeTypeMap;
     static getAttributeTypeMap(): AttributeTypeMap;

sdks/php/docs/Model/BulkSendJobResponse.md

@@ -6,9 +6,9 @@ Contains information about the BulkSendJob such as when it was created and how m
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-| `bulk_send_job_id` | ```string``` |  The id of the BulkSendJob.  |  |
-| `total` | ```int``` |  The total amount of Signature Requests queued for sending.  |  |
-| `is_creator` | ```bool``` |  True if you are the owner of this BulkSendJob, false if it's been shared with you by a team member.  |  |
-| `created_at` | ```int``` |  Time that the BulkSendJob was created.  |  |
+| `bulk_send_job_id`<sup>*_required_</sup> | ```string``` |  The id of the BulkSendJob.  |  |
+| `total`<sup>*_required_</sup> | ```int``` |  The total amount of Signature Requests queued for sending.  |  |
+| `is_creator`<sup>*_required_</sup> | ```bool``` |  True if you are the owner of this BulkSendJob, false if it&#39;s been shared with you by a team member.  |  |
+| `created_at`<sup>*_required_</sup> | ```int``` |  Time that the BulkSendJob was created.  |  |
 
 [[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)