@leaflow/sdk 0.155.0 → 0.157.0

package/dist/billing/v1/generated/functions.js

@@ -340,7 +340,7 @@ export const getGetBillingAccountUrl = (accountId) => {
     return `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}`;
 };
 /**
- * Your billing account with its currency, status and invoice contact. Returns 404 if it does not exist and 403 if it belongs to another user.
+ * A billing account with its currency, status and invoice contact, readable by its owner and by members of the projects it currently pays for. Returns 404 if it does not exist and 403 to anyone else.
  * @summary Get billing account
  */
 export const getBillingAccount = async (accountId, options, fetchFn) => {
@@ -426,7 +426,7 @@ export const getGetAccountBalanceUrl = (accountId) => {
     return `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}/balance`;
 };
 /**
- * The balance of your account, with credit groups, unpaid invoice amounts, unbilled estimates and pending returns. Returns 404 for a missing account and 403 for another user's account.
+ * The balance of an account, with credit groups, unpaid invoice amounts, unbilled estimates and pending returns, readable by its owner and by members of the projects it currently pays for. Returns 404 for a missing account and 403 to anyone else.
  * @summary Get account balance
  */
 export const getAccountBalance = async (accountId, options, fetchFn) => {
@@ -451,7 +451,7 @@ export const getListPaymentOptionsUrl = (accountId, params) => {
         : `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}/payment-options`;
 };
 /**
- * The payment gateways and methods currently accepting the account's currency, preferred gateway first. Top-ups and invoice payments must use one listed here. An empty result means online payment is unavailable for the account.
+ * The payment gateways and methods currently accepting the account's currency, preferred gateway first. Top-ups and invoice payments must use one listed here. An empty result means online payment is unavailable for the account. Open to the owner of the account and to members of the projects it currently pays for.
  * @summary List payment options
  */
 export const listPaymentOptions = async (accountId, params, options, fetchFn) => {
@@ -513,7 +513,7 @@ export const getGetProjectAssignmentUrl = (projectId) => {
     return `https://billing.leaflow.cloud/api/v1/assignments/${encodeURIComponent(String(projectId))}`;
 };
 /**
- * The project's current assignment. Returns 404 when no billing account is assigned; the project cannot create resources until one is.
+ * The project's current assignment, readable by the owner of the assigned account and by members of the project. Returns 404 when no billing account is assigned; the project cannot create resources until one is.
  * @summary Get project assignment
  */
 export const getProjectAssignment = async (projectId, options, fetchFn) => {
@@ -529,7 +529,8 @@ export const getSetProjectAssignmentUrl = (projectId) => {
     return `https://billing.leaflow.cloud/api/v1/assignments/${encodeURIComponent(String(projectId))}`;
 };
 /**
- * Links the project to a billing account. A project without one is linked directly. Moving it to another
+ * Links the project to a billing account you own; you need the project permission
+ * `billing:project_assignment.write`. A project without one is linked directly. Moving it to another
  * account has the same requirements as unlinking: you own both accounts, the project has no metered resources,
  * no subscriptions that have not ended and no orders in progress, and the current account has no unpaid
  * invoices. Nothing moves with the project; charges already incurred stay with the account linked when they
@@ -568,7 +569,7 @@ export const getUnlinkProjectBillingAccountUrl = (projectId) => {
     return `https://billing.leaflow.cloud/api/v1/assignments/${encodeURIComponent(String(projectId))}`;
 };
 /**
- * Ends the project's current assignment; the assignment history is kept. Allowed only when the project has no metered resources, no subscriptions that have not ended and no orders in progress, including period-end changes, and the billing account has no unpaid invoices; invoices of orders awaiting payment do not count. Orders are not modified, so wait for them to complete. Charges already incurred stay with the billing account and are invoiced as usual. The project cannot make purchases until a billing account is linked again.
+ * Ends the project's current assignment; the assignment history is kept. You need to own the account and hold the project permission `billing:project_assignment.write`. Allowed only when the project has no metered resources, no subscriptions that have not ended and no orders in progress, including period-end changes, and the billing account has no unpaid invoices; invoices of orders awaiting payment do not count. Orders are not modified, so wait for them to complete. Charges already incurred stay with the billing account and are invoiced as usual. The project cannot make purchases until a billing account is linked again.
  * @summary Unlink project billing account
  */
 export const unlinkProjectBillingAccount = async (projectId, options, fetchFn) => {
@@ -790,6 +791,9 @@ export const getPayInvoiceUrl = (invoiceId) => {
  * `BILLING_INVOICE_NOT_PAYABLE` with `meta.reason` `fractional_amount` when the amount left for the gateway is
  * not a whole number of the currency's minor unit; such an invoice is collected from credit grants and balance
  * automatically, including right after a top-up.
+ *
+ * Open to the owner of the invoice's billing account and, for the invoice of an order of a project, to members
+ * of the project. Only the owner can pay with a saved `payment_method_id`.
  * @summary Pay an invoice
  */
 export const payInvoice = async (invoiceId, payInvoiceRequest, options, fetchFn) => {
@@ -837,7 +841,7 @@ export const getPreviewInvoicePaymentUrl = (invoiceId, params) => {
  * Nothing is charged, reserved or created.
  *
  * Refused with the same errors as paying, except that insufficient funds are not an error here:
- * they show as a `gateway_amount` above zero.
+ * they show as a `gateway_amount` above zero. Open to the same callers as paying.
  * @summary Preview invoice payment
  */
 export const previewInvoicePayment = async (invoiceId, params, options, fetchFn) => {
@@ -954,7 +958,7 @@ export const getGetInvoiceUrl = (invoiceId) => {
     return `https://billing.leaflow.cloud/api/v1/invoices/${encodeURIComponent(String(invoiceId))}`;
 };
 /**
- * An issued invoice of your billing account, with its amounts, tax lines and payment state. A missing or unissued invoice returns 404; an invoice of another user's account returns 403.
+ * An issued invoice of your billing account, or the invoice of an order of a project you are a member of, with its amounts, tax lines and payment state. A missing or unissued invoice returns 404; any other invoice returns 403.
  * @summary Get invoice
  */
 export const getInvoice = async (invoiceId, options, fetchFn) => {
@@ -979,7 +983,7 @@ export const getListInvoiceItemsUrl = (invoiceId, params) => {
         : `https://billing.leaflow.cloud/api/v1/invoices/${encodeURIComponent(String(invoiceId))}/items`;
 };
 /**
- * Lines of an issued invoice of your billing account, with their service periods and projects. A missing or unissued invoice returns 404; an invoice of another user's account returns 403.
+ * Lines of an invoice readable with get-invoice, with their service periods and projects. A missing or unissued invoice returns 404; any other invoice returns 403.
  * @summary List invoice items
  */
 export const listInvoiceItems = async (invoiceId, params, options, fetchFn) => {
@@ -1170,7 +1174,7 @@ export const getListUsageChargesUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/usage-charges`;
 };
 /**
- * Priced usage charges in the requested scope. Usage that had no price when it occurred is never charged later.
+ * Priced usage charges in the requested scope; members with the project permission `billing:cost.read` list a project's charges with `project_ids`. Usage that had no price when it occurred is never charged later.
  * @summary List usage charges
  */
 export const listUsageCharges = async (params, options, fetchFn) => {
@@ -1195,7 +1199,7 @@ export const getListSubscriptionsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/subscriptions`;
 };
 /**
- * Subscriptions of the authorized billing account. Deleted subscriptions are not listed.
+ * Subscriptions paid by your billing accounts; members of a project list its subscriptions with `project_ids`. Deleted subscriptions are not listed.
  * @summary List subscriptions
  */
 export const listSubscriptions = async (params, options, fetchFn) => {
@@ -1211,7 +1215,7 @@ export const getGetSubscriptionUrl = (subscriptionId) => {
     return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}`;
 };
 /**
- * A subscription of the authorized billing account. Deleted subscriptions are reported as not found.
+ * A subscription paid by your billing account or of a project you are a member of. Deleted subscriptions are reported as not found.
  * @summary Get subscription
  */
 export const getSubscription = async (subscriptionId, options, fetchFn) => {
@@ -1227,7 +1231,7 @@ export const getDeleteSubscriptionUrl = (subscriptionId) => {
     return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}`;
 };
 /**
- * Hides a canceled or terminated subscription from your subscription list and detail by setting deleted_at; its status, ended_at and history are kept. The token must authorize the subscription's current billing account. A subscription that has not ended is refused with 409 `BILLING_SUBSCRIPTION_NOT_ENDED` and `status`. Repeating it keeps the original deleted_at. It sends no cleanup command and creates no refund.
+ * Hides a canceled or terminated subscription from your subscription list and detail by setting deleted_at; its status, ended_at and history are kept. Only the owner of the subscription's current billing account can delete it. A subscription that has not ended is refused with 409 `BILLING_SUBSCRIPTION_NOT_ENDED` and `status`. Repeating it keeps the original deleted_at. It sends no cleanup command and creates no refund.
  * @summary Delete subscription
  */
 export const deleteSubscription = async (subscriptionId, options, fetchFn) => {
@@ -1244,8 +1248,9 @@ export const getCancelSubscriptionUrl = (subscriptionId) => {
 };
 /**
  * Requests cancellation on the purchase's agreed terms, with the same rules as creating a cancellation. Give the
- * refund amount from a quote with this subscription in `cancellation.subscription_ids`. The token must authorize
- * the subscription's current billing account.
+ * refund amount from a quote with this subscription in `cancellation.subscription_ids`. Open to the owner of the
+ * subscription's current billing account and to members of its project with the project permission
+ * `billing:subscription.write`.
  *
  * Immediate cancellation asks the owning service to release the resources now; period-end cancellation keeps the
  * subscription active or suspended until the paid term ends. The subscription becomes canceled when the service
@@ -1287,10 +1292,11 @@ export const getGetQuoteUrl = () => {
  * Calculates what a proposed purchase, or the renewal of your subscriptions, would invoice now, and what each
  * purchased line renews at. Nothing is saved, reserved or redeemed.
  *
- * With `billing_account_id`, the quote is for a billing account you own: its currency, account discounts,
+ * With `billing_account_id`, the quote is for that billing account: its currency, account discounts,
  * tax and funds apply, renewals use the account currently paying for each subscription, and an access token
- * is required. Without it, proposed items are priced in `currency` for anyone, signed in or not: no account
- * discount or funds apply, and `tax_status` is `requires_location_inputs`.
+ * is required. The account must be yours or currently pay for a project you are a member of. Without it,
+ * proposed items are priced in `currency` for anyone, signed in or not: no account discount or funds apply, and
+ * `tax_status` is `requires_location_inputs`.
  *
  * A promotion code is evaluated without being applied. It is applied only when a Checkout Session is completed
  * with it; conditions that depend on the account, such as a first purchase, are checked only with an account
@@ -1372,7 +1378,7 @@ export const getListCancellationsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/cancellations`;
 };
 /**
- * Newest first. Filter by `subscription_id` and `status=open` to find a subscription's cancellation in progress.
+ * Newest first; members of a project list its cancellations with `project_ids`. Filter by `subscription_id` and `status=open` to find a subscription's cancellation in progress.
  * @summary List cancellations
  */
 export const listCancellations = async (params, options, fetchFn) => {
@@ -1389,7 +1395,9 @@ export const getCreateCancellationUrl = () => {
 };
 /**
  * Ends subscriptions of one service together. Deleting a resource is an `immediate` cancellation of every
- * subscription released with it, such as a server with its disks or an address with its bandwidth.
+ * subscription released with it, such as a server with its disks or an address with its bandwidth. Open to the
+ * owner of the subscriptions' current billing account and to members of their project with the project
+ * permission `billing:subscription.write`.
  *
  * The owning service releases the resources at once for `immediate`, or at `scheduled_at`, the end of the paid
  * term, for `period_end`. When release is confirmed, the unused value is returned to the original payment
@@ -1450,7 +1458,7 @@ export const getPreviewCancellationUrl = () => {
     return `https://billing.leaflow.cloud/api/v1/cancellations/preview`;
 };
 /**
- * What creating the cancellation now would return, per subscription and in total. Nothing is canceled, ended or refunded. Refused as creating it would be, except that nothing is recorded.
+ * What creating the cancellation now would return, per subscription and in total. Nothing is canceled, ended or refunded. Open to the same callers and refused as creating it would be, except that nothing is recorded.
  * @summary Preview a cancellation
  */
 export const previewCancellation = async (cancellationPreviewRequest, options, fetchFn) => {
@@ -1483,7 +1491,7 @@ export const getGetCancellationUrl = (cancellationId) => {
     return `https://billing.leaflow.cloud/api/v1/cancellations/${encodeURIComponent(String(cancellationId))}`;
 };
 /**
- * A cancellation of your billing account with its schedule, expected refundable amount and the outcome for each subscription, including partial success.
+ * A cancellation paid by your billing account or of a project you are a member of, with its schedule, expected refundable amount and the outcome for each subscription, including partial success.
  * @summary Get a cancellation
  */
 export const getCancellation = async (cancellationId, options, fetchFn) => {
@@ -1499,7 +1507,7 @@ export const getWithdrawCancellationUrl = (cancellationId) => {
     return `https://billing.leaflow.cloud/api/v1/cancellations/${encodeURIComponent(String(cancellationId))}/withdraw`;
 };
 /**
- * Withdraws the whole cancellation while no resource has begun to be released; afterwards it is refused with 409 `BILLING_CANCELLATION_CONFLICT`. The subscriptions continue, but automatic renewal, turned off when the cancellation was created, stays off until it is turned on again. Withdrawing a withdrawn cancellation returns it unchanged.
+ * Withdraws the whole cancellation while no resource has begun to be released; afterwards it is refused with 409 `BILLING_CANCELLATION_CONFLICT`. The subscriptions continue, but automatic renewal, turned off when the cancellation was created, stays off until it is turned on again. Withdrawing a withdrawn cancellation returns it unchanged. Open to the owner of the subscriptions' current billing account and to members of their project with the project permission `billing:subscription.write`.
  * @summary Withdraw a cancellation
  */
 export const withdrawCancellation = async (cancellationId, options, fetchFn) => {
@@ -1524,7 +1532,7 @@ export const getListRenewalPricesUrl = (subscriptionId, params) => {
         : `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/renewal-prices`;
 };
 /**
- * Lists the current renewal agreement and available intervals. The current option preserves recurring_amount; other options use current prices. Amounts cover the whole subscription quantity and exclude tax.
+ * Lists the current renewal agreement and available intervals. The current option preserves recurring_amount; other options use current prices. Amounts cover the whole subscription quantity and exclude tax. Open to the owner of the subscription's current billing account and to members of its project.
  * @summary List the terms this item can be renewed for
  */
 export const listRenewalPrices = async (subscriptionId, params, options, fetchFn) => {
@@ -1548,6 +1556,9 @@ export const getRenewSubscriptionUrl = (subscriptionId) => {
  * `use_balance` allow; when they cannot cover it, the request fails with `BILLING_INSUFFICIENT_FUNDS` and no
  * order is left. To apply a promotion code or pay later, create a renewal Checkout Session.
  *
+ * Open to the owner of the subscription's current billing account and to members of its project with the
+ * project permission `billing:subscription.write`. Only the owner can pay with `payment_method_id`.
+ *
  * Keep order_id and read the order after an unknown outcome; creating it again conflicts.
  * @summary Renew subscription
  */
@@ -1581,7 +1592,7 @@ export const getSetAutoRenewUrl = (subscriptionId) => {
     return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/auto-renew`;
 };
 /**
- * Turns automatic renewal of an active or suspended licensed subscription on or off. Turning it off does not shorten current_term_end and still allows manual renewal. Refused with 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_INACTIVE` for a pending or provisioning subscription, 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED` for a metered subscription, which continues until it is canceled, and 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` with `meta.cancellation_id` while a cancellation is open: creating it turned renewal off, and withdrawing it does not turn renewal back on.
+ * Turns automatic renewal of an active or suspended licensed subscription on or off. Turning it off does not shorten current_term_end and still allows manual renewal. Refused with 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_INACTIVE` for a pending or provisioning subscription, 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED` for a metered subscription, which continues until it is canceled, and 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` with `meta.cancellation_id` while a cancellation is open: creating it turned renewal off, and withdrawing it does not turn renewal back on. Open to the owner of the subscription's current billing account and to members of its project with the project permission `billing:subscription.write`.
  * @summary Set auto renew
  */
 export const setAutoRenew = async (subscriptionId, autoRenewSet, options, fetchFn) => {
@@ -1623,7 +1634,7 @@ export const getListAllowancesUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/allowances`;
 };
 /**
- * Remaining usage quantities, such as bytes, seconds or tokens. Applicable allowances are consumed before usage is charged: lower priority values first, then earlier expiry, then earlier issuance. Unused quantity expires without refund or carry-over. Promotional allowances apply to usage paid by their holding account; included allowances apply only to their subscription, also after its project moves to another billing account.
+ * Remaining usage quantities, such as bytes, seconds or tokens; members of a project list its allowances with `project_ids`. Applicable allowances are consumed before usage is charged: lower priority values first, then earlier expiry, then earlier issuance. Unused quantity expires without refund or carry-over. Promotional allowances apply to usage paid by their holding account; included allowances apply only to their subscription, also after its project moves to another billing account.
  * @summary List allowances
  */
 export const listAllowances = async (params, options, fetchFn) => {
@@ -1648,7 +1659,7 @@ export const getListCheckoutSessionsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/checkout-sessions`;
 };
 /**
- * Checkout Sessions of your billing accounts, newest first. An open session is a purchase waiting for you to complete checkout.
+ * Checkout Sessions of your billing accounts, newest first; members of a project list its sessions with `project_ids`. An open session is a purchase waiting for checkout to be completed.
  * @summary List Checkout Sessions
  */
 export const listCheckoutSessions = async (params, options, fetchFn) => {
@@ -1664,13 +1675,15 @@ export const getCreateCheckoutSessionUrl = () => {
     return `https://billing.leaflow.cloud/api/v1/checkout-sessions`;
 };
 /**
- * Opens a Checkout Session renewing one of your licensed subscriptions, with periods and price chosen as in
+ * Opens a Checkout Session renewing a licensed subscription, with periods and price chosen as in
  * renewing. Nothing is charged until you complete it, when a promotion code can be applied; it then renews from
  * the subscription's current_term_end at that time. To renew at once from credit grants, balance or a payment
  * method, renew the subscription instead. Purchases and changes of a service's resources are created through
  * that service.
  *
- * Keep `checkout_session_id` and read the session after an unknown outcome; creating it again conflicts.
+ * Open to the owner of the subscription's current billing account and to members of its project with the
+ * project permission `billing:subscription.write`. Keep `checkout_session_id` and read the session after an
+ * unknown outcome; creating it again conflicts.
  * @summary Create a renewal Checkout Session
  */
 export const createCheckoutSession = async (checkoutSessionCreate, options, fetchFn) => {
@@ -1703,7 +1716,7 @@ export const getGetCheckoutSessionUrl = (checkoutSessionId) => {
     return `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}`;
 };
 /**
- * A Checkout Session of your billing account. Poll it to follow checkout; once it is complete, read its order for payment and delivery. An unknown session returns 404; another account's session returns 403.
+ * A Checkout Session of your billing account or of a project you are a member of. Poll it to follow checkout; once it is complete, read its order for payment and delivery. An unknown session returns 404; any other session returns 403.
  * @summary Get a Checkout Session
  */
 export const getCheckoutSession = async (checkoutSessionId, options, fetchFn) => {
@@ -1728,7 +1741,7 @@ export const getListCheckoutSessionItemsUrl = (checkoutSessionId, params) => {
         : `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}/items`;
 };
 /**
- * What the session buys, by position. Prices and amounts are in its quote.
+ * What the session buys, by position. Prices and amounts are in its quote. Readable by whoever can read the session.
  * @summary List Checkout Session items
  */
 export const listCheckoutSessionItems = async (checkoutSessionId, params, options, fetchFn) => {
@@ -1761,6 +1774,8 @@ export const getGetCheckoutSessionQuoteUrl = (checkoutSessionId, params) => {
  * immediate change, the returned `proration_date`. An expired session is refused with
  * `BILLING_CHECKOUT_SESSION_EXPIRED`, and a complete one with `BILLING_CHECKOUT_SESSION_COMPLETE`; read its order
  * instead.
+ *
+ * Open to the owner of the session's billing account and to members of its project.
  * @summary Quote a Checkout Session
  */
 export const getCheckoutSessionQuote = async (checkoutSessionId, params, options, fetchFn) => {
@@ -1785,6 +1800,8 @@ export const getConfirmCheckoutSessionUrl = (checkoutSessionId) => {
  * Confirming a complete session again with the same terms returns it with its order; different terms are refused
  * with `BILLING_CHECKOUT_SESSION_COMPLETE`. An expired session is refused with `BILLING_CHECKOUT_SESSION_EXPIRED`.
  * The order is delivered by the service that owns it once paid; confirmation alone does not mean delivery.
+ *
+ * Open to the owner of the session's billing account and to members of its project.
  * @summary Confirm a Checkout Session
  */
 export const confirmCheckoutSession = async (checkoutSessionId, checkoutSessionConfirm, options, fetchFn) => {
@@ -1817,7 +1834,7 @@ export const getExpireCheckoutSessionUrl = (checkoutSessionId) => {
     return `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}/expire`;
 };
 /**
- * Ends an open session without an order; the service that created it releases what it was holding for the purchase. An expired session is returned unchanged.
+ * Ends an open session without an order; the service that created it releases what it was holding for the purchase. An expired session is returned unchanged. Open to the owner of the session's billing account and to members of its project.
  * @summary Expire a Checkout Session
  */
 export const expireCheckoutSession = async (checkoutSessionId, options, fetchFn) => {
@@ -1842,7 +1859,7 @@ export const getListOrdersUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/orders`;
 };
 /**
- * Orders with their status and invoice amounts. A pending order is not yet accepted and can expire at expires_at; its invoice shows whether payment is needed. Accepted does not mean delivered.
+ * Orders of your billing accounts with their status and invoice amounts; members of a project list its orders with `project_ids`. A pending order is not yet accepted and can expire at expires_at; its invoice shows whether payment is needed. Accepted does not mean delivered.
  * @summary List orders
  */
 export const listOrders = async (params, options, fetchFn) => {
@@ -1858,7 +1875,7 @@ export const getGetOrderUrl = (orderId) => {
     return `https://billing.leaflow.cloud/api/v1/orders/${encodeURIComponent(String(orderId))}`;
 };
 /**
- * An order of your billing account with its status and invoice. An unknown order returns 404; another user's order returns 403.
+ * An order of your billing account or of a project you are a member of, with its status and invoice. An unknown order returns 404; any other order returns 403.
  * @summary Get order
  */
 export const getOrder = async (orderId, options, fetchFn) => {
@@ -1883,7 +1900,7 @@ export const getPreviewOrderRefundUrl = (orderId, params) => {
         : `https://billing.leaflow.cloud/api/v1/orders/${encodeURIComponent(String(orderId))}/refund-preview`;
 };
 /**
- * What canceling the listed items, or the whole order, would refund to the original payment sources. Nothing is canceled or refunded.
+ * What canceling the listed items, or the whole order, would refund to the original payment sources. Nothing is canceled or refunded. Open to the owner of the order's billing account and to members of its project.
  * @summary Preview an order refund
  */
 export const previewOrderRefund = async (orderId, params, options, fetchFn) => {
@@ -1910,7 +1927,7 @@ export const getCancelOrderUrl = (orderId) => {
  * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`. Repeating the cancellation does not refund twice.
  *
  * An accepted order is canceled by its owning service, and delivered items through subscription cancellation.
- * Refunds are previewed with `preview-order-refund`.
+ * Refunds are previewed with `preview-order-refund`. Open to the owner of the order's billing account and to members of its project.
  * @summary Cancel order
  */
 export const cancelOrder = async (orderId, orderCancel, options, fetchFn) => {
@@ -1952,7 +1969,7 @@ export const getListOrderItemsUrl = (orderId, params) => {
         : `https://billing.leaflow.cloud/api/v1/orders/${encodeURIComponent(String(orderId))}/items`;
 };
 /**
- * One entry per item bought, with the price charged and the period it covers.
+ * One entry per item bought, with the price charged and the period it covers. Readable by whoever can read the order.
  * @summary List order items
  */
 export const listOrderItems = async (orderId, params, options, fetchFn) => {
@@ -1977,7 +1994,7 @@ export const getListEntitlementsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/entitlements`;
 };
 /**
- * Capabilities granted by live subscriptions and active feature grants. A capability not held is not listed, and one stops being listed when the subscription or grant providing it ends.
+ * Capabilities granted by live subscriptions and active feature grants; members of a project list its entitlements with `project_ids`. A capability not held is not listed, and one stops being listed when the subscription or grant providing it ends.
  * @summary List entitlements
  */
 export const listEntitlements = async (params, options, fetchFn) => {
@@ -2328,7 +2345,7 @@ export const getListActiveResourcesUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/active-resources`;
 };
 /**
- * Continuous metering registrations paid for by your billing accounts. Their state does not describe the resource's runtime. Project filters only narrow the result.
+ * Continuous metering registrations paid for by your billing accounts; members of a project list its registrations with `project_ids`. Their state does not describe the resource's runtime.
  * @summary List active resources
  */
 export const listActiveResources = async (params, options, fetchFn) => {
@@ -2358,6 +2375,9 @@ export const getListSpendUrl = (params) => {
  * closing are included. `from` and `to` must fall on UTC day boundaries and span at most 92 days.
  * Project filters use the account recorded on each charge, including charges for projects later
  * assigned to another account. The total covers all matching groups, not just the returned page.
+ *
+ * Open to the owner of the account and to members with the project permission `billing:cost.read` of each
+ * project in `project_ids`, which must then be given and currently assigned to the account.
  * @summary List account spend
  */
 export const listSpend = async (params, options, fetchFn) => {
@@ -2455,7 +2475,7 @@ export const getGetStatementUsageUrl = (statementId, params) => {
         : `https://billing.leaflow.cloud/api/v1/statements/${encodeURIComponent(String(statementId))}/usage-summary`;
 };
 /**
- * The statement's consumption, grouped by project, product or meter and filtered within the statement. Quantities are given only for meter groups; grouping by meter also splits by the meter's presentation dimensions.
+ * The statement's consumption, grouped by project, product or meter and filtered within the statement. Quantities are given only for meter groups; grouping by meter also splits by the meter's presentation dimensions. Open to the owner of the statement's account and to members with the project permission `billing:cost.read` of each project in `project_ids`, which must then be given and currently assigned to that account.
  * @summary Get grouped consumption
  */
 export const getStatementUsage = async (statementId, params, options, fetchFn) => {