Improvements to Team response; reduces nullability

examples/json/TeamAddMemberResponseExample.json

@@ -30,6 +30,10 @@
         }
       }
     ],
-    "invited_emails": []
+    "invited_emails": [
+      "invite_1@example.com",
+      "invite_2@example.com",
+      "invite_3@example.com"
+    ]
   }
 }

examples/json/TeamGetResponseExample.json

@@ -29,7 +29,24 @@
         "role_code": "m"
       }
     ],
-    "invited_accounts": [],
-    "invited_emails": []
+    "invited_accounts": [
+      {
+        "account_id": "8e239b5a50eac117fdd9a0e2359620aa57cb2463",
+        "email_address": "george@hellofax.com",
+        "is_locked": false,
+        "is_paid_hs": false,
+        "is_paid_hf": false,
+        "quotas": {
+          "templates_left": 0,
+          "documents_left": 3,
+          "api_signature_requests_left": 0
+        }
+      }
+    ],
+    "invited_emails": [
+      "invite_1@example.com",
+      "invite_2@example.com",
+      "invite_3@example.com"
+    ]
   }
 }

examples/json/TeamRemoveMemberResponseExample.json

@@ -16,7 +16,24 @@
         "role_code": "a"
       }
     ],
-    "invited_accounts": [],
-    "invited_emails": []
+    "invited_accounts": [
+      {
+        "account_id": "8e239b5a50eac117fdd9a0e2359620aa57cb2463",
+        "email_address": "george@hellofax.com",
+        "is_locked": false,
+        "is_paid_hs": false,
+        "is_paid_hf": false,
+        "quotas": {
+          "templates_left": 0,
+          "documents_left": 3,
+          "api_signature_requests_left": 0
+        }
+      }
+    ],
+    "invited_emails": [
+      "invite_1@example.com",
+      "invite_2@example.com",
+      "invite_3@example.com"
+    ]
   }
 }

examples/json/TeamUpdateResponseExample.json

@@ -16,7 +16,24 @@
         "role_code": "a"
       }
     ],
-    "invited_accounts": [],
-    "invited_emails": []
+    "invited_accounts": [
+      {
+        "account_id": "8e239b5a50eac117fdd9a0e2359620aa57cb2463",
+        "email_address": "george@hellofax.com",
+        "is_locked": false,
+        "is_paid_hs": false,
+        "is_paid_hf": false,
+        "quotas": {
+          "templates_left": 0,
+          "documents_left": 3,
+          "api_signature_requests_left": 0
+        }
+      }
+    ],
+    "invited_emails": [
+      "invite_1@example.com",
+      "invite_2@example.com",
+      "invite_3@example.com"
+    ]
   }
 }

openapi-raw.yaml

@@ -10532,6 +10532,11 @@ components:
       x-internal-class: true
     TeamResponse:
       description: '_t__TeamResponse::DESCRIPTION'
+      required:
+        - name
+        - accounts
+        - invited_accounts
+        - invited_emails
       properties:
         name:
           description: '_t__Team::NAME'

openapi-sdk.yaml

@@ -11148,6 +11148,11 @@ components:
       x-internal-class: true
     TeamResponse:
       description: 'Contains information about your team and its members'
+      required:
+        - name
+        - accounts
+        - invited_accounts
+        - invited_emails
       properties:
         name:
           description: 'The name of your Team'

openapi.yaml

@@ -11126,6 +11126,11 @@ components:
       x-internal-class: true
     TeamResponse:
       description: 'Contains information about your team and its members'
+      required:
+        - name
+        - accounts
+        - invited_accounts
+        - invited_emails
       properties:
         name:
           description: 'The name of your Team'

sdks/dotnet/docs/TeamResponse.md

