@leaflow/sdk 0.0.0-dev.379.g796e6e7 → 0.0.0-dev.381.g84c72f5

package/dist/billing/v1/generated/functions.d.ts

@@ -2,7 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Leaflow Billing API
- * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * Products, prices, orders, subscriptions and account billing. Operations on a billing account require an account access token and ownership of the account. Members of a project, as each operation states, can also read the project's billing account, subscriptions and orders, complete and pay for its purchases, and, with project permissions granted in IAM, change its subscriptions (`billing:subscription.write`), change its billing account (`billing:project_assignment.write`) and read its costs (`billing:cost.read`). A member without the permission an operation needs is refused with 403 `PERMISSION_DENIED` and `meta.permission`; a caller who is not a member, with 403 `IAM_NOT_PROJECT_MEMBER`. Public catalogue operations declare no security requirement.
  * OpenAPI spec version: v1
  */
 import type { AccountBalance, AccountDeletionReadiness, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, CancellationPreviewRequest, CancellationRefundPreview, CheckoutSession, CheckoutSessionConfirm, CheckoutSessionCreate, CheckoutSessionItemList, CheckoutSessionList, CheckoutSessionResult, Contact, ContactCreate, ContactList, ContactUpdate, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, FeatureGrantList, GetCheckoutSessionQuoteParams, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, GetStatementUsageParams, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListCheckoutSessionItemsParams, ListCheckoutSessionsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListFeatureGrantsParams, ListInvoiceItemsParams, ListInvoicesParams, ListMonthlyStatementsParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, ListWithdrawalItemsParams, ListWithdrawalsParams, MonthlyStatementList, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, OrderRefundPreview, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, PreviewOrderRefundParams, Price, PriceList, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RateList, RefundList, RenewRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList, UsageEstimate, UsageEstimateRequest, Withdrawal, WithdrawalCreate, WithdrawalItemList, WithdrawalList, WithdrawalPreview, WithdrawalPreviewRequest } from "./models.js";
