API Updates

src/main/java/com/stripe/model/reporting/ReportRun.java

@@ -38,7 +38,10 @@ public class ReportRun extends ApiResource implements HasId {
   @SerializedName("id")
   String id;
 
-  /** Always {@code true}: reports can only be run on live-mode data. */
+  /**
+   * {@code true} if the report is run on live mode data and {@code false} if it is run on test mode
+   * data.
+   */
   @SerializedName("livemode")
   Boolean livemode;
 
@@ -83,27 +86,18 @@ public class ReportRun extends ApiResource implements HasId {
   @SerializedName("succeeded_at")
   Long succeededAt;
 
-  /**
-   * Retrieves the details of an existing Report Run. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Retrieves the details of an existing Report Run. */
   public static ReportRun retrieve(String reportRun) throws StripeException {
     return retrieve(reportRun, (Map<String, Object>) null, (RequestOptions) null);
   }
 
-  /**
-   * Retrieves the details of an existing Report Run. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Retrieves the details of an existing Report Run. */
   public static ReportRun retrieve(String reportRun, RequestOptions options)
       throws StripeException {
     return retrieve(reportRun, (Map<String, Object>) null, options);
   }
 
-  /**
-   * Retrieves the details of an existing Report Run. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Retrieves the details of an existing Report Run. */
   public static ReportRun retrieve(
       String reportRun, Map<String, Object> params, RequestOptions options) throws StripeException {
     String url =
@@ -115,10 +109,7 @@ public static ReportRun retrieve(
         ApiResource.RequestMethod.GET, url, params, ReportRun.class, options);
   }
 
-  /**
-   * Retrieves the details of an existing Report Run. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Retrieves the details of an existing Report Run. */
   public static ReportRun retrieve(
       String reportRun, ReportRunRetrieveParams params, RequestOptions options)
       throws StripeException {
@@ -132,15 +123,15 @@ public static ReportRun retrieve(
   }
 
   /**
-   * Creates a new object and begin running the report. (Requires a <a
+   * Creates a new object and begin running the report. (Certain report types require a <a
    * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
    */
   public static ReportRun create(Map<String, Object> params) throws StripeException {
     return create(params, (RequestOptions) null);
   }
 
   /**
-   * Creates a new object and begin running the report. (Requires a <a
+   * Creates a new object and begin running the report. (Certain report types require a <a
    * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
    */
   public static ReportRun create(Map<String, Object> params, RequestOptions options)
@@ -151,15 +142,15 @@ public static ReportRun create(Map<String, Object> params, RequestOptions option
   }
 
   /**
-   * Creates a new object and begin running the report. (Requires a <a
+   * Creates a new object and begin running the report. (Certain report types require a <a
    * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
    */
   public static ReportRun create(ReportRunCreateParams params) throws StripeException {
     return create(params, (RequestOptions) null);
   }
 
   /**
-   * Creates a new object and begin running the report. (Requires a <a
+   * Creates a new object and begin running the report. (Certain report types require a <a
    * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
    */
   public static ReportRun create(ReportRunCreateParams params, RequestOptions options)
@@ -169,36 +160,24 @@ public static ReportRun create(ReportRunCreateParams params, RequestOptions opti
         ApiResource.RequestMethod.POST, url, params, ReportRun.class, options);
   }
 
-  /**
-   * Returns a list of Report Runs, with the most recent appearing first. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Returns a list of Report Runs, with the most recent appearing first. */
   public static ReportRunCollection list(Map<String, Object> params) throws StripeException {
     return list(params, (RequestOptions) null);
   }
 
-  /**
-   * Returns a list of Report Runs, with the most recent appearing first. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Returns a list of Report Runs, with the most recent appearing first. */
   public static ReportRunCollection list(Map<String, Object> params, RequestOptions options)
       throws StripeException {
     String url = String.format("%s%s", Stripe.getApiBase(), "/v1/reporting/report_runs");
     return ApiResource.requestCollection(url, params, ReportRunCollection.class, options);
   }
 
-  /**
-   * Returns a list of Report Runs, with the most recent appearing first. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Returns a list of Report Runs, with the most recent appearing first. */
   public static ReportRunCollection list(ReportRunListParams params) throws StripeException {
     return list(params, (RequestOptions) null);
   }
 
-  /**
-   * Returns a list of Report Runs, with the most recent appearing first. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Returns a list of Report Runs, with the most recent appearing first. */
   public static ReportRunCollection list(ReportRunListParams params, RequestOptions options)
       throws StripeException {
     String url = String.format("%s%s", Stripe.getApiBase(), "/v1/reporting/report_runs");

src/main/java/com/stripe/model/reporting/ReportType.java

@@ -72,15 +72,15 @@ public class ReportType extends ApiResource implements HasId {
   Long version;
 
   /**
-   * Retrieves the details of a Report Type. (Requires a <a
+   * Retrieves the details of a Report Type. (Certain report types require a <a
    * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
    */
   public static ReportType retrieve(String reportType) throws StripeException {
     return retrieve(reportType, (Map<String, Object>) null, (RequestOptions) null);
   }
 
   /**
-   * Retrieves the details of a Report Type. (Requires a <a
+   * Retrieves the details of a Report Type. (Certain report types require a <a
    * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
    */
   public static ReportType retrieve(String reportType, RequestOptions options)
@@ -89,7 +89,7 @@ public static ReportType retrieve(String reportType, RequestOptions options)
   }
 
   /**
-   * Retrieves the details of a Report Type. (Requires a <a
+   * Retrieves the details of a Report Type. (Certain report types require a <a
    * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
    */
   public static ReportType retrieve(
@@ -105,7 +105,7 @@ public static ReportType retrieve(
   }
 
   /**
-   * Retrieves the details of a Report Type. (Requires a <a
+   * Retrieves the details of a Report Type. (Certain report types require a <a
    * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
    */
   public static ReportType retrieve(
@@ -120,36 +120,24 @@ public static ReportType retrieve(
         ApiResource.RequestMethod.GET, url, params, ReportType.class, options);
   }
 
-  /**
-   * Returns a full list of Report Types. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Returns a full list of Report Types. */
   public static ReportTypeCollection list(Map<String, Object> params) throws StripeException {
     return list(params, (RequestOptions) null);
   }
 
-  /**
-   * Returns a full list of Report Types. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Returns a full list of Report Types. */
   public static ReportTypeCollection list(Map<String, Object> params, RequestOptions options)
       throws StripeException {
     String url = String.format("%s%s", Stripe.getApiBase(), "/v1/reporting/report_types");
     return ApiResource.requestCollection(url, params, ReportTypeCollection.class, options);
   }
 
-  /**
-   * Returns a full list of Report Types. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Returns a full list of Report Types. */
   public static ReportTypeCollection list(ReportTypeListParams params) throws StripeException {
     return list(params, (RequestOptions) null);
   }
 
-  /**
-   * Returns a full list of Report Types. (Requires a <a
-   * href="https://stripe.com/docs/keys#test-live-modes">live-mode API key</a>.)
-   */
+  /** Returns a full list of Report Types. */
   public static ReportTypeCollection list(ReportTypeListParams params, RequestOptions options)
       throws StripeException {
     String url = String.format("%s%s", Stripe.getApiBase(), "/v1/reporting/report_types");

src/main/java/com/stripe/param/SubscriptionCreateParams.java

@@ -15,7 +15,7 @@
 public class SubscriptionCreateParams extends ApiRequestParams {
   /**
    * A list of prices and quantities that will generate invoice items appended to the first invoice
-   * for this subscription. You may pass up to 10 items.
+   * for this subscription. You may pass up to 20 items.
    */
   @SerializedName("add_invoice_items")
   List<AddInvoiceItem> addInvoiceItems;

src/main/java/com/stripe/param/SubscriptionScheduleCreateParams.java

@@ -861,7 +861,7 @@ public enum CollectionMethod implements ApiRequestParams.EnumParam {
   public static class Phase {
     /**
      * A list of prices and quantities that will generate invoice items appended to the next
-     * invoice. You may pass up to 10 items.
+     * invoice. You may pass up to 20 items.
      */
     @SerializedName("add_invoice_items")
     List<AddInvoiceItem> addInvoiceItems;

src/main/java/com/stripe/param/SubscriptionScheduleUpdateParams.java

@@ -826,7 +826,7 @@ public enum CollectionMethod implements ApiRequestParams.EnumParam {
   public static class Phase {
     /**
      * A list of prices and quantities that will generate invoice items appended to the next
-     * invoice. You may pass up to 10 items.
+     * invoice. You may pass up to 20 items.
      */
     @SerializedName("add_invoice_items")
     List<AddInvoiceItem> addInvoiceItems;

src/main/java/com/stripe/param/SubscriptionUpdateParams.java

@@ -15,7 +15,7 @@
 public class SubscriptionUpdateParams extends ApiRequestParams {
   /**
    * A list of prices and quantities that will generate invoice items appended to the first invoice
-   * for this subscription. You may pass up to 10 items.
+   * for this subscription. You may pass up to 20 items.
    */
   @SerializedName("add_invoice_items")
   List<AddInvoiceItem> addInvoiceItems;