@@ -5,7 +5,7 @@ Contains information about your team and its members
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**Name** | **string** |  The name of your Team  | [optional] **Accounts** | [**List<AccountResponse>**](AccountResponse.md) |    | [optional] **InvitedAccounts** | [**List<AccountResponse>**](AccountResponse.md) |  A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in `GET /account`.  | [optional] **InvitedEmails** | **List<string>** |  A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.  | [optional] 
+**Name** | **string** |  The name of your Team  | **Accounts** | [**List<AccountResponse>**](AccountResponse.md) |    | **InvitedAccounts** | [**List<AccountResponse>**](AccountResponse.md) |  A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in `GET /account`.  | **InvitedEmails** | **List<string>** |  A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.  | 
 
 [[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/TeamResponse.cs

@@ -41,16 +41,36 @@ protected TeamResponse() { }
         /// <summary>
         /// Initializes a new instance of the <see cref="TeamResponse" /> class.
         /// </summary>
-        /// <param name="name">The name of your Team.</param>
-        /// <param name="accounts">accounts.</param>
-        /// <param name="invitedAccounts">A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in &#x60;GET /account&#x60;..</param>
-        /// <param name="invitedEmails">A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account..</param>
+        /// <param name="name">The name of your Team (required).</param>
+        /// <param name="accounts">accounts (required).</param>
+        /// <param name="invitedAccounts">A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in &#x60;GET /account&#x60;. (required).</param>
+        /// <param name="invitedEmails">A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account. (required).</param>
         public TeamResponse(string name = default(string), List<AccountResponse> accounts = default(List<AccountResponse>), List<AccountResponse> invitedAccounts = default(List<AccountResponse>), List<string> invitedEmails = default(List<string>))
         {
 
+            // to ensure "name" is required (not null)
+            if (name == null)
+            {
+                throw new ArgumentNullException("name is a required property for TeamResponse and cannot be null");
+            }
             this.Name = name;
+            // to ensure "accounts" is required (not null)
+            if (accounts == null)
+            {
+                throw new ArgumentNullException("accounts is a required property for TeamResponse and cannot be null");
+            }
             this.Accounts = accounts;
+            // to ensure "invitedAccounts" is required (not null)
+            if (invitedAccounts == null)
+            {
+                throw new ArgumentNullException("invitedAccounts is a required property for TeamResponse and cannot be null");
+            }
             this.InvitedAccounts = invitedAccounts;
+            // to ensure "invitedEmails" is required (not null)
+            if (invitedEmails == null)
+            {
+                throw new ArgumentNullException("invitedEmails is a required property for TeamResponse and cannot be null");
+            }
             this.InvitedEmails = invitedEmails;
         }
 
@@ -74,27 +94,27 @@ public static TeamResponse Init(string jsonData)
         /// The name of your Team
         /// </summary>
         /// <value>The name of your Team</value>
-        [DataMember(Name = "name", EmitDefaultValue = true)]
+        [DataMember(Name = "name", IsRequired = true, EmitDefaultValue = true)]
         public string Name { get; set; }
 
         /// <summary>
         /// Gets or Sets Accounts
         /// </summary>
-        [DataMember(Name = "accounts", EmitDefaultValue = true)]
+        [DataMember(Name = "accounts", IsRequired = true, EmitDefaultValue = true)]
         public List<AccountResponse> Accounts { get; set; }
 
         /// <summary>
         /// A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in &#x60;GET /account&#x60;.
         /// </summary>
         /// <value>A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in &#x60;GET /account&#x60;.</value>
-        [DataMember(Name = "invited_accounts", EmitDefaultValue = true)]
+        [DataMember(Name = "invited_accounts", IsRequired = true, EmitDefaultValue = true)]
         public List<AccountResponse> InvitedAccounts { get; set; }
 
         /// <summary>
         /// A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.
         /// </summary>
         /// <value>A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.</value>
-        [DataMember(Name = "invited_emails", EmitDefaultValue = true)]
+        [DataMember(Name = "invited_emails", IsRequired = true, EmitDefaultValue = true)]
         public List<string> InvitedEmails { get; set; }
 
         /// <summary>

sdks/java-v1/docs/TeamResponse.md

@@ -8,10 +8,10 @@ Contains information about your team and its members
 
 | Name | Type | Description | Notes |
 |------------ | ------------- | ------------- | -------------|
-| `name` | ```String``` |  The name of your Team  |  |
-| `accounts` | [```List<AccountResponse>```](AccountResponse.md) |    |  |
-| `invitedAccounts` | [```List<AccountResponse>```](AccountResponse.md) |  A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in `GET /account`.  |  |
-| `invitedEmails` | ```List<String>``` |  A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.  |  |
+| `name`<sup>*_required_</sup> | ```String``` |  The name of your Team  |  |
+| `accounts`<sup>*_required_</sup> | [```List<AccountResponse>```](AccountResponse.md) |    |  |
+| `invitedAccounts`<sup>*_required_</sup> | [```List<AccountResponse>```](AccountResponse.md) |  A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in `GET /account`.  |  |
+| `invitedEmails`<sup>*_required_</sup> | ```List<String>``` |  A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.  |  |
 
 
 

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

@@ -41,13 +41,13 @@ public class TeamResponse {
     private String name;
 
     public static final String JSON_PROPERTY_ACCOUNTS = "accounts";
-    private List<AccountResponse> accounts = null;
+    private List<AccountResponse> accounts = new ArrayList<>();
 
     public static final String JSON_PROPERTY_INVITED_ACCOUNTS = "invited_accounts";
-    private List<AccountResponse> invitedAccounts = null;
+    private List<AccountResponse> invitedAccounts = new ArrayList<>();
 
     public static final String JSON_PROPERTY_INVITED_EMAILS = "invited_emails";
-    private List<String> invitedEmails = null;
+    private List<String> invitedEmails = new ArrayList<>();
 
     public TeamResponse() {}
 
@@ -75,14 +75,15 @@ public TeamResponse name(String name) {
      *
      * @return name
      */
-    @javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_NAME)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @javax.annotation.Nonnull
+    @JsonProperty(JSON_PROPERTY_NAME)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public String getName() {
         return name;
     }
 
     @JsonProperty(JSON_PROPERTY_NAME)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public void setName(String name) {
         this.name = name;
     }
@@ -105,14 +106,15 @@ public TeamResponse addAccountsItem(AccountResponse accountsItem) {
      *
      * @return accounts
      */
-    @javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_ACCOUNTS)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @javax.annotation.Nonnull
+    @JsonProperty(JSON_PROPERTY_ACCOUNTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public List<AccountResponse> getAccounts() {
         return accounts;
     }
 
     @JsonProperty(JSON_PROPERTY_ACCOUNTS)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public void setAccounts(List<AccountResponse> accounts) {
         this.accounts = accounts;
     }
@@ -136,14 +138,15 @@ public TeamResponse addInvitedAccountsItem(AccountResponse invitedAccountsItem)
      *
      * @return invitedAccounts
      */
-    @javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_INVITED_ACCOUNTS)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @javax.annotation.Nonnull
+    @JsonProperty(JSON_PROPERTY_INVITED_ACCOUNTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public List<AccountResponse> getInvitedAccounts() {
         return invitedAccounts;
     }
 
     @JsonProperty(JSON_PROPERTY_INVITED_ACCOUNTS)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public void setInvitedAccounts(List<AccountResponse> invitedAccounts) {
         this.invitedAccounts = invitedAccounts;
     }
@@ -167,14 +170,15 @@ public TeamResponse addInvitedEmailsItem(String invitedEmailsItem) {
      *
      * @return invitedEmails
      */
-    @javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_INVITED_EMAILS)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @javax.annotation.Nonnull
+    @JsonProperty(JSON_PROPERTY_INVITED_EMAILS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public List<String> getInvitedEmails() {
         return invitedEmails;
     }
 
     @JsonProperty(JSON_PROPERTY_INVITED_EMAILS)
-    @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+    @JsonInclude(value = JsonInclude.Include.ALWAYS)
     public void setInvitedEmails(List<String> invitedEmails) {
         this.invitedEmails = invitedEmails;
     }

sdks/java-v2/docs/TeamResponse.md

@@ -8,10 +8,10 @@ Contains information about your team and its members
 
 | Name | Type | Description | Notes |
 |------------ | ------------- | ------------- | -------------|
-| `name` | ```String``` |  The name of your Team  |  |
-| `accounts` | [```List<AccountResponse>```](AccountResponse.md) |    |  |
-| `invitedAccounts` | [```List<AccountResponse>```](AccountResponse.md) |  A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in `GET /account`.  |  |
-| `invitedEmails` | ```List<String>``` |  A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.  |  |
+| `name`<sup>*_required_</sup> | ```String``` |  The name of your Team  |  |
+| `accounts`<sup>*_required_</sup> | [```List<AccountResponse>```](AccountResponse.md) |    |  |
+| `invitedAccounts`<sup>*_required_</sup> | [```List<AccountResponse>```](AccountResponse.md) |  A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in `GET /account`.  |  |
+| `invitedEmails`<sup>*_required_</sup> | ```List<String>``` |  A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.  |  |