feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 139
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-17c43dab26af75e1b9f7e61ac8da1219cea65c7d0666d98686b71a60183e458d.yml
-openapi_spec_hash: 7d7f4d41ccb2023153327ca685dcf942
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-1ca41c4b1d872cf2a198c8cf5edeeeddac012259a7cf211b102bf137c05b8240.yml
+openapi_spec_hash: 955066d4865fc42440cd81e40f5f79cd
 config_hash: c01c1191b1cd696c7ca855ff6d28a8df

orb-java-core/src/main/kotlin/com/withorb/api/models/CouponListParams.kt

@@ -14,7 +14,7 @@ import kotlin.jvm.optionals.getOrNull
  *
  * The list of coupons is ordered starting from the most recently created coupon. The response also
  * includes `pagination_metadata`, which lets the caller retrieve the next page of results if they
- * exist. More information about pagination can be found in the Pagination-metadata schema.
+ * exist.
  */
 class CouponListParams
 private constructor(

orb-java-core/src/main/kotlin/com/withorb/api/models/EventBackfillCreateParams.kt

@@ -25,7 +25,8 @@ import kotlin.jvm.optionals.getOrNull
  * Creating the backfill enables adding or replacing past events, even those that are older than the
  * ingestion grace period. Performing a backfill in Orb involves 3 steps:
  * 1. Create the backfill, specifying its parameters.
- * 2. [Ingest](ingest) usage events, referencing the backfill (query parameter `backfill_id`).
+ * 2. [Ingest](/api-reference/event/ingest-events) usage events, referencing the backfill (query
+ *    parameter `backfill_id`).
  * 3. [Close](close-backfill) the backfill, propagating the update in past usage throughout Orb.
  *
  * Changes from a backfill are not reflected until the backfill is closed, so you won’t need to

orb-java-core/src/main/kotlin/com/withorb/api/models/EventBackfillListParams.kt

@@ -14,8 +14,7 @@ import kotlin.jvm.optionals.getOrNull
  *
  * The list of backfills is ordered starting from the most recently created backfill. The response
  * also includes [`pagination_metadata`](/api-reference/pagination), which lets the caller retrieve
- * the next page of results if they exist. More information about pagination can be found in the
- * [Pagination-metadata schema](pagination).
+ * the next page of results if they exist.
  */
 class EventBackfillListParams
 private constructor(

orb-java-core/src/main/kotlin/com/withorb/api/models/SubscriptionFetchCostsParams.kt

@@ -22,9 +22,9 @@ import kotlin.jvm.optionals.getOrNull
  * rather than a currency).
  *
  * The semantics of this endpoint exactly mirror those of
- * [fetching a customer's costs](fetch-customer-costs). Use this endpoint to limit your analysis of
- * costs to a specific subscription for the customer (e.g. to de-aggregate costs when a customer's
- * subscription has started and stopped on the same day).
+ * [fetching a customer's costs](/api-reference/customer/fetch-customer-costs). Use this endpoint to
+ * limit your analysis of costs to a specific subscription for the customer (e.g. to de-aggregate
+ * costs when a customer's subscription has started and stopped on the same day).
  */
 class SubscriptionFetchCostsParams
 private constructor(

orb-java-core/src/main/kotlin/com/withorb/api/services/async/CouponServiceAsync.kt

@@ -61,8 +61,7 @@ interface CouponServiceAsync {
      *
      * The list of coupons is ordered starting from the most recently created coupon. The response
      * also includes `pagination_metadata`, which lets the caller retrieve the next page of results
-     * if they exist. More information about pagination can be found in the Pagination-metadata
-     * schema.
+     * if they exist.
      */
     fun list(): CompletableFuture<CouponListPageAsync> = list(CouponListParams.none())
 

orb-java-core/src/main/kotlin/com/withorb/api/services/async/SubscriptionServiceAsync.kt

@@ -487,9 +487,9 @@ interface SubscriptionServiceAsync {
      * units rather than a currency).
      *
      * The semantics of this endpoint exactly mirror those of
-     * [fetching a customer's costs](fetch-customer-costs). Use this endpoint to limit your analysis
-     * of costs to a specific subscription for the customer (e.g. to de-aggregate costs when a
-     * customer's subscription has started and stopped on the same day).
+     * [fetching a customer's costs](/api-reference/customer/fetch-customer-costs). Use this
+     * endpoint to limit your analysis of costs to a specific subscription for the customer (e.g. to
+     * de-aggregate costs when a customer's subscription has started and stopped on the same day).
      */
     fun fetchCosts(subscriptionId: String): CompletableFuture<SubscriptionFetchCostsResponse> =
         fetchCosts(subscriptionId, SubscriptionFetchCostsParams.none())

orb-java-core/src/main/kotlin/com/withorb/api/services/async/events/BackfillServiceAsync.kt

@@ -41,7 +41,8 @@ interface BackfillServiceAsync {
      * Creating the backfill enables adding or replacing past events, even those that are older than
      * the ingestion grace period. Performing a backfill in Orb involves 3 steps:
      * 1. Create the backfill, specifying its parameters.
-     * 2. [Ingest](ingest) usage events, referencing the backfill (query parameter `backfill_id`).
+     * 2. [Ingest](/api-reference/event/ingest-events) usage events, referencing the backfill (query
+     *    parameter `backfill_id`).
      * 3. [Close](close-backfill) the backfill, propagating the update in past usage throughout Orb.
      *
      * Changes from a backfill are not reflected until the backfill is closed, so you won’t need to
@@ -84,8 +85,7 @@ interface BackfillServiceAsync {
      *
      * The list of backfills is ordered starting from the most recently created backfill. The
      * response also includes [`pagination_metadata`](/api-reference/pagination), which lets the
-     * caller retrieve the next page of results if they exist. More information about pagination can
-     * be found in the [Pagination-metadata schema](pagination).
+     * caller retrieve the next page of results if they exist.
      */
     fun list(): CompletableFuture<EventBackfillListPageAsync> = list(EventBackfillListParams.none())
 

orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/CouponService.kt

@@ -60,8 +60,7 @@ interface CouponService {
      *
      * The list of coupons is ordered starting from the most recently created coupon. The response
      * also includes `pagination_metadata`, which lets the caller retrieve the next page of results
-     * if they exist. More information about pagination can be found in the Pagination-metadata
-     * schema.
+     * if they exist.
      */
     fun list(): CouponListPage = list(CouponListParams.none())
 

orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/SubscriptionService.kt

@@ -476,9 +476,9 @@ interface SubscriptionService {
      * units rather than a currency).
      *
      * The semantics of this endpoint exactly mirror those of
-     * [fetching a customer's costs](fetch-customer-costs). Use this endpoint to limit your analysis
-     * of costs to a specific subscription for the customer (e.g. to de-aggregate costs when a
-     * customer's subscription has started and stopped on the same day).
+     * [fetching a customer's costs](/api-reference/customer/fetch-customer-costs). Use this
+     * endpoint to limit your analysis of costs to a specific subscription for the customer (e.g. to
+     * de-aggregate costs when a customer's subscription has started and stopped on the same day).
      */
     fun fetchCosts(subscriptionId: String): SubscriptionFetchCostsResponse =
         fetchCosts(subscriptionId, SubscriptionFetchCostsParams.none())