mixpeek 0.81.1

package/dist/api/organization-billing-api.d.ts

@@ -0,0 +1,651 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { Configuration } from '../configuration';
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import { type RequestArgs, BaseAPI } from '../base';
+import type { AutoBillingToggleResponse } from '../models';
+import type { BodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost } from '../models';
+import type { ConfirmPaymentMethodRequest } from '../models';
+import type { ConfirmPaymentMethodResponse } from '../models';
+import type { CreditBalanceResponse } from '../models';
+import type { CurrentUsageResponse } from '../models';
+import type { GetPaymentMethodResponse } from '../models';
+import type { InvoiceListResponse } from '../models';
+import type { SetupPaymentMethodResponse } from '../models';
+import type { SpendingCapsResponse } from '../models';
+import type { UpdateSpendingCapsRequest } from '../models';
+import type { UsageBreakdownResponse } from '../models';
+/**
+ * OrganizationBillingApi - axios parameter creator
+ * @export
+ */
+export declare const OrganizationBillingApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Confirm payment method after frontend collects it.  After Stripe Elements confirms the SetupIntent, call this endpoint to attach the payment method to the customer and enable auto-billing.  **Requirements:** - Admin permission - Must have called setup-payment-method first  **Example:** ```python # After Stripe Elements confirms setup response = await client.post(     \"/v1/organizations/billing/confirm-payment-method\",     json={\"payment_method_id\": \"pm_1ABC2DEF3GHI\"} ) ```
+     * @summary Confirm Payment Method
+     * @param {ConfirmPaymentMethodRequest} confirmPaymentMethodRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \'Bearer sk_xxxxxxxxxxxxx\'. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    confirmPaymentMethodOrganizationsBilling: (confirmPaymentMethodRequest: ConfirmPaymentMethodRequest, authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Disable automatic monthly billing.  Disables automatic billing but keeps payment method saved. Organization can re-enable later or pay invoices manually.  **Requirements:** - Admin permission  **Example:** ```python response = await client.post(\"/v1/organizations/billing/disable-auto-billing\") ```
+     * @summary Disable Auto Billing
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    disableAutoBillingOrganizations: (authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Enable automatic monthly billing.  Re-enables automatic billing if it was previously disabled. Payment method must already be saved.  **Requirements:** - Admin permission - Must have payment method saved  **Example:** ```python response = await client.post(\"/v1/organizations/billing/enable-auto-billing\") ```
+     * @summary Enable Auto Billing
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    enableAutoBillingOrganizations: (authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Manually trigger invoice generation for this organization.  Useful for testing the billing flow or generating retroactive invoices. Requires ADMIN permission.  **Example:** ```python # Dry run response = await client.post(     \"/v1/organizations/billing/generate-invoice\",     json={\"dry_run\": true} )  # Actually generate response = await client.post(     \"/v1/organizations/billing/generate-invoice\",     json={\"billing_month\": \"2026-01\"} ) ```
+     * @summary Generate Invoice Now
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {BodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost} [bodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    generateInvoiceNowOrganizationsBilling: (authorization?: string, bodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost?: BodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Get current credit balance and tier information.  Returns the organization\'s credit balance, current tier, and usage statistics. Useful for displaying billing status in dashboards.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/balance\") print(f\"Balance: {response[\'credit_balance\']} credits\") print(f\"Tier: {response[\'account_tier\']}\") ```
+     * @summary Get Credit Balance
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getCreditBalanceOrganizationsBilling: (authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Get current month usage.  Returns credit consumption for the current billing period, estimated cost, and next invoice date.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/usage/current\") print(f\"Usage: {response[\'current_month_usage\']} credits\") print(f\"Estimated cost: ${response[\'estimated_cost_usd\']}\") ```
+     * @summary Get Current Usage
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getCurrentUsageOrganizationsBilling: (authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Get current payment method.  Returns the saved payment method details (last 4 digits, brand) and auto-billing status.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/payment-method\") if response[\"has_payment_method\"]:     print(f\"Card: {response[\'payment_method\'][\'card_brand\']} ****{response[\'payment_method\'][\'card_last4\']}\") ```
+     * @summary Get Payment Method
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPaymentMethodOrganizationsBilling: (authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Get current spending cap configuration.  Returns spending cap settings including budget limits, alert thresholds, and current spending status.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/spending-caps\") print(f\"Monthly budget: ${response[\'monthly_spending_budget_usd\']}\") print(f\"Hard cap enabled: {response[\'hard_cap_enabled\']}\") print(f\"Current spending: ${response[\'current_spending_usd\']}\") ```
+     * @summary Get Spending Caps
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSpendingCapsOrganizationsBilling: (authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Get detailed usage breakdown.  Returns usage breakdown by operation type and extractor for the specified billing period.  **Query Parameters:** - `billing_month`: Month to query (YYYY-MM format, defaults to current)  **Requirements:** - Read permission  **Example:** ```python # Current month response = await client.get(\"/v1/organizations/billing/usage/breakdown\")  # Specific month response = await client.get(     \"/v1/organizations/billing/usage/breakdown\",     params={\"billing_month\": \"2025-11\"} ) ```
+     * @summary Get Usage Breakdown
+     * @param {string} [billingMonth] Billing month in YYYY-MM format (defaults to current month)
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getUsageBreakdownOrganizationsBilling: (billingMonth?: string, authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * List monthly invoices.  Returns paginated list of monthly invoices with links to Stripe-hosted invoice pages.  **Query Parameters:** - `limit`: Number of invoices (1-100, default 10)  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/invoices?limit=10\") for invoice in response[\"invoices\"]:     print(f\"{invoice[\'billing_month\']}: ${invoice[\'amount_paid\']/100}\") ```
+     * @summary List Invoices
+     * @param {number} [limit] Number of invoices to return
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listInvoicesOrganizationsBilling: (limit?: number, authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Initialize payment method setup flow.  Creates a Stripe SetupIntent for collecting payment method without charging. The client_secret should be used with Stripe Elements on the frontend.  **Flow:** 1. Frontend calls this endpoint 2. Backend creates Stripe Customer (if needed) and SetupIntent 3. Frontend uses client_secret with Stripe Elements 4. User enters card details 5. Frontend calls confirm-payment-method endpoint  **Requirements:** - Admin permission (only org admins can set up payment methods)  **Example:** ```python response = await client.post(\"/v1/organizations/billing/setup-payment-method\") client_secret = response[\"client_secret\"] # Use client_secret with Stripe Elements ```
+     * @summary Setup Payment Method
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    setupPaymentMethodOrganizationsBilling: (authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Update spending cap configuration.  Configure spending limits and alert thresholds to control costs.  **Features:** - **Soft Limit (Budget)**: Triggers alerts but doesn\'t block API access - **Hard Cap**: Blocks API access when reached (requires explicit enable) - **Alert Thresholds**: Customize when to receive spending notifications  **Requirements:** - Admin permission - Only applies to organizations with auto-billing enabled  **Example:** ```python # Set $100 budget with alerts at 75% and 100% response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"monthly_spending_budget\": 10000,  # $100 in cents         \"spending_alert_thresholds\": [75, 100],         \"spending_alerts_enabled\": True,     } )  # Enable hard cap at $500 response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"hard_spending_cap\": 50000,  # $500 in cents         \"hard_cap_enabled\": True,     } )  # Disable all spending limits response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"monthly_spending_budget\": None,         \"hard_spending_cap\": None,         \"hard_cap_enabled\": False,     } ) ```
+     * @summary Update Spending Caps
+     * @param {UpdateSpendingCapsRequest} updateSpendingCapsRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateSpendingCapsOrganizationsBilling: (updateSpendingCapsRequest: UpdateSpendingCapsRequest, authorization?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * OrganizationBillingApi - functional programming interface
+ * @export
+ */
+export declare const OrganizationBillingApiFp: (configuration?: Configuration) => {
+    /**
+     * Confirm payment method after frontend collects it.  After Stripe Elements confirms the SetupIntent, call this endpoint to attach the payment method to the customer and enable auto-billing.  **Requirements:** - Admin permission - Must have called setup-payment-method first  **Example:** ```python # After Stripe Elements confirms setup response = await client.post(     \"/v1/organizations/billing/confirm-payment-method\",     json={\"payment_method_id\": \"pm_1ABC2DEF3GHI\"} ) ```
+     * @summary Confirm Payment Method
+     * @param {ConfirmPaymentMethodRequest} confirmPaymentMethodRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    confirmPaymentMethodOrganizationsBilling(confirmPaymentMethodRequest: ConfirmPaymentMethodRequest, authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConfirmPaymentMethodResponse>>;
+    /**
+     * Disable automatic monthly billing.  Disables automatic billing but keeps payment method saved. Organization can re-enable later or pay invoices manually.  **Requirements:** - Admin permission  **Example:** ```python response = await client.post(\"/v1/organizations/billing/disable-auto-billing\") ```
+     * @summary Disable Auto Billing
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    disableAutoBillingOrganizations(authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AutoBillingToggleResponse>>;
+    /**
+     * Enable automatic monthly billing.  Re-enables automatic billing if it was previously disabled. Payment method must already be saved.  **Requirements:** - Admin permission - Must have payment method saved  **Example:** ```python response = await client.post(\"/v1/organizations/billing/enable-auto-billing\") ```
+     * @summary Enable Auto Billing
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    enableAutoBillingOrganizations(authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AutoBillingToggleResponse>>;
+    /**
+     * Manually trigger invoice generation for this organization.  Useful for testing the billing flow or generating retroactive invoices. Requires ADMIN permission.  **Example:** ```python # Dry run response = await client.post(     \"/v1/organizations/billing/generate-invoice\",     json={\"dry_run\": true} )  # Actually generate response = await client.post(     \"/v1/organizations/billing/generate-invoice\",     json={\"billing_month\": \"2026-01\"} ) ```
+     * @summary Generate Invoice Now
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {BodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost} [bodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    generateInvoiceNowOrganizationsBilling(authorization?: string, bodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost?: BodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<{
+        [key: string]: any;
+    }>>;
+    /**
+     * Get current credit balance and tier information.  Returns the organization\'s credit balance, current tier, and usage statistics. Useful for displaying billing status in dashboards.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/balance\") print(f\"Balance: {response[\'credit_balance\']} credits\") print(f\"Tier: {response[\'account_tier\']}\") ```
+     * @summary Get Credit Balance
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getCreditBalanceOrganizationsBilling(authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CreditBalanceResponse>>;
+    /**
+     * Get current month usage.  Returns credit consumption for the current billing period, estimated cost, and next invoice date.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/usage/current\") print(f\"Usage: {response[\'current_month_usage\']} credits\") print(f\"Estimated cost: ${response[\'estimated_cost_usd\']}\") ```
+     * @summary Get Current Usage
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getCurrentUsageOrganizationsBilling(authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CurrentUsageResponse>>;
+    /**
+     * Get current payment method.  Returns the saved payment method details (last 4 digits, brand) and auto-billing status.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/payment-method\") if response[\"has_payment_method\"]:     print(f\"Card: {response[\'payment_method\'][\'card_brand\']} ****{response[\'payment_method\'][\'card_last4\']}\") ```
+     * @summary Get Payment Method
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPaymentMethodOrganizationsBilling(authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetPaymentMethodResponse>>;
+    /**
+     * Get current spending cap configuration.  Returns spending cap settings including budget limits, alert thresholds, and current spending status.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/spending-caps\") print(f\"Monthly budget: ${response[\'monthly_spending_budget_usd\']}\") print(f\"Hard cap enabled: {response[\'hard_cap_enabled\']}\") print(f\"Current spending: ${response[\'current_spending_usd\']}\") ```
+     * @summary Get Spending Caps
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSpendingCapsOrganizationsBilling(authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SpendingCapsResponse>>;
+    /**
+     * Get detailed usage breakdown.  Returns usage breakdown by operation type and extractor for the specified billing period.  **Query Parameters:** - `billing_month`: Month to query (YYYY-MM format, defaults to current)  **Requirements:** - Read permission  **Example:** ```python # Current month response = await client.get(\"/v1/organizations/billing/usage/breakdown\")  # Specific month response = await client.get(     \"/v1/organizations/billing/usage/breakdown\",     params={\"billing_month\": \"2025-11\"} ) ```
+     * @summary Get Usage Breakdown
+     * @param {string} [billingMonth] Billing month in YYYY-MM format (defaults to current month)
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getUsageBreakdownOrganizationsBilling(billingMonth?: string, authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<UsageBreakdownResponse>>;
+    /**
+     * List monthly invoices.  Returns paginated list of monthly invoices with links to Stripe-hosted invoice pages.  **Query Parameters:** - `limit`: Number of invoices (1-100, default 10)  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/invoices?limit=10\") for invoice in response[\"invoices\"]:     print(f\"{invoice[\'billing_month\']}: ${invoice[\'amount_paid\']/100}\") ```
+     * @summary List Invoices
+     * @param {number} [limit] Number of invoices to return
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listInvoicesOrganizationsBilling(limit?: number, authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InvoiceListResponse>>;
+    /**
+     * Initialize payment method setup flow.  Creates a Stripe SetupIntent for collecting payment method without charging. The client_secret should be used with Stripe Elements on the frontend.  **Flow:** 1. Frontend calls this endpoint 2. Backend creates Stripe Customer (if needed) and SetupIntent 3. Frontend uses client_secret with Stripe Elements 4. User enters card details 5. Frontend calls confirm-payment-method endpoint  **Requirements:** - Admin permission (only org admins can set up payment methods)  **Example:** ```python response = await client.post(\"/v1/organizations/billing/setup-payment-method\") client_secret = response[\"client_secret\"] # Use client_secret with Stripe Elements ```
+     * @summary Setup Payment Method
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    setupPaymentMethodOrganizationsBilling(authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SetupPaymentMethodResponse>>;
+    /**
+     * Update spending cap configuration.  Configure spending limits and alert thresholds to control costs.  **Features:** - **Soft Limit (Budget)**: Triggers alerts but doesn\'t block API access - **Hard Cap**: Blocks API access when reached (requires explicit enable) - **Alert Thresholds**: Customize when to receive spending notifications  **Requirements:** - Admin permission - Only applies to organizations with auto-billing enabled  **Example:** ```python # Set $100 budget with alerts at 75% and 100% response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"monthly_spending_budget\": 10000,  # $100 in cents         \"spending_alert_thresholds\": [75, 100],         \"spending_alerts_enabled\": True,     } )  # Enable hard cap at $500 response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"hard_spending_cap\": 50000,  # $500 in cents         \"hard_cap_enabled\": True,     } )  # Disable all spending limits response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"monthly_spending_budget\": None,         \"hard_spending_cap\": None,         \"hard_cap_enabled\": False,     } ) ```
+     * @summary Update Spending Caps
+     * @param {UpdateSpendingCapsRequest} updateSpendingCapsRequest
+     * @param {string} [authorization] REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateSpendingCapsOrganizationsBilling(updateSpendingCapsRequest: UpdateSpendingCapsRequest, authorization?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SpendingCapsResponse>>;
+};
+/**
+ * OrganizationBillingApi - factory interface
+ * @export
+ */
+export declare const OrganizationBillingApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Confirm payment method after frontend collects it.  After Stripe Elements confirms the SetupIntent, call this endpoint to attach the payment method to the customer and enable auto-billing.  **Requirements:** - Admin permission - Must have called setup-payment-method first  **Example:** ```python # After Stripe Elements confirms setup response = await client.post(     \"/v1/organizations/billing/confirm-payment-method\",     json={\"payment_method_id\": \"pm_1ABC2DEF3GHI\"} ) ```
+     * @summary Confirm Payment Method
+     * @param {OrganizationBillingApiConfirmPaymentMethodOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    confirmPaymentMethodOrganizationsBilling(requestParameters: OrganizationBillingApiConfirmPaymentMethodOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<ConfirmPaymentMethodResponse>;
+    /**
+     * Disable automatic monthly billing.  Disables automatic billing but keeps payment method saved. Organization can re-enable later or pay invoices manually.  **Requirements:** - Admin permission  **Example:** ```python response = await client.post(\"/v1/organizations/billing/disable-auto-billing\") ```
+     * @summary Disable Auto Billing
+     * @param {OrganizationBillingApiDisableAutoBillingOrganizationsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    disableAutoBillingOrganizations(requestParameters?: OrganizationBillingApiDisableAutoBillingOrganizationsRequest, options?: RawAxiosRequestConfig): AxiosPromise<AutoBillingToggleResponse>;
+    /**
+     * Enable automatic monthly billing.  Re-enables automatic billing if it was previously disabled. Payment method must already be saved.  **Requirements:** - Admin permission - Must have payment method saved  **Example:** ```python response = await client.post(\"/v1/organizations/billing/enable-auto-billing\") ```
+     * @summary Enable Auto Billing
+     * @param {OrganizationBillingApiEnableAutoBillingOrganizationsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    enableAutoBillingOrganizations(requestParameters?: OrganizationBillingApiEnableAutoBillingOrganizationsRequest, options?: RawAxiosRequestConfig): AxiosPromise<AutoBillingToggleResponse>;
+    /**
+     * Manually trigger invoice generation for this organization.  Useful for testing the billing flow or generating retroactive invoices. Requires ADMIN permission.  **Example:** ```python # Dry run response = await client.post(     \"/v1/organizations/billing/generate-invoice\",     json={\"dry_run\": true} )  # Actually generate response = await client.post(     \"/v1/organizations/billing/generate-invoice\",     json={\"billing_month\": \"2026-01\"} ) ```
+     * @summary Generate Invoice Now
+     * @param {OrganizationBillingApiGenerateInvoiceNowOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    generateInvoiceNowOrganizationsBilling(requestParameters?: OrganizationBillingApiGenerateInvoiceNowOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<{
+        [key: string]: any;
+    }>;
+    /**
+     * Get current credit balance and tier information.  Returns the organization\'s credit balance, current tier, and usage statistics. Useful for displaying billing status in dashboards.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/balance\") print(f\"Balance: {response[\'credit_balance\']} credits\") print(f\"Tier: {response[\'account_tier\']}\") ```
+     * @summary Get Credit Balance
+     * @param {OrganizationBillingApiGetCreditBalanceOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getCreditBalanceOrganizationsBilling(requestParameters?: OrganizationBillingApiGetCreditBalanceOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<CreditBalanceResponse>;
+    /**
+     * Get current month usage.  Returns credit consumption for the current billing period, estimated cost, and next invoice date.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/usage/current\") print(f\"Usage: {response[\'current_month_usage\']} credits\") print(f\"Estimated cost: ${response[\'estimated_cost_usd\']}\") ```
+     * @summary Get Current Usage
+     * @param {OrganizationBillingApiGetCurrentUsageOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getCurrentUsageOrganizationsBilling(requestParameters?: OrganizationBillingApiGetCurrentUsageOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<CurrentUsageResponse>;
+    /**
+     * Get current payment method.  Returns the saved payment method details (last 4 digits, brand) and auto-billing status.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/payment-method\") if response[\"has_payment_method\"]:     print(f\"Card: {response[\'payment_method\'][\'card_brand\']} ****{response[\'payment_method\'][\'card_last4\']}\") ```
+     * @summary Get Payment Method
+     * @param {OrganizationBillingApiGetPaymentMethodOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getPaymentMethodOrganizationsBilling(requestParameters?: OrganizationBillingApiGetPaymentMethodOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<GetPaymentMethodResponse>;
+    /**
+     * Get current spending cap configuration.  Returns spending cap settings including budget limits, alert thresholds, and current spending status.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/spending-caps\") print(f\"Monthly budget: ${response[\'monthly_spending_budget_usd\']}\") print(f\"Hard cap enabled: {response[\'hard_cap_enabled\']}\") print(f\"Current spending: ${response[\'current_spending_usd\']}\") ```
+     * @summary Get Spending Caps
+     * @param {OrganizationBillingApiGetSpendingCapsOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getSpendingCapsOrganizationsBilling(requestParameters?: OrganizationBillingApiGetSpendingCapsOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<SpendingCapsResponse>;
+    /**
+     * Get detailed usage breakdown.  Returns usage breakdown by operation type and extractor for the specified billing period.  **Query Parameters:** - `billing_month`: Month to query (YYYY-MM format, defaults to current)  **Requirements:** - Read permission  **Example:** ```python # Current month response = await client.get(\"/v1/organizations/billing/usage/breakdown\")  # Specific month response = await client.get(     \"/v1/organizations/billing/usage/breakdown\",     params={\"billing_month\": \"2025-11\"} ) ```
+     * @summary Get Usage Breakdown
+     * @param {OrganizationBillingApiGetUsageBreakdownOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getUsageBreakdownOrganizationsBilling(requestParameters?: OrganizationBillingApiGetUsageBreakdownOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<UsageBreakdownResponse>;
+    /**
+     * List monthly invoices.  Returns paginated list of monthly invoices with links to Stripe-hosted invoice pages.  **Query Parameters:** - `limit`: Number of invoices (1-100, default 10)  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/invoices?limit=10\") for invoice in response[\"invoices\"]:     print(f\"{invoice[\'billing_month\']}: ${invoice[\'amount_paid\']/100}\") ```
+     * @summary List Invoices
+     * @param {OrganizationBillingApiListInvoicesOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listInvoicesOrganizationsBilling(requestParameters?: OrganizationBillingApiListInvoicesOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<InvoiceListResponse>;
+    /**
+     * Initialize payment method setup flow.  Creates a Stripe SetupIntent for collecting payment method without charging. The client_secret should be used with Stripe Elements on the frontend.  **Flow:** 1. Frontend calls this endpoint 2. Backend creates Stripe Customer (if needed) and SetupIntent 3. Frontend uses client_secret with Stripe Elements 4. User enters card details 5. Frontend calls confirm-payment-method endpoint  **Requirements:** - Admin permission (only org admins can set up payment methods)  **Example:** ```python response = await client.post(\"/v1/organizations/billing/setup-payment-method\") client_secret = response[\"client_secret\"] # Use client_secret with Stripe Elements ```
+     * @summary Setup Payment Method
+     * @param {OrganizationBillingApiSetupPaymentMethodOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    setupPaymentMethodOrganizationsBilling(requestParameters?: OrganizationBillingApiSetupPaymentMethodOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<SetupPaymentMethodResponse>;
+    /**
+     * Update spending cap configuration.  Configure spending limits and alert thresholds to control costs.  **Features:** - **Soft Limit (Budget)**: Triggers alerts but doesn\'t block API access - **Hard Cap**: Blocks API access when reached (requires explicit enable) - **Alert Thresholds**: Customize when to receive spending notifications  **Requirements:** - Admin permission - Only applies to organizations with auto-billing enabled  **Example:** ```python # Set $100 budget with alerts at 75% and 100% response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"monthly_spending_budget\": 10000,  # $100 in cents         \"spending_alert_thresholds\": [75, 100],         \"spending_alerts_enabled\": True,     } )  # Enable hard cap at $500 response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"hard_spending_cap\": 50000,  # $500 in cents         \"hard_cap_enabled\": True,     } )  # Disable all spending limits response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"monthly_spending_budget\": None,         \"hard_spending_cap\": None,         \"hard_cap_enabled\": False,     } ) ```
+     * @summary Update Spending Caps
+     * @param {OrganizationBillingApiUpdateSpendingCapsOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateSpendingCapsOrganizationsBilling(requestParameters: OrganizationBillingApiUpdateSpendingCapsOrganizationsBillingRequest, options?: RawAxiosRequestConfig): AxiosPromise<SpendingCapsResponse>;
+};
+/**
+ * Request parameters for confirmPaymentMethodOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiConfirmPaymentMethodOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiConfirmPaymentMethodOrganizationsBillingRequest {
+    /**
+     *
+     * @type {ConfirmPaymentMethodRequest}
+     * @memberof OrganizationBillingApiConfirmPaymentMethodOrganizationsBilling
+     */
+    readonly confirmPaymentMethodRequest: ConfirmPaymentMethodRequest;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiConfirmPaymentMethodOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for disableAutoBillingOrganizations operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiDisableAutoBillingOrganizationsRequest
+ */
+export interface OrganizationBillingApiDisableAutoBillingOrganizationsRequest {
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiDisableAutoBillingOrganizations
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for enableAutoBillingOrganizations operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiEnableAutoBillingOrganizationsRequest
+ */
+export interface OrganizationBillingApiEnableAutoBillingOrganizationsRequest {
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiEnableAutoBillingOrganizations
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for generateInvoiceNowOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiGenerateInvoiceNowOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiGenerateInvoiceNowOrganizationsBillingRequest {
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiGenerateInvoiceNowOrganizationsBilling
+     */
+    readonly authorization?: string;
+    /**
+     *
+     * @type {BodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost}
+     * @memberof OrganizationBillingApiGenerateInvoiceNowOrganizationsBilling
+     */
+    readonly bodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost?: BodyGenerateInvoiceNowV1OrganizationsBillingGenerateInvoicePost;
+}
+/**
+ * Request parameters for getCreditBalanceOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiGetCreditBalanceOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiGetCreditBalanceOrganizationsBillingRequest {
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiGetCreditBalanceOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for getCurrentUsageOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiGetCurrentUsageOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiGetCurrentUsageOrganizationsBillingRequest {
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiGetCurrentUsageOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for getPaymentMethodOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiGetPaymentMethodOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiGetPaymentMethodOrganizationsBillingRequest {
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiGetPaymentMethodOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for getSpendingCapsOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiGetSpendingCapsOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiGetSpendingCapsOrganizationsBillingRequest {
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiGetSpendingCapsOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for getUsageBreakdownOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiGetUsageBreakdownOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiGetUsageBreakdownOrganizationsBillingRequest {
+    /**
+     * Billing month in YYYY-MM format (defaults to current month)
+     * @type {string}
+     * @memberof OrganizationBillingApiGetUsageBreakdownOrganizationsBilling
+     */
+    readonly billingMonth?: string;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiGetUsageBreakdownOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for listInvoicesOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiListInvoicesOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiListInvoicesOrganizationsBillingRequest {
+    /**
+     * Number of invoices to return
+     * @type {number}
+     * @memberof OrganizationBillingApiListInvoicesOrganizationsBilling
+     */
+    readonly limit?: number;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiListInvoicesOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for setupPaymentMethodOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiSetupPaymentMethodOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiSetupPaymentMethodOrganizationsBillingRequest {
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiSetupPaymentMethodOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * Request parameters for updateSpendingCapsOrganizationsBilling operation in OrganizationBillingApi.
+ * @export
+ * @interface OrganizationBillingApiUpdateSpendingCapsOrganizationsBillingRequest
+ */
+export interface OrganizationBillingApiUpdateSpendingCapsOrganizationsBillingRequest {
+    /**
+     *
+     * @type {UpdateSpendingCapsRequest}
+     * @memberof OrganizationBillingApiUpdateSpendingCapsOrganizationsBilling
+     */
+    readonly updateSpendingCapsRequest: UpdateSpendingCapsRequest;
+    /**
+     * REQUIRED: Bearer token authentication using your API key. Format: \&#39;Bearer sk_xxxxxxxxxxxxx\&#39;. You can create API keys in the Mixpeek dashboard under Organization Settings.
+     * @type {string}
+     * @memberof OrganizationBillingApiUpdateSpendingCapsOrganizationsBilling
+     */
+    readonly authorization?: string;
+}
+/**
+ * OrganizationBillingApi - object-oriented interface
+ * @export
+ * @class OrganizationBillingApi
+ * @extends {BaseAPI}
+ */
+export declare class OrganizationBillingApi extends BaseAPI {
+    /**
+     * Confirm payment method after frontend collects it.  After Stripe Elements confirms the SetupIntent, call this endpoint to attach the payment method to the customer and enable auto-billing.  **Requirements:** - Admin permission - Must have called setup-payment-method first  **Example:** ```python # After Stripe Elements confirms setup response = await client.post(     \"/v1/organizations/billing/confirm-payment-method\",     json={\"payment_method_id\": \"pm_1ABC2DEF3GHI\"} ) ```
+     * @summary Confirm Payment Method
+     * @param {OrganizationBillingApiConfirmPaymentMethodOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    confirmPaymentMethodOrganizationsBilling(requestParameters: OrganizationBillingApiConfirmPaymentMethodOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ConfirmPaymentMethodResponse, any, {}>>;
+    /**
+     * Disable automatic monthly billing.  Disables automatic billing but keeps payment method saved. Organization can re-enable later or pay invoices manually.  **Requirements:** - Admin permission  **Example:** ```python response = await client.post(\"/v1/organizations/billing/disable-auto-billing\") ```
+     * @summary Disable Auto Billing
+     * @param {OrganizationBillingApiDisableAutoBillingOrganizationsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    disableAutoBillingOrganizations(requestParameters?: OrganizationBillingApiDisableAutoBillingOrganizationsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AutoBillingToggleResponse, any, {}>>;
+    /**
+     * Enable automatic monthly billing.  Re-enables automatic billing if it was previously disabled. Payment method must already be saved.  **Requirements:** - Admin permission - Must have payment method saved  **Example:** ```python response = await client.post(\"/v1/organizations/billing/enable-auto-billing\") ```
+     * @summary Enable Auto Billing
+     * @param {OrganizationBillingApiEnableAutoBillingOrganizationsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    enableAutoBillingOrganizations(requestParameters?: OrganizationBillingApiEnableAutoBillingOrganizationsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AutoBillingToggleResponse, any, {}>>;
+    /**
+     * Manually trigger invoice generation for this organization.  Useful for testing the billing flow or generating retroactive invoices. Requires ADMIN permission.  **Example:** ```python # Dry run response = await client.post(     \"/v1/organizations/billing/generate-invoice\",     json={\"dry_run\": true} )  # Actually generate response = await client.post(     \"/v1/organizations/billing/generate-invoice\",     json={\"billing_month\": \"2026-01\"} ) ```
+     * @summary Generate Invoice Now
+     * @param {OrganizationBillingApiGenerateInvoiceNowOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    generateInvoiceNowOrganizationsBilling(requestParameters?: OrganizationBillingApiGenerateInvoiceNowOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<{
+        [key: string]: any;
+    }, any, {}>>;
+    /**
+     * Get current credit balance and tier information.  Returns the organization\'s credit balance, current tier, and usage statistics. Useful for displaying billing status in dashboards.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/balance\") print(f\"Balance: {response[\'credit_balance\']} credits\") print(f\"Tier: {response[\'account_tier\']}\") ```
+     * @summary Get Credit Balance
+     * @param {OrganizationBillingApiGetCreditBalanceOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    getCreditBalanceOrganizationsBilling(requestParameters?: OrganizationBillingApiGetCreditBalanceOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CreditBalanceResponse, any, {}>>;
+    /**
+     * Get current month usage.  Returns credit consumption for the current billing period, estimated cost, and next invoice date.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/usage/current\") print(f\"Usage: {response[\'current_month_usage\']} credits\") print(f\"Estimated cost: ${response[\'estimated_cost_usd\']}\") ```
+     * @summary Get Current Usage
+     * @param {OrganizationBillingApiGetCurrentUsageOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    getCurrentUsageOrganizationsBilling(requestParameters?: OrganizationBillingApiGetCurrentUsageOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<CurrentUsageResponse, any, {}>>;
+    /**
+     * Get current payment method.  Returns the saved payment method details (last 4 digits, brand) and auto-billing status.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/payment-method\") if response[\"has_payment_method\"]:     print(f\"Card: {response[\'payment_method\'][\'card_brand\']} ****{response[\'payment_method\'][\'card_last4\']}\") ```
+     * @summary Get Payment Method
+     * @param {OrganizationBillingApiGetPaymentMethodOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    getPaymentMethodOrganizationsBilling(requestParameters?: OrganizationBillingApiGetPaymentMethodOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GetPaymentMethodResponse, any, {}>>;
+    /**
+     * Get current spending cap configuration.  Returns spending cap settings including budget limits, alert thresholds, and current spending status.  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/spending-caps\") print(f\"Monthly budget: ${response[\'monthly_spending_budget_usd\']}\") print(f\"Hard cap enabled: {response[\'hard_cap_enabled\']}\") print(f\"Current spending: ${response[\'current_spending_usd\']}\") ```
+     * @summary Get Spending Caps
+     * @param {OrganizationBillingApiGetSpendingCapsOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    getSpendingCapsOrganizationsBilling(requestParameters?: OrganizationBillingApiGetSpendingCapsOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SpendingCapsResponse, any, {}>>;
+    /**
+     * Get detailed usage breakdown.  Returns usage breakdown by operation type and extractor for the specified billing period.  **Query Parameters:** - `billing_month`: Month to query (YYYY-MM format, defaults to current)  **Requirements:** - Read permission  **Example:** ```python # Current month response = await client.get(\"/v1/organizations/billing/usage/breakdown\")  # Specific month response = await client.get(     \"/v1/organizations/billing/usage/breakdown\",     params={\"billing_month\": \"2025-11\"} ) ```
+     * @summary Get Usage Breakdown
+     * @param {OrganizationBillingApiGetUsageBreakdownOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    getUsageBreakdownOrganizationsBilling(requestParameters?: OrganizationBillingApiGetUsageBreakdownOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<UsageBreakdownResponse, any, {}>>;
+    /**
+     * List monthly invoices.  Returns paginated list of monthly invoices with links to Stripe-hosted invoice pages.  **Query Parameters:** - `limit`: Number of invoices (1-100, default 10)  **Requirements:** - Read permission  **Example:** ```python response = await client.get(\"/v1/organizations/billing/invoices?limit=10\") for invoice in response[\"invoices\"]:     print(f\"{invoice[\'billing_month\']}: ${invoice[\'amount_paid\']/100}\") ```
+     * @summary List Invoices
+     * @param {OrganizationBillingApiListInvoicesOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    listInvoicesOrganizationsBilling(requestParameters?: OrganizationBillingApiListInvoicesOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<InvoiceListResponse, any, {}>>;
+    /**
+     * Initialize payment method setup flow.  Creates a Stripe SetupIntent for collecting payment method without charging. The client_secret should be used with Stripe Elements on the frontend.  **Flow:** 1. Frontend calls this endpoint 2. Backend creates Stripe Customer (if needed) and SetupIntent 3. Frontend uses client_secret with Stripe Elements 4. User enters card details 5. Frontend calls confirm-payment-method endpoint  **Requirements:** - Admin permission (only org admins can set up payment methods)  **Example:** ```python response = await client.post(\"/v1/organizations/billing/setup-payment-method\") client_secret = response[\"client_secret\"] # Use client_secret with Stripe Elements ```
+     * @summary Setup Payment Method
+     * @param {OrganizationBillingApiSetupPaymentMethodOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    setupPaymentMethodOrganizationsBilling(requestParameters?: OrganizationBillingApiSetupPaymentMethodOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SetupPaymentMethodResponse, any, {}>>;
+    /**
+     * Update spending cap configuration.  Configure spending limits and alert thresholds to control costs.  **Features:** - **Soft Limit (Budget)**: Triggers alerts but doesn\'t block API access - **Hard Cap**: Blocks API access when reached (requires explicit enable) - **Alert Thresholds**: Customize when to receive spending notifications  **Requirements:** - Admin permission - Only applies to organizations with auto-billing enabled  **Example:** ```python # Set $100 budget with alerts at 75% and 100% response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"monthly_spending_budget\": 10000,  # $100 in cents         \"spending_alert_thresholds\": [75, 100],         \"spending_alerts_enabled\": True,     } )  # Enable hard cap at $500 response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"hard_spending_cap\": 50000,  # $500 in cents         \"hard_cap_enabled\": True,     } )  # Disable all spending limits response = await client.post(     \"/v1/organizations/billing/spending-caps\",     json={         \"monthly_spending_budget\": None,         \"hard_spending_cap\": None,         \"hard_cap_enabled\": False,     } ) ```
+     * @summary Update Spending Caps
+     * @param {OrganizationBillingApiUpdateSpendingCapsOrganizationsBillingRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OrganizationBillingApi
+     */
+    updateSpendingCapsOrganizationsBilling(requestParameters: OrganizationBillingApiUpdateSpendingCapsOrganizationsBillingRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SpendingCapsResponse, any, {}>>;
+}
+//# sourceMappingURL=organization-billing-api.d.ts.map