@@ -412,7 +412,7 @@ export type listPaymentOptionsResponseError = listPaymentOptionsResponseDefault
 export type listPaymentOptionsResponse = listPaymentOptionsResponseSuccess | listPaymentOptionsResponseError;
 export declare const getListPaymentOptionsUrl: (accountId: number, params?: ListPaymentOptionsParams) => string;
 /**
- * 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, with `project_id`, to members of a project the account is currently assigned to.
  * @summary List payment options
  */
 export declare const listPaymentOptions: (accountId: number, params?: ListPaymentOptionsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listPaymentOptionsResponse>;
@@ -480,7 +480,7 @@ export type getProjectAssignmentResponseError = getProjectAssignmentResponseDefa
 export type getProjectAssignmentResponse = getProjectAssignmentResponseSuccess | getProjectAssignmentResponseError;
 export declare const getGetProjectAssignmentUrl: (projectId: string) => string;
 /**
- * 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 declare const getProjectAssignment: (projectId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getProjectAssignmentResponse>;
@@ -501,7 +501,8 @@ export type setProjectAssignmentResponseError = setProjectAssignmentResponseDefa
 export type setProjectAssignmentResponse = setProjectAssignmentResponseSuccess | setProjectAssignmentResponseError;
 export declare const getSetProjectAssignmentUrl: (projectId: string) => string;
 /**
- * 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
@@ -528,7 +529,7 @@ export type unlinkProjectBillingAccountResponseError = unlinkProjectBillingAccou
 export type unlinkProjectBillingAccountResponse = unlinkProjectBillingAccountResponseSuccess | unlinkProjectBillingAccountResponseError;
 export declare const getUnlinkProjectBillingAccountUrl: (projectId: string) => string;
 /**
- * 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 declare const unlinkProjectBillingAccount: (projectId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<unlinkProjectBillingAccountResponse>;
@@ -747,6 +748,9 @@ export declare const getPayInvoiceUrl: (invoiceId: string) => string;
  * `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 declare const payInvoice: (invoiceId: string, payInvoiceRequest?: PayInvoiceRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<payInvoiceResponse>;
@@ -773,7 +777,7 @@ export declare const getPreviewInvoicePaymentUrl: (invoiceId: string, params?: P
  * 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 declare const previewInvoicePayment: (invoiceId: string, params?: PreviewInvoicePaymentParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<previewInvoicePaymentResponse>;
@@ -867,7 +871,7 @@ export type getInvoiceResponseError = getInvoiceResponseDefault & {
 export type getInvoiceResponse = getInvoiceResponseSuccess | getInvoiceResponseError;
 export declare const getGetInvoiceUrl: (invoiceId: string) => string;
 /**
- * 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 declare const getInvoice: (invoiceId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getInvoiceResponse>;
@@ -888,7 +892,7 @@ export type listInvoiceItemsResponseError = listInvoiceItemsResponseDefault & {
 export type listInvoiceItemsResponse = listInvoiceItemsResponseSuccess | listInvoiceItemsResponseError;
 export declare const getListInvoiceItemsUrl: (invoiceId: string, params?: ListInvoiceItemsParams) => string;
 /**
- * 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 declare const listInvoiceItems: (invoiceId: string, params?: ListInvoiceItemsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listInvoiceItemsResponse>;
@@ -1056,7 +1060,7 @@ export type listUsageChargesResponseError = listUsageChargesResponseDefault & {
 export type listUsageChargesResponse = listUsageChargesResponseSuccess | listUsageChargesResponseError;
 export declare const getListUsageChargesUrl: (params?: ListUsageChargesParams) => string;
 /**
- * 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 declare const listUsageCharges: (params?: ListUsageChargesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listUsageChargesResponse>;
@@ -1077,7 +1081,7 @@ export type listSubscriptionsResponseError = listSubscriptionsResponseDefault &
 export type listSubscriptionsResponse = listSubscriptionsResponseSuccess | listSubscriptionsResponseError;
 export declare const getListSubscriptionsUrl: (params?: ListSubscriptionsParams) => string;
 /**
- * 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 declare const listSubscriptions: (params?: ListSubscriptionsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listSubscriptionsResponse>;
@@ -1098,7 +1102,7 @@ export type getSubscriptionResponseError = getSubscriptionResponseDefault & {
 export type getSubscriptionResponse = getSubscriptionResponseSuccess | getSubscriptionResponseError;
 export declare const getGetSubscriptionUrl: (subscriptionId: string) => string;
 /**
- * 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 declare const getSubscription: (subscriptionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getSubscriptionResponse>;
@@ -1119,7 +1123,7 @@ export type deleteSubscriptionResponseError = deleteSubscriptionResponseDefault
 export type deleteSubscriptionResponse = deleteSubscriptionResponseSuccess | deleteSubscriptionResponseError;
 export declare const getDeleteSubscriptionUrl: (subscriptionId: string) => string;
 /**
- * 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 declare const deleteSubscription: (subscriptionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<deleteSubscriptionResponse>;
@@ -1141,8 +1145,9 @@ export type cancelSubscriptionResponse = cancelSubscriptionResponseSuccess | can
 export declare const getCancelSubscriptionUrl: (subscriptionId: string) => string;
 /**
  * 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
@@ -1172,10 +1177,12 @@ export declare const getGetQuoteUrl: () => string;
  * 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, with `project_id`, the current billing account of a project you
+ * are a member of; renewals then must be of the project's subscriptions and need the project permission
+ * `billing:subscription.write`. 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
@@ -1224,7 +1231,7 @@ export type listCancellationsResponseError = listCancellationsResponseDefault &
 export type listCancellationsResponse = listCancellationsResponseSuccess | listCancellationsResponseError;
 export declare const getListCancellationsUrl: (params?: ListCancellationsParams) => string;
 /**
- * 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 declare const listCancellations: (params?: ListCancellationsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCancellationsResponse>;
@@ -1250,7 +1257,9 @@ export type createCancellationResponse = createCancellationResponseSuccess | cre
 export declare const getCreateCancellationUrl: () => string;
 /**
  * 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
@@ -1299,7 +1308,7 @@ export type previewCancellationResponseError = previewCancellationResponseDefaul
 export type previewCancellationResponse = previewCancellationResponseSuccess | previewCancellationResponseError;
 export declare const getPreviewCancellationUrl: () => string;
 /**
- * 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 declare const previewCancellation: (cancellationPreviewRequest: CancellationPreviewRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<previewCancellationResponse>;
@@ -1320,7 +1329,7 @@ export type getCancellationResponseError = getCancellationResponseDefault & {
 export type getCancellationResponse = getCancellationResponseSuccess | getCancellationResponseError;
 export declare const getGetCancellationUrl: (cancellationId: string) => string;
 /**
- * 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 declare const getCancellation: (cancellationId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCancellationResponse>;
@@ -1341,7 +1350,7 @@ export type withdrawCancellationResponseError = withdrawCancellationResponseDefa
 export type withdrawCancellationResponse = withdrawCancellationResponseSuccess | withdrawCancellationResponseError;
 export declare const getWithdrawCancellationUrl: (cancellationId: string) => string;
 /**
- * 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 declare const withdrawCancellation: (cancellationId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<withdrawCancellationResponse>;
@@ -1362,7 +1371,7 @@ export type listRenewalPricesResponseError = listRenewalPricesResponseDefault &
 export type listRenewalPricesResponse = listRenewalPricesResponseSuccess | listRenewalPricesResponseError;
 export declare const getListRenewalPricesUrl: (subscriptionId: string, params?: ListRenewalPricesParams) => string;
 /**
- * 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 declare const listRenewalPrices: (subscriptionId: string, params?: ListRenewalPricesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listRenewalPricesResponse>;
@@ -1395,6 +1404,9 @@ export declare const getRenewSubscriptionUrl: (subscriptionId: string) => string
  * `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
  */
@@ -1416,7 +1428,7 @@ export type setAutoRenewResponseError = setAutoRenewResponseDefault & {
 export type setAutoRenewResponse = setAutoRenewResponseSuccess | setAutoRenewResponseError;
 export declare const getSetAutoRenewUrl: (subscriptionId: string) => string;
 /**
- * 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 declare const setAutoRenew: (subscriptionId: string, autoRenewSet: AutoRenewSet, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<setAutoRenewResponse>;
@@ -1437,7 +1449,7 @@ export type listAllowancesResponseError = listAllowancesResponseDefault & {
 export type listAllowancesResponse = listAllowancesResponseSuccess | listAllowancesResponseError;
 export declare const getListAllowancesUrl: (params?: ListAllowancesParams) => string;
 /**
- * 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 declare const listAllowances: (params?: ListAllowancesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listAllowancesResponse>;
@@ -1458,7 +1470,7 @@ export type listCheckoutSessionsResponseError = listCheckoutSessionsResponseDefa
 export type listCheckoutSessionsResponse = listCheckoutSessionsResponseSuccess | listCheckoutSessionsResponseError;
 export declare const getListCheckoutSessionsUrl: (params?: ListCheckoutSessionsParams) => string;
 /**
- * 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 declare const listCheckoutSessions: (params?: ListCheckoutSessionsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCheckoutSessionsResponse>;
@@ -1483,13 +1495,15 @@ export type createCheckoutSessionResponseError = (createCheckoutSessionResponse4
 export type createCheckoutSessionResponse = createCheckoutSessionResponseSuccess | createCheckoutSessionResponseError;
 export declare const getCreateCheckoutSessionUrl: () => string;
 /**
- * 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 declare const createCheckoutSession: (checkoutSessionCreate: CheckoutSessionCreate, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createCheckoutSessionResponse>;
@@ -1510,7 +1524,7 @@ export type getCheckoutSessionResponseError = getCheckoutSessionResponseDefault
 export type getCheckoutSessionResponse = getCheckoutSessionResponseSuccess | getCheckoutSessionResponseError;
 export declare const getGetCheckoutSessionUrl: (checkoutSessionId: string) => string;
 /**
- * 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 declare const getCheckoutSession: (checkoutSessionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCheckoutSessionResponse>;
@@ -1531,7 +1545,7 @@ export type listCheckoutSessionItemsResponseError = listCheckoutSessionItemsResp
 export type listCheckoutSessionItemsResponse = listCheckoutSessionItemsResponseSuccess | listCheckoutSessionItemsResponseError;
 export declare const getListCheckoutSessionItemsUrl: (checkoutSessionId: string, params?: ListCheckoutSessionItemsParams) => string;
 /**
- * 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 declare const listCheckoutSessionItems: (checkoutSessionId: string, params?: ListCheckoutSessionItemsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCheckoutSessionItemsResponse>;
@@ -1560,6 +1574,8 @@ export declare const getGetCheckoutSessionQuoteUrl: (checkoutSessionId: string,
  * 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 declare const getCheckoutSessionQuote: (checkoutSessionId: string, params?: GetCheckoutSessionQuoteParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCheckoutSessionQuoteResponse>;
@@ -1593,6 +1609,8 @@ export declare const getConfirmCheckoutSessionUrl: (checkoutSessionId: string) =
  * 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 declare const confirmCheckoutSession: (checkoutSessionId: string, checkoutSessionConfirm: CheckoutSessionConfirm, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<confirmCheckoutSessionResponse>;
@@ -1617,7 +1635,7 @@ export type expireCheckoutSessionResponseError = (expireCheckoutSessionResponse4
 export type expireCheckoutSessionResponse = expireCheckoutSessionResponseSuccess | expireCheckoutSessionResponseError;
 export declare const getExpireCheckoutSessionUrl: (checkoutSessionId: string) => string;
 /**
- * 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 declare const expireCheckoutSession: (checkoutSessionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<expireCheckoutSessionResponse>;
@@ -1638,7 +1656,7 @@ export type listOrdersResponseError = listOrdersResponseDefault & {
 export type listOrdersResponse = listOrdersResponseSuccess | listOrdersResponseError;
 export declare const getListOrdersUrl: (params?: ListOrdersParams) => string;
 /**
- * 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 declare const listOrders: (params?: ListOrdersParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listOrdersResponse>;
@@ -1659,7 +1677,7 @@ export type getOrderResponseError = getOrderResponseDefault & {
 export type getOrderResponse = getOrderResponseSuccess | getOrderResponseError;
 export declare const getGetOrderUrl: (orderId: string) => string;
 /**
- * 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 declare const getOrder: (orderId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getOrderResponse>;
@@ -1680,7 +1698,7 @@ export type previewOrderRefundResponseError = previewOrderRefundResponseDefault
 export type previewOrderRefundResponse = previewOrderRefundResponseSuccess | previewOrderRefundResponseError;
 export declare const getPreviewOrderRefundUrl: (orderId: string, params?: PreviewOrderRefundParams) => string;
 /**
- * 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 declare const previewOrderRefund: (orderId: string, params?: PreviewOrderRefundParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<previewOrderRefundResponse>;
@@ -1716,7 +1734,7 @@ export declare const getCancelOrderUrl: (orderId: string) => string;
  * `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 declare const cancelOrder: (orderId: string, orderCancel?: OrderCancel, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<cancelOrderResponse>;
@@ -1737,7 +1755,7 @@ export type listOrderItemsResponseError = listOrderItemsResponseDefault & {
 export type listOrderItemsResponse = listOrderItemsResponseSuccess | listOrderItemsResponseError;
 export declare const getListOrderItemsUrl: (orderId: string, params?: ListOrderItemsParams) => string;
 /**
- * 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 declare const listOrderItems: (orderId: string, params?: ListOrderItemsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listOrderItemsResponse>;
@@ -1758,7 +1776,7 @@ export type listEntitlementsResponseError = listEntitlementsResponseDefault & {
 export type listEntitlementsResponse = listEntitlementsResponseSuccess | listEntitlementsResponseError;
 export declare const getListEntitlementsUrl: (params?: ListEntitlementsParams) => string;
 /**
- * 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 declare const listEntitlements: (params?: ListEntitlementsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listEntitlementsResponse>;
@@ -2000,7 +2018,7 @@ export type listActiveResourcesResponseError = listActiveResourcesResponseDefaul
 export type listActiveResourcesResponse = listActiveResourcesResponseSuccess | listActiveResourcesResponseError;
 export declare const getListActiveResourcesUrl: (params?: ListActiveResourcesParams) => string;
 /**
- * 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 declare const listActiveResources: (params?: ListActiveResourcesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listActiveResourcesResponse>;
@@ -2026,6 +2044,9 @@ export declare const getListSpendUrl: (params: ListSpendParams) => string;
  * 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 declare const listSpend: (params: ListSpendParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listSpendResponse>;
@@ -2109,7 +2130,7 @@ export type getStatementUsageResponseError = getStatementUsageResponseDefault &
 export type getStatementUsageResponse = getStatementUsageResponseSuccess | getStatementUsageResponseError;
 export declare const getGetStatementUsageUrl: (statementId: string, params?: GetStatementUsageParams) => string;
 /**
- * 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 declare const getStatementUsage: (statementId: string, params?: GetStatementUsageParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getStatementUsageResponse>;