listbee 0.4.0 → 0.6.0

package/dist/cjs/generated/api-types.d.ts

@@ -0,0 +1,4089 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/account": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get account
+         * @description Account status and readiness. Check readiness.operational — if false, readiness.actions lists what's needed. readiness.next is the highest-priority action.
+         */
+        get: operations["get_account"];
+        /**
+         * Update account
+         * @description Update account profile and settings. Supports display_name, bio, avatar (file token from POST /v1/files), and ga_measurement_id.
+         */
+        put: operations["update_account"];
+        /**
+         * Create account
+         * @description Start account creation or re-authentication. Sends a 6-digit OTP to the email. Idempotent — calling again re-sends. No authentication required.
+         */
+        post: operations["create_account"];
+        /**
+         * Delete account
+         * @description Permanently delete the authenticated account. PII is anonymized, API keys revoked, webhooks disabled. Order history is retained for accounting. This action is irreversible.
+         */
+        delete: operations["delete_account"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/account/verify/otp": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Verify OTP
+         * @description Verify OTP code. Returns account and API key. Works for both new and returning accounts.
+         */
+        post: operations["verify_otp"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api-keys": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List API keys
+         * @description List all API keys for the authenticated account with full key values.
+         */
+        get: operations["list_api_keys"];
+        put?: never;
+        /**
+         * Create API key
+         * @description Create a new API key. The full key value is included in the response and always retrievable via list_api_keys.
+         */
+        post: operations["create_api_key"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api-keys/{key_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete API key
+         * @description Revoke an API key. Cannot delete the key you are currently authenticating with.
+         */
+        delete: operations["delete_api_key"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/customers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List customers
+         * @description List customers (buyers) for the authenticated account. Customers are auto-created when a buyer completes their first order. Use this endpoint to get buyer email addresses for marketing, analyze purchasing patterns, or identify repeat customers. Sorted by most recent purchase first.
+         */
+        get: operations["list_customers"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/customers/{customer_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get customer
+         * @description Get a single customer by ID. Customers are auto-created from order data — they represent unique buyer email addresses that have purchased from the seller.
+         */
+        get: operations["get_customer"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/files": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Upload file
+         * @description Upload a file for use as a listing deliverable. Returns a file token valid for 24 hours. Pass the token to PUT /v1/listings/{listing_id}/deliverables or POST /v1/orders/{id}/deliver to attach the file. Max size: 25 MB. Accepted types: PDF, EPUB, ZIP, images, audio, video, Office documents.
+         */
+        post: operations["upload_file"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/listings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List listings
+         * @description List all listings for the authenticated account. Filter by status. Cursor-paginated. Each listing includes readiness — check readiness.sellable to see if it can accept orders.
+         */
+        get: operations["list_listings"];
+        put?: never;
+        /**
+         * Create listing
+         * @description Create a listing to sell digital content. Returns product page URL and readiness. If readiness.sellable is false, follow readiness.actions to resolve. readiness.next is the first action to take. When your account uses a Stripe test key, checkout URLs point to Stripe test mode.
+         */
+        post: operations["create_listing"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/listings/{listing_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get listing
+         * @description Get a single listing by ID. Check readiness.sellable — if false, readiness.actions tells you what's needed.
+         */
+        get: operations["get_listing"];
+        /**
+         * Update listing
+         * @description Update listing fields. Slug can be changed while in draft status — input is slugified, conflicts get a random suffix. Returns updated listing with readiness.
+         */
+        put: operations["update_listing"];
+        post?: never;
+        /**
+         * Delete listing
+         * @description Delete a listing by ID and its stored content. Irreversible.
+         */
+        delete: operations["delete_listing"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/listings/{listing_id}/deliverables": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Set deliverables
+         * @description Replace all deliverables on a draft listing. Accepts an array of up to 3 deliverables (file, url, text). File tokens must be obtained via POST /v1/files first. Old file deliverables are automatically cleaned up from storage.
+         */
+        put: operations["set_deliverables"];
+        post?: never;
+        /**
+         * Remove deliverables
+         * @description Remove all deliverables from a draft listing. Demotes the listing to external fulfillment. Draft only — returns 409 if the listing is published.
+         */
+        delete: operations["remove_deliverables"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/listings/{listing_id}/publish": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Publish listing
+         * @description Validate and publish a draft listing. Transitions to published state — the listing becomes live, buyable, and immutable. Fails with 409 and readiness actions if requirements are not met.
+         */
+        post: operations["publish_listing"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List orders
+         * @description List orders for the authenticated account. Filter by status, listing, and date range. Paginated. Order lifecycle: PENDING (checkout started, buyer data captured) → PAID (payment confirmed, order.paid webhook fires) → FULFILLED (content delivered or goods shipped). Terminal states: CANCELED (payment failed or abandoned), FAILED (system error). Managed listings auto-fulfill on payment. External listings stay in PAID until the seller calls fulfill() or ship().
+         */
+        get: operations["list_orders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orders/{order_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get order
+         * @description Get a single order by ID. Order lifecycle: PENDING → PAID → FULFILLED. Managed listings auto-fulfill. External listings require fulfill() or ship() after payment.
+         */
+        get: operations["get_order"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orders/{order_id}/refund": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Refund order
+         * @description Issue a full refund for an order. The refund is processed through Stripe on the seller's connected account. Only orders with status `paid` or `fulfilled` can be refunded. If the order is already refunded, returns the order as-is (idempotent). The order's refund_amount and refunded_at update asynchronously via Stripe webhook.
+         */
+        post: operations["refund_order"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orders/{order_id}/deliver": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Deliver order
+         * @description Mark an order as fulfilled and push a deliverable for ListBee to deliver. Transitions PAID → FULFILLED. Only valid for orders on EXTERNAL listings. Fires order.fulfilled webhook with the full order snapshot. Idempotent — calling on an already-fulfilled order returns 200.
+         */
+        post: operations["deliver_order"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orders/{order_id}/ship": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ship order
+         * @description Record shipping info (carrier + tracking code) and transition the order from PAID → FULFILLED. Only valid for orders on EXTERNAL listings with physical goods. Fires order.fulfilled webhook with shipping details in the payload. Idempotent when called with the same tracking code.
+         */
+        post: operations["ship_order"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/account/stripe/connect": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Start Stripe Connect onboarding
+         * @description Start Stripe Connect guided onboarding. Returns a URL to redirect the human to. The human completes Stripe's identity and bank account verification flow. On completion, Stripe fires an account.updated webhook and ListBee marks the account as connected. The stripe_account_id is saved immediately — payment_config is set only after webhook confirmation.
+         */
+        post: operations["start_stripe_connect"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/account/stripe": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Disconnect Stripe
+         * @description Remove Stripe configuration from the account. The account will no longer accept payments until a new Connect session is completed.
+         */
+        delete: operations["disconnect_stripe"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhooks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List webhooks
+         * @description List all webhook endpoints for the authenticated account. Use POST /v1/webhooks to register new endpoints. All order event payloads include the full order snapshot — no follow-up API calls needed.
+         */
+        get: operations["list_webhooks"];
+        put?: never;
+        /**
+         * Create webhook
+         * @description Register a webhook endpoint. Returns the endpoint with its signing secret — store it, shown once. All order events (order.paid, order.fulfilled, order.shipped, order.refunded, order.disputed, order.dispute_closed, order.canceled) include a full order snapshot in the payload: order_id, listing_id, listing_slug, buyer_email, amount, currency, status, checkout_data, shipping_address, timestamps, carrier/tracking, and deliverable info. Agents never need a follow-up API call after receiving a webhook. See the WebhookPayloadExample schema for the full payload shape.
+         */
+        post: operations["create_webhook"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhooks/{webhook_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Update webhook
+         * @description Update a webhook endpoint. Only provided fields are changed.
+         */
+        put: operations["update_webhook"];
+        post?: never;
+        /**
+         * Delete webhook
+         * @description Delete a webhook endpoint. Irreversible.
+         */
+        delete: operations["delete_webhook"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhooks/{webhook_id}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List webhook delivery events
+         * @description List delivery event history for a webhook endpoint. Use to debug failed deliveries.
+         */
+        get: operations["list_webhook_events"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhooks/{webhook_id}/events/{event_id}/retry": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Retry a webhook event
+         * @description Reset a failed webhook event and re-dispatch for immediate delivery. Clears attempts, failed_at, last_error, and delivered_at, then enqueues a new delivery.
+         */
+        post: operations["retry_webhook_event"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhooks/{webhook_id}/test": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Test webhook
+         * @description Send a test event to a webhook endpoint and return the delivery result. Does not persist an event record.
+         */
+        post: operations["test_webhook"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /** AccountReadiness */
+        AccountReadiness: {
+            /**
+             * Operational
+             * @description True when the account can sell. False means actions are needed.
+             * @example true
+             */
+            operational: boolean;
+            /**
+             * Actions
+             * @description What's needed to make this account operational. Empty when operational is true.
+             */
+            actions?: components["schemas"]["Action"][];
+            /**
+             * Next
+             * @description Code of the highest-priority action.
+             * @example connect_stripe
+             */
+            next?: string | null;
+        };
+        /** AccountResponse */
+        AccountResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `account`.
+             * @default account
+             * @example account
+             * @constant
+             */
+            object: "account";
+            /**
+             * Id
+             * @description Unique identifier
+             * @example acc_7kQ2xY9mN3pR5tW1
+             */
+            id: string;
+            /**
+             * Email
+             * @description Account email address
+             * @example seller@example.com
+             */
+            email: string;
+            /**
+             * Display Name
+             * @description Seller name shown on product pages.
+             * @example Acme Digital
+             */
+            display_name?: string | null;
+            /**
+             * Bio
+             * @description Short seller bio shown on product pages.
+             * @example We create premium digital tools for modern marketers.
+             */
+            bio?: string | null;
+            /**
+             * Has Avatar
+             * @description true if avatar image exists. Upload via POST /v1/files, set via PUT /v1/account.
+             * @example true
+             */
+            has_avatar: boolean;
+            /**
+             * Plan
+             * @description Current plan tier. Values: free (15% fee), growth (5% fee), scale (3% fee).
+             * @example free
+             * @example growth
+             * @example scale
+             */
+            plan: string;
+            /**
+             * Fee Rate
+             * @description Transaction fee rate as decimal string. Determined by plan: free=0.15, growth=0.05, scale=0.03. Applied as platform fee on each order.
+             * @example 0.10
+             * @example 0.05
+             */
+            fee_rate: string;
+            /**
+             * Billing Status
+             * @description Subscription billing status. `active` = payments current. `past_due` = payment failed, service continues during grace period. `unpaid` = grace period expired, listings may be blocked.
+             * @example active
+             * @example past_due
+             */
+            billing_status: string;
+            /**
+             * Currency
+             * @description Account currency (ISO 4217, lowercase). Set automatically from Stripe Connect. Cannot be changed after connection.
+             * @example usd
+             * @example eur
+             */
+            currency?: string | null;
+            /**
+             * Ga Measurement Id
+             * @description Google Analytics 4 Measurement ID (G-XXXXXXXXXX). Set via PUT /v1/account. Injected on all your product pages and thank-you pages
+             * @example G-ABC123XYZ
+             */
+            ga_measurement_id?: string | null;
+            /** @description Account aggregate statistics. */
+            stats: components["schemas"]["AccountStats"];
+            /** @description Account operational readiness. `operational` is true when the account can sell. If false, `actions` lists what's needed with kind (api/human), resolve details, and `next` points to the highest-priority action. */
+            readiness: components["schemas"]["AccountReadiness"];
+            /**
+             * Created At
+             * Format: date-time
+             * @description Time at which the account was created
+             * @example 2026-03-15T10:00:00Z
+             */
+            created_at: string;
+        };
+        /** AccountStats */
+        AccountStats: {
+            /**
+             * Total Revenue
+             * @description Total revenue in smallest currency unit (completed orders)
+             * @example 145000
+             */
+            total_revenue: number;
+            /**
+             * Total Orders
+             * @description Total number of orders this month
+             * @example 47
+             */
+            total_orders: number;
+            /**
+             * Total Listings
+             * @description Total number of listings
+             * @example 12
+             */
+            total_listings: number;
+        };
+        /** Action */
+        Action: {
+            /**
+             * @description Machine-readable action identifier for automation branching.
+             * @example connect_stripe
+             */
+            code: components["schemas"]["ActionCode"];
+            /**
+             * @description Whether an agent can execute this directly (api) or needs human interaction (human).
+             * @example api
+             */
+            kind: components["schemas"]["ActionKind"];
+            /**
+             * Message
+             * @description Human-readable explanation. AI agents relay this to users.
+             * @example Set Stripe secret key to accept payments
+             */
+            message: string;
+            /** @description How to resolve this action. */
+            resolve: components["schemas"]["ActionResolve"];
+        };
+        /**
+         * ActionCode
+         * @enum {string}
+         */
+        ActionCode: "connect_stripe" | "enable_charges" | "update_billing" | "configure_webhook" | "publish_listing" | "webhook_disabled";
+        /**
+         * ActionKind
+         * @enum {string}
+         */
+        ActionKind: "api" | "human";
+        /** ActionResolve */
+        ActionResolve: {
+            /**
+             * Method
+             * @description How to resolve: HTTP method (POST, GET) for kind=api, 'redirect' for kind=human.
+             * @example POST
+             */
+            method: string;
+            /**
+             * Endpoint
+             * @description API endpoint path for kind=api actions.
+             * @example /v1/account/stripe-key
+             */
+            endpoint?: string | null;
+            /**
+             * Url
+             * @description Full URL for kind=human actions (browser redirect).
+             * @example https://console.listbee.so/connect/stripe
+             */
+            url?: string | null;
+            /**
+             * Params
+             * @description Example request body for kind=api actions.
+             * @example {
+             *       "secret_key": "sk_live_..."
+             *     }
+             */
+            params?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /** ApiKeyListResponse */
+        ApiKeyListResponse: {
+            /**
+             * Object
+             * @description Object type identifier.
+             * @default list
+             * @example list
+             * @constant
+             */
+            object: "list";
+            /**
+             * Data
+             * @description List of API keys
+             */
+            data: components["schemas"]["ApiKeyResponse"][];
+            /**
+             * Has More
+             * @description Always false — API keys are not paginated.
+             * @default false
+             * @example false
+             */
+            has_more: boolean;
+            /**
+             * Cursor
+             * @description Always null — API keys are not paginated.
+             * @example null
+             */
+            cursor?: string | null;
+        };
+        /** ApiKeyResponse */
+        ApiKeyResponse: {
+            /**
+             * Object
+             * @description Object type identifier.
+             * @default api_key
+             * @example api_key
+             * @constant
+             */
+            object: "api_key";
+            /**
+             * Id
+             * @description API key entity ID
+             * @example ak_7kQ2xY9mN3pR5tW1vB8a
+             */
+            id: string;
+            /**
+             * Name
+             * @description Human-readable label
+             * @example n8n production
+             */
+            name: string;
+            /**
+             * Prefix
+             * @description First 8 characters of the key value
+             * @example lb_abc12
+             */
+            prefix: string;
+            /**
+             * Key
+             * @description Full API key value. Use as Bearer token for all authenticated requests.
+             * @example lb_abc123def456ghi789
+             */
+            key: string;
+            /**
+             * Created At
+             * Format: date-time
+             * @description When the key was created
+             * @example 2026-04-01T10:00:00Z
+             */
+            created_at: string;
+        };
+        /**
+         * BlurMode
+         * @enum {string}
+         */
+        BlurMode: "true" | "false" | "auto";
+        /** Body_upload_file */
+        Body_upload_file: {
+            /**
+             * File
+             * @description The file to upload
+             */
+            file: string;
+        };
+        /**
+         * CheckoutFieldInput
+         * @description A field to collect from the buyer at checkout.
+         */
+        CheckoutFieldInput: {
+            /**
+             * Key
+             * @description Unique key for this field
+             * @example size
+             * @example note
+             */
+            key: string;
+            /**
+             * @description Field type
+             * @example text
+             */
+            type: components["schemas"]["CheckoutFieldType"];
+            /**
+             * Label
+             * @description Label shown to buyer
+             * @example Shoe size
+             */
+            label: string;
+            /**
+             * Required
+             * @description Whether this field is required
+             * @default true
+             * @example true
+             */
+            required: boolean;
+            /**
+             * Options
+             * @description Options for select fields
+             * @example [
+             *       "S",
+             *       "M",
+             *       "L"
+             *     ]
+             */
+            options?: string[] | null;
+        };
+        /**
+         * CheckoutFieldType
+         * @description Types of fields that can be collected at checkout.
+         * @enum {string}
+         */
+        CheckoutFieldType: "address" | "text" | "select" | "date";
+        /** CreateAccountRequest */
+        CreateAccountRequest: {
+            /**
+             * Email
+             * Format: email
+             * @description Account email. OTP will be sent here. Agent tip: use AgentMail or similar for autonomous OTP handling.
+             * @example seller@example.com
+             */
+            email: string;
+        };
+        /** CreateAccountResponse */
+        CreateAccountResponse: {
+            /**
+             * Object
+             * @description Object type.
+             * @default account_session
+             * @example account_session
+             * @constant
+             */
+            object: "account_session";
+            /**
+             * Email
+             * @description Email the OTP was sent to.
+             * @example seller@example.com
+             */
+            email: string;
+            /**
+             * Status
+             * @description Always otp_sent on success.
+             * @default otp_sent
+             * @example otp_sent
+             * @constant
+             */
+            status: "otp_sent";
+            /**
+             * Message
+             * @description Human-readable instruction.
+             * @default Check your email for a 6-digit verification code.
+             * @example Check your email for a 6-digit verification code.
+             */
+            message: string;
+        };
+        /** CreateApiKeyRequest */
+        CreateApiKeyRequest: {
+            /**
+             * Name
+             * @description Human-readable label for this API key.
+             * @example n8n production
+             * @example claude-code
+             */
+            name: string;
+        };
+        /**
+         * CreateListingRequest
+         * @description All optional display fields (name, description, tagline, highlights, cta, badges, cover, reviews, faqs) appear on the product page buyers see.
+         */
+        CreateListingRequest: {
+            /**
+             * Checkout Schema
+             * @description Custom fields to collect from the buyer at checkout (e.g. size, color, shipping address). Email is always collected.
+             * @example [
+             *       {
+             *         "key": "size",
+             *         "label": "Size",
+             *         "options": [
+             *           "S",
+             *           "M",
+             *           "L"
+             *         ],
+             *         "type": "select"
+             *       }
+             *     ]
+             */
+            checkout_schema?: components["schemas"]["CheckoutFieldInput"][] | null;
+            /**
+             * Name
+             * @description Product name shown on the product page
+             * @example SEO Playbook 2026
+             * @example Premium Stock Picks
+             */
+            name: string;
+            /**
+             * Price
+             * @description Price in cents (smallest currency unit). Examples: $5 = 500, $29 = 2900, $99.99 = 9999.
+             * @example 500
+             * @example 2900
+             * @example 9999
+             */
+            price: number;
+            /**
+             * Stock
+             * @description Stock quantity. null = unlimited (default), 0 = out of stock, positive integer = sell N then stop. Auto-decrements on each order.
+             * @example null
+             * @example 100
+             * @example 0
+             */
+            stock?: number | null;
+            /**
+             * Description
+             * @description Product description shown on the product page. Improves buyer conversion. Plain text, max 5000 chars.
+             * @example A comprehensive guide to modern SEO techniques.
+             */
+            description?: string | null;
+            /**
+             * Tagline
+             * @description Short tagline shown below the product name on the product page. Max 140 chars.
+             * @example Updated for 2026 algorithm changes
+             */
+            tagline?: string | null;
+            /**
+             * Highlights
+             * @description Bullet-point features shown as badges on the product page. Max 10 items. Each should be short (2-4 words).
+             * @example [
+             *       "50+ pages",
+             *       "Actionable tips",
+             *       "Free updates"
+             *     ]
+             */
+            highlights?: string[] | null;
+            /**
+             * Cta
+             * @description Buy button text on the product page. Defaults to 'Buy Now' if omitted. Max 60 chars.
+             * @example Get Instant Access
+             * @example Download Now
+             */
+            cta?: string | null;
+            /**
+             * Cover
+             * @description Cover image file token from POST /v1/files. Shown prominently on the product page. Recommended: 1200x630px.
+             * @example file_tok_abc123
+             */
+            cover?: string | null;
+            /**
+             * Metadata
+             * @description Arbitrary key-value pairs forwarded in webhook event payloads. Use for your own tracking (campaign IDs, source tags).
+             * @example {
+             *       "campaign": "launch-week",
+             *       "source": "n8n"
+             *     }
+             */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Utm Source
+             * @description UTM source tag for Google Analytics. Defaults to 'listbee' if omitted
+             * @example google
+             * @example newsletter
+             * @example twitter
+             */
+            utm_source?: string | null;
+            /**
+             * Utm Medium
+             * @description UTM medium tag for Google Analytics. Defaults to 'product_page' if omitted
+             * @example cpc
+             * @example email
+             * @example social
+             */
+            utm_medium?: string | null;
+            /**
+             * Utm Campaign
+             * @description UTM campaign tag for Google Analytics. Defaults to the listing slug if omitted
+             * @example spring-sale
+             * @example launch-week
+             */
+            utm_campaign?: string | null;
+            /**
+             * Compare At Price
+             * @description Strikethrough price in cents (smallest currency unit). Must be greater than price. Examples: $39 = 3900.
+             * @example 3900
+             * @example 4900
+             */
+            compare_at_price?: number | null;
+            /**
+             * Badges
+             * @description Short promotional badges shown on the product page (e.g. 'Best seller', 'Limited time'). Max 10 items.
+             * @example [
+             *       "Limited time",
+             *       "Best seller"
+             *     ]
+             */
+            badges?: string[] | null;
+            /**
+             * @description Cover image blur mode. 'true' always blurs, 'false' never blurs, 'auto' blurs when deliverable is an image file.
+             * @default auto
+             * @example auto
+             */
+            cover_blur: components["schemas"]["BlurMode"];
+            /**
+             * Rating
+             * @description Seller-provided aggregate star rating (1-5). Shown on the product page. Values outside range clamped.
+             * @example 4.8
+             * @example 4.5
+             */
+            rating?: number | null;
+            /**
+             * Rating Count
+             * @description Seller-provided review or purchase count shown alongside the rating on the product page.
+             * @example 1243
+             * @example 89
+             */
+            rating_count?: number | null;
+            /**
+             * Reviews
+             * @description Featured review cards shown on the product page. Seller-provided, not buyer-submitted. Max 10.
+             * @example [
+             *       {
+             *         "content": "Best decision I've made for my health.",
+             *         "name": "Clara D.",
+             *         "rating": 4.5
+             *       }
+             *     ]
+             */
+            reviews?: components["schemas"]["ReviewInput"][] | null;
+            /**
+             * Faqs
+             * @description FAQ accordion shown on the product page. Answers common buyer questions. Max 10 items.
+             * @example [
+             *       {
+             *         "a": "Yes, completely beginner-friendly.",
+             *         "q": "Is this for beginners?"
+             *       }
+             *     ]
+             */
+            faqs?: components["schemas"]["FaqItemInput"][] | null;
+        };
+        /** CreateWebhookRequest */
+        CreateWebhookRequest: {
+            /**
+             * Name
+             * @description A name to help you identify this endpoint in the dashboard
+             * @example Order notifications
+             */
+            name: string;
+            /**
+             * Url
+             * Format: uri
+             * @description The HTTPS URL that will receive POST requests for each event
+             * @example https://example.com/webhooks/listbee
+             */
+            url: string;
+            /**
+             * Events
+             * @description Event types to subscribe to. Empty = all events. Available: order.paid, order.fulfilled, order.shipped, order.refunded, order.disputed, order.dispute_closed, order.canceled, listing.created, listing.updated, listing.out_of_stock, listing.deleted.
+             * @example [
+             *       "order.paid"
+             *     ]
+             */
+            events?: components["schemas"]["WebhookEventType"][];
+        };
+        /** CustomerListResponse */
+        CustomerListResponse: {
+            /**
+             * Object
+             * @description Object type identifier.
+             * @default list
+             * @example list
+             * @constant
+             */
+            object: "list";
+            /**
+             * Data
+             * @description Array of customer objects.
+             */
+            data: components["schemas"]["CustomerResponse"][];
+            /**
+             * Cursor
+             * @description Cursor for next page.
+             */
+            cursor?: string | null;
+            /**
+             * Has More
+             * @description Whether more results exist.
+             * @example false
+             */
+            has_more: boolean;
+        };
+        /** CustomerResponse */
+        CustomerResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `customer`.
+             * @default customer
+             * @example customer
+             * @constant
+             */
+            object: "customer";
+            /**
+             * Id
+             * @description Unique identifier.
+             * @example cus_7kQ2xY9mN3pR5tW1vB8a01
+             */
+            id: string;
+            /**
+             * Email
+             * @description Buyer email address.
+             * @example alice@example.com
+             */
+            email: string;
+            /**
+             * Total Orders
+             * @description Total number of completed orders from this buyer.
+             * @example 3
+             */
+            total_orders: number;
+            /**
+             * Total Spent
+             * @description Total amount spent in cents (smallest currency unit).
+             * @example 8700
+             */
+            total_spent: number;
+            /**
+             * Currency
+             * @description Currency code.
+             * @example usd
+             */
+            currency: string;
+            /**
+             * First Order At
+             * @description When this buyer first purchased.
+             * @example 2026-03-15T10:00:00Z
+             */
+            first_order_at?: string | null;
+            /**
+             * Last Order At
+             * @description When this buyer most recently purchased.
+             * @example 2026-04-01T14:30:00Z
+             */
+            last_order_at?: string | null;
+            /**
+             * Created At
+             * Format: date-time
+             * @description When this customer record was created.
+             * @example 2026-03-15T10:00:00Z
+             */
+            created_at: string;
+        };
+        /**
+         * DeliverOrderRequest
+         * @description Push deliverables for a specific order. Marks order as fulfilled.
+         */
+        DeliverOrderRequest: {
+            /**
+             * Deliverables
+             * @description Array of deliverables to attach. Max 3. Mixed types allowed.
+             * @example [
+             *       {
+             *         "token": "file_7kQ2xY9mN3pR5tW1vB8a01",
+             *         "type": "file"
+             *       },
+             *       {
+             *         "type": "url",
+             *         "value": "https://example.com/bonus"
+             *       }
+             *     ]
+             */
+            deliverables: components["schemas"]["DeliverableInputRequest"][];
+        };
+        /**
+         * DeliverableInputRequest
+         * @description Typed deliverable input. Shared by PUT /deliverables and POST /deliver.
+         */
+        DeliverableInputRequest: {
+            /**
+             * @description Deliverable type: `file` (uploaded via POST /v1/files), `url` (redirect), or `text` (literal string).
+             * @example file
+             */
+            type: components["schemas"]["DeliverableType"];
+            /**
+             * Token
+             * @description File token from POST /v1/files. Required when type is `file`.
+             * @example file_7kQ2xY9mN3pR5tW1vB8a01
+             */
+            token?: string | null;
+            /**
+             * Value
+             * @description URL (https required) or text content. Required when type is `url` or `text`.
+             * @example https://example.com/secret-area
+             */
+            value?: string | null;
+        };
+        /** DeliverableResponse */
+        DeliverableResponse: {
+            /**
+             * Object
+             * @description Object type identifier.
+             * @default deliverable
+             * @example deliverable
+             * @constant
+             */
+            object: "deliverable";
+            /**
+             * @description Deliverable type.
+             * @example file
+             */
+            type: components["schemas"]["DeliverableType"];
+            /**
+             * @description Processing status.
+             * @example ready
+             */
+            status: components["schemas"]["DeliverableStatus"];
+            /**
+             * Filename
+             * @description Original filename (file type only).
+             * @example ebook.pdf
+             */
+            filename?: string | null;
+            /**
+             * Size
+             * @description File size in bytes (file type only).
+             * @example 2458631
+             */
+            size?: number | null;
+            /**
+             * Mime Type
+             * @description MIME type (file type only).
+             * @example application/pdf
+             */
+            mime_type?: string | null;
+            /**
+             * Url
+             * @description Redirect URL (url type only).
+             * @example https://example.com/secret
+             */
+            url?: string | null;
+            /**
+             * Content
+             * @description Text content (text type only).
+             * @example Buy signal: AAPL
+             */
+            content?: string | null;
+        };
+        /**
+         * DeliverableStatus
+         * @enum {string}
+         */
+        DeliverableStatus: "processing" | "ready" | "failed";
+        /**
+         * DeliverableType
+         * @enum {string}
+         */
+        DeliverableType: "file" | "url" | "text";
+        /** FaqItemInput */
+        FaqItemInput: {
+            /**
+             * Q
+             * @description Question text
+             * @example Is this for beginners?
+             */
+            q: string;
+            /**
+             * A
+             * @description Answer text
+             * @example Yes, completely beginner-friendly.
+             */
+            a: string;
+        };
+        /** FileResponse */
+        FileResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `file`.
+             * @default file
+             * @example file
+             * @constant
+             */
+            object: "file";
+            /**
+             * Id
+             * @description File token. Pass as 'token' to set_deliverables, or as 'cover'/'avatar' to create/update listing/account.
+             * @example file_7kQ2xY9mN3pR5tW1vB8a01
+             */
+            id: string;
+            /**
+             * Filename
+             * @description Original filename
+             * @example ebook.pdf
+             */
+            filename: string;
+            /**
+             * Size
+             * @description File size in bytes
+             * @example 2458631
+             */
+            size: number;
+            /**
+             * Mime Type
+             * @description MIME type
+             * @example application/pdf
+             */
+            mime_type: string;
+            /**
+             * Purpose
+             * @description File purpose: 'deliverable' (listing content), 'cover' (listing cover image), or 'avatar' (account avatar).
+             * @example deliverable
+             */
+            purpose: string;
+            /**
+             * Expires At
+             * Format: date-time
+             * @description Token expires at this time. Upload a new file after expiry.
+             * @example 2026-04-03T15:00:00Z
+             */
+            expires_at: string;
+            /**
+             * Created At
+             * Format: date-time
+             * @description Time at which the file was uploaded
+             * @example 2026-04-03T14:00:00Z
+             */
+            created_at: string;
+        };
+        /**
+         * FulfillmentMode
+         * @enum {string}
+         */
+        FulfillmentMode: "managed" | "external";
+        /** HTTPValidationError */
+        HTTPValidationError: {
+            /** Detail */
+            detail?: components["schemas"]["ValidationError"][];
+        };
+        /** ListingListResponse */
+        ListingListResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `list`.
+             * @default list
+             * @example list
+             * @constant
+             */
+            object: "list";
+            /**
+             * Data
+             * @description Array of listing objects.
+             */
+            data: components["schemas"]["ListingResponse"][];
+            /**
+             * Total Count
+             * @description Total number of matching resources across all pages
+             * @default 0
+             * @example 47
+             */
+            total_count: number;
+            /**
+             * Cursor
+             * @description Pass as `cursor` query param to fetch the next page
+             * @example lst_7kQ2xY9mN3pR5tW1vB8a
+             */
+            cursor?: string | null;
+            /**
+             * Has More
+             * @description True if more results exist beyond this page
+             * @default false
+             * @example false
+             */
+            has_more: boolean;
+        };
+        /** ListingReadiness */
+        ListingReadiness: {
+            /**
+             * Sellable
+             * @description True when buyers can purchase. False means actions are needed.
+             * @example true
+             */
+            sellable: boolean;
+            /**
+             * Actions
+             * @description What's needed to make this listing sellable. Empty when sellable is true.
+             */
+            actions?: components["schemas"]["Action"][];
+            /**
+             * Next
+             * @description Code of the highest-priority action. Agents execute this first.
+             * @example connect_stripe
+             */
+            next?: string | null;
+        };
+        /** ListingResponse */
+        ListingResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `listing`.
+             * @default listing
+             * @example listing
+             * @constant
+             */
+            object: "listing";
+            /**
+             * Id
+             * @description Unique identifier
+             * @example lst_7kQ2xY9mN3pR5tW1vB8a
+             */
+            id: string;
+            /**
+             * Slug
+             * @description URL slug for the product page
+             * @example seo-playbook
+             */
+            slug: string;
+            /**
+             * Name
+             * @description Product name shown on the product page
+             * @example SEO Playbook 2026
+             */
+            name: string;
+            /**
+             * Description
+             * @description Product description shown on the product page. Plain text.
+             * @example A comprehensive guide to modern SEO.
+             */
+            description?: string | null;
+            /**
+             * Tagline
+             * @description Short tagline shown below the product name on the product page.
+             * @example Updated for 2026 algorithm changes
+             */
+            tagline?: string | null;
+            /**
+             * Highlights
+             * @description Bullet-point features shown as badges on the product page.
+             * @example [
+             *       "50+ pages",
+             *       "Actionable tips"
+             *     ]
+             */
+            highlights: string[];
+            /**
+             * Cta
+             * @description Buy button text on the product page. Defaults to 'Buy Now' if omitted.
+             * @example Get Instant Access
+             */
+            cta?: string | null;
+            /**
+             * Price
+             * @description Price in cents (smallest currency unit). Examples: $5 = 500, $29 = 2900, $99.99 = 9999.
+             * @example 500
+             * @example 2900
+             * @example 9999
+             */
+            price: number;
+            /**
+             * Deliverables
+             * @description Array of deliverables attached to this listing. Empty for external fulfillment.
+             */
+            deliverables?: components["schemas"]["DeliverableResponse"][];
+            /**
+             * Has Deliverables
+             * @description `true` if all deliverables have content and listing uses managed fulfillment
+             * @example true
+             */
+            has_deliverables: boolean;
+            /**
+             * @description Who delivers after payment. `managed` = ListBee, `external` = seller/app.
+             * @example managed
+             */
+            fulfillment: components["schemas"]["FulfillmentMode"];
+            /**
+             * Checkout Schema
+             * @description Custom fields collected from the buyer at checkout
+             */
+            checkout_schema?: components["schemas"]["CheckoutFieldInput"][] | null;
+            /**
+             * Has Cover
+             * @description True if a cover image exists (uploaded or generated)
+             * @example true
+             */
+            has_cover: boolean;
+            /**
+             * Compare At Price
+             * @description Strikethrough price in smallest currency unit
+             * @example 3900
+             */
+            compare_at_price?: number | null;
+            /**
+             * Badges
+             * @description Short promotional badges shown on the product page (e.g. 'Best seller', 'Limited time').
+             * @example [
+             *       "Limited time"
+             *     ]
+             */
+            badges?: string[];
+            /**
+             * @description Cover image blur mode. 'true' always blurs, 'false' never blurs, 'auto' blurs when deliverable is an image file.
+             * @default auto
+             * @example auto
+             */
+            cover_blur: components["schemas"]["BlurMode"];
+            /**
+             * Rating
+             * @description Seller-provided aggregate star rating (1-5). Shown on the product page.
+             * @example 4.8
+             */
+            rating?: number | null;
+            /**
+             * Rating Count
+             * @description Seller-provided review or purchase count shown alongside the rating on the product page.
+             * @example 1243
+             */
+            rating_count?: number | null;
+            /**
+             * Reviews
+             * @description Featured review cards shown on the product page. Seller-provided, not buyer-submitted.
+             * @example []
+             */
+            reviews?: components["schemas"]["ReviewInput"][];
+            /**
+             * Faqs
+             * @description FAQ accordion shown on the product page. Answers common buyer questions.
+             * @example []
+             */
+            faqs?: components["schemas"]["FaqItemInput"][];
+            /**
+             * Metadata
+             * @description Arbitrary key-value pairs forwarded in webhook event payloads. Set at creation or update.
+             * @example {
+             *       "source": "n8n"
+             *     }
+             */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Utm Source
+             * @description UTM source tag for Google Analytics
+             * @example google
+             */
+            utm_source?: string | null;
+            /**
+             * Utm Medium
+             * @description UTM medium tag for Google Analytics
+             * @example cpc
+             */
+            utm_medium?: string | null;
+            /**
+             * Utm Campaign
+             * @description UTM campaign tag for Google Analytics
+             * @example spring-sale
+             */
+            utm_campaign?: string | null;
+            /**
+             * @description Current listing status
+             * @example published
+             */
+            status: components["schemas"]["ListingStatus"];
+            /**
+             * Stock
+             * @description Stock quantity. null = unlimited, 0 = out of stock. Auto-decrements on each order.
+             * @example null
+             * @example 50
+             * @example 0
+             */
+            stock?: number | null;
+            /**
+             * Url
+             * @description Full product page URL — share this with buyers
+             * @example https://buy.listbee.so/seo-playbook
+             */
+            url?: string | null;
+            /**
+             * Embed Url
+             * @description Embeddable product page URL — use in iframes. Renders minimal version without header/footer.
+             * @example https://buy.listbee.so/seo-playbook?embed=true
+             */
+            embed_url?: string | null;
+            /** @description Monetization readiness. `sellable` is true when buyers can complete a purchase. If false, `actions` lists what's needed with kind (api/human), resolve details, and `next` points to the highest-priority action. */
+            readiness: components["schemas"]["ListingReadiness"];
+            /**
+             * Created At
+             * Format: date-time
+             * @description Time at which the listing was created
+             * @example 2026-04-01T12:00:00Z
+             */
+            created_at: string;
+        };
+        /**
+         * ListingStatus
+         * @enum {string}
+         */
+        ListingStatus: "draft" | "published";
+        /** OrderListResponse */
+        OrderListResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `list`.
+             * @default list
+             * @example list
+             * @constant
+             */
+            object: "list";
+            /**
+             * Data
+             * @description Array of order objects.
+             */
+            data: components["schemas"]["OrderResponse"][];
+            /**
+             * Total Count
+             * @description Total number of matching resources across all pages
+             * @default 0
+             * @example 47
+             */
+            total_count: number;
+            /**
+             * Cursor
+             * @description Pass as `cursor` query param to fetch the next page
+             * @example lst_7kQ2xY9mN3pR5tW1vB8a
+             */
+            cursor?: string | null;
+            /**
+             * Has More
+             * @description True if more results exist beyond this page
+             * @default false
+             * @example false
+             */
+            has_more: boolean;
+        };
+        /** OrderResponse */
+        OrderResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `order`.
+             * @default order
+             * @example order
+             * @constant
+             */
+            object: "order";
+            /**
+             * Id
+             * @description Unique identifier
+             * @example ord_9xM4kP7nR2qT5wY1
+             */
+            id: string;
+            /**
+             * Listing Id
+             * @description ID of the purchased listing
+             * @example lst_7kQ2xY9mN3pR5tW1vB8a
+             */
+            listing_id: string;
+            /**
+             * Buyer Email
+             * @description Buyer's email address collected at Stripe Checkout. Use for customer communication.
+             * @example buyer@example.com
+             */
+            buyer_email: string;
+            /**
+             * Amount
+             * @description Amount paid in cents (smallest currency unit). $29.00 = 2900.
+             * @example 2900
+             */
+            amount: number;
+            /**
+             * Currency
+             * @description Three-letter ISO currency code, uppercase
+             * @example USD
+             */
+            currency: string;
+            /**
+             * @description Current order status. Lifecycle: PENDING → PAID → FULFILLED. Terminal: CANCELED, FAILED.
+             * @example paid
+             */
+            status: components["schemas"]["OrderStatus"];
+            /**
+             * Checkout Data
+             * @description Custom checkout field values submitted by the buyer. Keys match the listing's checkout_schema.
+             * @example {
+             *       "note": "Gift wrap please",
+             *       "size": "M"
+             *     }
+             */
+            checkout_data?: {
+                [key: string]: unknown;
+            } | null;
+            /** @description Shipping address if collected */
+            shipping_address?: components["schemas"]["ShippingAddressResponse"] | null;
+            /**
+             * Deliverables
+             * @description Deliverables attached to this order. Auto-populated for managed fulfillment, or pushed via POST /deliver for external.
+             */
+            deliverables?: components["schemas"]["DeliverableResponse"][];
+            /**
+             * Carrier
+             * @description Shipping carrier name
+             * @example USPS
+             */
+            carrier?: string | null;
+            /**
+             * Tracking Code
+             * @description Shipping tracking code
+             * @example 9400111899223
+             */
+            tracking_code?: string | null;
+            /**
+             * Seller Note
+             * @description Note from seller to buyer
+             * @example Ships within 2 business days
+             */
+            seller_note?: string | null;
+            /**
+             * Stripe Payment Intent Id
+             * @description Stripe PaymentIntent ID. Use for cross-referencing with Stripe dashboard or API.
+             * @example pi_3abc123def456
+             */
+            stripe_payment_intent_id: string;
+            /**
+             * Platform Fee
+             * @description Platform fee in cents deducted from this order. Amount seller receives = amount - platform_fee.
+             * @default 0
+             * @example 290
+             */
+            platform_fee: number;
+            /**
+             * Refund Amount
+             * @description Amount refunded to buyer in cents. 0 if not refunded.
+             * @default 0
+             * @example 0
+             * @example 2900
+             */
+            refund_amount: number;
+            /**
+             * Refunded At
+             * @description When the refund was processed. null if not refunded.
+             * @example 2026-04-01T15:30:00Z
+             */
+            refunded_at?: string | null;
+            /**
+             * Dispute Status
+             * @description Stripe dispute status if disputed. Values: needs_response, under_review, won, lost.
+             * @example needs_response
+             */
+            dispute_status?: string | null;
+            /**
+             * Dispute Reason
+             * @description Reason for the dispute as reported by the buyer's bank.
+             * @example product_not_received
+             * @example fraudulent
+             */
+            dispute_reason?: string | null;
+            /**
+             * Dispute Amount
+             * @description Disputed amount in cents. 0 if not disputed.
+             * @default 0
+             * @example 0
+             * @example 2900
+             */
+            dispute_amount: number;
+            /**
+             * Disputed At
+             * @description When the dispute was opened. null if not disputed.
+             * @example 2026-04-02T10:00:00Z
+             */
+            disputed_at?: string | null;
+            /**
+             * Shipped At
+             * @description When shipping tracking was added
+             * @example 2026-04-02T16:00:00Z
+             */
+            shipped_at?: string | null;
+            /**
+             * Paid At
+             * @description When payment was confirmed
+             * @example 2026-04-02T14:30:00Z
+             */
+            paid_at?: string | null;
+            /**
+             * Fulfilled At
+             * @description When order was fulfilled
+             * @example 2026-04-02T15:00:00Z
+             */
+            fulfilled_at?: string | null;
+            /**
+             * Created At
+             * Format: date-time
+             * @description Time at which the order was created
+             * @example 2026-04-02T14:00:00Z
+             */
+            created_at: string;
+        };
+        /**
+         * OrderStatus
+         * @enum {string}
+         */
+        OrderStatus: "pending" | "paid" | "fulfilled" | "canceled" | "failed";
+        /**
+         * ProblemDetail
+         * @description RFC 9457 Problem Details for HTTP APIs.
+         */
+        ProblemDetail: {
+            /**
+             * Type
+             * @description URI identifying the error type. Points to documentation.
+             * @example https://docs.listbee.so/errors/invalid-request
+             */
+            type: string;
+            /**
+             * Title
+             * @description Short, stable, human-readable label for the error category.
+             * @example Invalid Request
+             */
+            title: string;
+            /**
+             * Status
+             * @description HTTP status code echoed in the body.
+             * @example 422
+             */
+            status: number;
+            /**
+             * Detail
+             * @description Specific explanation of what went wrong.
+             * @example Price must be greater than 0
+             */
+            detail: string;
+            /**
+             * Code
+             * @description Machine-readable error code for programmatic handling.
+             * @example invalid_price
+             */
+            code: string;
+            /**
+             * Param
+             * @description The request field that caused the error, if applicable.
+             * @example price
+             */
+            param?: string | null;
+        };
+        /** ReviewInput */
+        ReviewInput: {
+            /**
+             * Name
+             * @description Reviewer display name
+             * @example Clara D.
+             */
+            name: string;
+            /**
+             * Rating
+             * @description Star rating (1–5). Values outside this range are clamped automatically
+             * @example 4.5
+             */
+            rating: number;
+            /**
+             * Content
+             * @description Review body text
+             * @example Excellent quality content.
+             */
+            content: string;
+        };
+        /**
+         * SetDeliverablesRequest
+         * @description Replace all deliverables on a listing.
+         */
+        SetDeliverablesRequest: {
+            /**
+             * Deliverables
+             * @description Array of deliverables. Max 3. Mixed types allowed.
+             * @example [
+             *       {
+             *         "token": "file_7kQ2xY9mN3pR5tW1vB8a01",
+             *         "type": "file"
+             *       }
+             *     ]
+             */
+            deliverables: components["schemas"]["DeliverableInputRequest"][];
+        };
+        /**
+         * ShipOrderRequest
+         * @description Add shipping tracking to an order.
+         */
+        ShipOrderRequest: {
+            /**
+             * Carrier
+             * @description Shipping carrier name
+             * @example USPS
+             * @example FedEx
+             * @example DHL
+             */
+            carrier: string;
+            /**
+             * Tracking Code
+             * @description Tracking number
+             * @example 9400111899223
+             */
+            tracking_code: string;
+            /**
+             * Seller Note
+             * @description Note to include with tracking notification
+             * @example Enjoy your purchase!
+             */
+            seller_note?: string | null;
+        };
+        /** ShippingAddressResponse */
+        ShippingAddressResponse: {
+            /**
+             * Name
+             * @description Recipient full name
+             * @example Jane Doe
+             */
+            name: string;
+            /**
+             * Line1
+             * @description Street address line 1
+             * @example 123 Main St
+             */
+            line1: string;
+            /**
+             * Line2
+             * @description Street address line 2 (apartment, suite, etc.)
+             * @example Apt 4B
+             */
+            line2?: string | null;
+            /**
+             * City
+             * @description City or municipality
+             * @example Austin
+             */
+            city: string;
+            /**
+             * State
+             * @description State, province, or region
+             * @example TX
+             */
+            state?: string | null;
+            /**
+             * Postal Code
+             * @description Postal or ZIP code
+             * @example 78701
+             */
+            postal_code: string;
+            /**
+             * Country
+             * @description ISO 3166-1 alpha-2 country code
+             * @example US
+             */
+            country: string;
+            /**
+             * Phone
+             * @description Phone number in E.164 format
+             * @example +15125551234
+             */
+            phone?: string | null;
+        };
+        /** StripeConnectSessionResponse */
+        StripeConnectSessionResponse: {
+            /**
+             * Object
+             * @description Object type.
+             * @default stripe_connect_session
+             * @example stripe_connect_session
+             * @constant
+             */
+            object: "stripe_connect_session";
+            /**
+             * Url
+             * @description Stripe onboarding URL. Redirect the human here.
+             * @example https://connect.stripe.com/setup/...
+             */
+            url: string;
+            /**
+             * Expires At
+             * Format: date-time
+             * @description When this URL expires.
+             * @example 2026-04-03T16:00:00Z
+             */
+            expires_at: string;
+        };
+        /**
+         * UpdateAccountRequest
+         * @description Partial update for account settings.
+         */
+        UpdateAccountRequest: {
+            /**
+             * Display Name
+             * @description Seller name shown on product pages. Improves buyer trust and conversion. If not set, buyers see a generic seller label.
+             * @example Acme Digital
+             * @example Sarah's Templates
+             */
+            display_name?: string | null;
+            /**
+             * Bio
+             * @description Short seller bio shown on product pages. Plain text. Helps buyers understand who they're buying from.
+             * @example We create premium digital tools for modern marketers.
+             */
+            bio?: string | null;
+            /**
+             * Avatar
+             * @description Avatar image file token from POST /v1/files. Replaces any existing avatar. Shown on product pages next to seller name.
+             * @example file_tok_abc123
+             */
+            avatar?: string | null;
+            /**
+             * Ga Measurement Id
+             * @description Google Analytics 4 Measurement ID (G-XXXXXXXXXX). Set to null to remove
+             * @example G-ABC123XYZ
+             */
+            ga_measurement_id?: string | null;
+        };
+        /**
+         * UpdateListingRequest
+         * @description Partial update — only provided fields are changed.
+         */
+        UpdateListingRequest: {
+            /**
+             * Name
+             * @description Product name
+             * @example SEO Playbook 2026
+             */
+            name?: string | null;
+            /**
+             * Slug
+             * @description URL slug for the product page (e.g. 'seo-playbook'). Only changeable in draft. Auto-slugified. On conflict, random suffix appended.
+             * @example seo-playbook-2026
+             */
+            slug?: string | null;
+            /**
+             * Price
+             * @description Price in cents (smallest currency unit). Examples: $5 = 500, $29 = 2900, $99.99 = 9999.
+             * @example 500
+             * @example 2900
+             * @example 9999
+             */
+            price?: number | null;
+            /**
+             * Stock
+             * @description Stock quantity. null = unlimited, 0 = out of stock, positive integer = sell N then stop.
+             * @example 100
+             * @example 0
+             */
+            stock?: number | null;
+            /**
+             * Checkout Schema
+             * @description Custom fields to collect from the buyer at checkout. Replaces existing schema.
+             * @example [
+             *       {
+             *         "key": "size",
+             *         "label": "Size",
+             *         "options": [
+             *           "S",
+             *           "M",
+             *           "L"
+             *         ],
+             *         "type": "select"
+             *       }
+             *     ]
+             */
+            checkout_schema?: components["schemas"]["CheckoutFieldInput"][] | null;
+            /**
+             * Description
+             * @description Product description shown on the product page. Improves buyer conversion. Plain text, max 5000 chars.
+             * @example A comprehensive guide to modern SEO.
+             */
+            description?: string | null;
+            /**
+             * Tagline
+             * @description Short tagline shown below the product name on the product page. Max 140 chars.
+             * @example Updated for 2026
+             */
+            tagline?: string | null;
+            /**
+             * Highlights
+             * @description Bullet-point features shown as badges on the product page. Max 10 items. Each should be short (2-4 words).
+             * @example [
+             *       "50+ pages",
+             *       "Free updates"
+             *     ]
+             */
+            highlights?: string[] | null;
+            /**
+             * Cta
+             * @description Buy button text on the product page. Defaults to 'Buy Now' if omitted. Max 60 chars.
+             * @example Get Instant Access
+             */
+            cta?: string | null;
+            /**
+             * Cover
+             * @description Cover image file token from POST /v1/files. Shown prominently on the product page. Recommended: 1200x630px.
+             * @example file_tok_abc123
+             */
+            cover?: string | null;
+            /**
+             * Metadata
+             * @description Arbitrary key-value pairs forwarded in webhook event payloads. Use for your own tracking (campaign IDs, source tags).
+             * @example {
+             *       "source": "n8n"
+             *     }
+             */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Utm Source
+             * @description UTM source tag for Google Analytics
+             * @example google
+             */
+            utm_source?: string | null;
+            /**
+             * Utm Medium
+             * @description UTM medium tag for Google Analytics
+             * @example cpc
+             */
+            utm_medium?: string | null;
+            /**
+             * Utm Campaign
+             * @description UTM campaign tag for Google Analytics
+             * @example spring-sale
+             */
+            utm_campaign?: string | null;
+            /**
+             * Compare At Price
+             * @description Strikethrough price in cents (smallest currency unit). Must be greater than price. Examples: $39 = 3900.
+             * @example 3900
+             * @example 4900
+             */
+            compare_at_price?: number | null;
+            /**
+             * Badges
+             * @description Short promotional badges shown on the product page (e.g. 'Best seller', 'Limited time'). Max 10 items.
+             * @example [
+             *       "Best seller"
+             *     ]
+             */
+            badges?: string[] | null;
+            /**
+             * @description Cover image blur mode. 'true' always blurs, 'false' never blurs, 'auto' blurs when deliverable is an image file.
+             * @example auto
+             */
+            cover_blur?: components["schemas"]["BlurMode"] | null;
+            /**
+             * Rating
+             * @description Seller-provided aggregate star rating (1-5). Shown on the product page. Values outside range clamped.
+             * @example 4.8
+             */
+            rating?: number | null;
+            /**
+             * Rating Count
+             * @description Seller-provided review or purchase count shown alongside the rating on the product page.
+             * @example 1243
+             */
+            rating_count?: number | null;
+            /**
+             * Reviews
+             * @description Featured review cards shown on the product page. Seller-provided, not buyer-submitted. Max 10.
+             */
+            reviews?: components["schemas"]["ReviewInput"][] | null;
+            /**
+             * Faqs
+             * @description FAQ accordion shown on the product page. Answers common buyer questions. Max 10 items.
+             */
+            faqs?: components["schemas"]["FaqItemInput"][] | null;
+        };
+        /** UpdateWebhookRequest */
+        UpdateWebhookRequest: {
+            /**
+             * Name
+             * @description Display name
+             * @example Order notifications
+             */
+            name?: string | null;
+            /**
+             * Url
+             * @description HTTPS endpoint URL
+             * @example https://example.com/webhooks/listbee
+             */
+            url?: string | null;
+            /**
+             * Events
+             * @description Replaces the current event subscriptions. Empty list subscribes to all events
+             * @example [
+             *       "order.paid"
+             *     ]
+             */
+            events?: components["schemas"]["WebhookEventType"][] | null;
+            /**
+             * Enabled
+             * @description Set to `false` to pause delivery without deleting the endpoint
+             * @example true
+             */
+            enabled?: boolean | null;
+        };
+        /** ValidationError */
+        ValidationError: {
+            /** Location */
+            loc: (string | number)[];
+            /** Message */
+            msg: string;
+            /** Error Type */
+            type: string;
+            /** Input */
+            input?: unknown;
+            /** Context */
+            ctx?: Record<string, never>;
+        };
+        /** VerifyOtpRequest */
+        VerifyOtpRequest: {
+            /**
+             * Email
+             * Format: email
+             * @description Email used in account creation.
+             * @example seller@example.com
+             */
+            email: string;
+            /**
+             * Code
+             * @description 6-digit OTP code from email.
+             * @example 482901
+             */
+            code: string;
+        };
+        /** VerifyOtpResponse */
+        VerifyOtpResponse: {
+            /**
+             * Object
+             * @description Object type.
+             * @default verify_result
+             * @example verify_result
+             * @constant
+             */
+            object: "verify_result";
+            /** @description The created or existing account with readiness. */
+            account: components["schemas"]["AccountResponse"];
+            /**
+             * Api Key
+             * @description API key for authenticating all subsequent requests. Always returned — store it, use it as Bearer token.
+             * @example lb_abc123...
+             */
+            api_key: string;
+        };
+        /** WebhookEventListResponse */
+        WebhookEventListResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `list`.
+             * @default list
+             * @example list
+             * @constant
+             */
+            object: "list";
+            /**
+             * Data
+             * @description Array of webhook event objects.
+             */
+            data: components["schemas"]["WebhookEventResponse"][];
+            /**
+             * Cursor
+             * @description Pass as `cursor` query param to fetch the next page
+             * @example lst_7kQ2xY9mN3pR5tW1vB8a
+             */
+            cursor?: string | null;
+            /**
+             * Has More
+             * @description True if more results exist beyond this page
+             * @default false
+             * @example false
+             */
+            has_more: boolean;
+        };
+        /** WebhookEventResponse */
+        WebhookEventResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `webhook_event`.
+             * @default webhook_event
+             * @example webhook_event
+             * @constant
+             */
+            object: "webhook_event";
+            /**
+             * Id
+             * @description Unique event ID
+             * @example evt_7kQ2xY9mN3pR5tW1
+             */
+            id: string;
+            /**
+             * @description The event type that triggered this delivery
+             * @example order.paid
+             */
+            event_type: components["schemas"]["WebhookEventType"];
+            /**
+             * Status
+             * @description Computed status: `delivered` if delivered_at is set, `failed` if attempts >= max_retries, otherwise `pending`.
+             * @example delivered
+             * @enum {string}
+             */
+            status: "pending" | "delivered" | "failed";
+            /**
+             * Attempts
+             * @description Number of delivery attempts made
+             * @example 1
+             */
+            attempts: number;
+            /**
+             * Max Retries
+             * @description Maximum delivery attempts before marking as failed
+             * @example 5
+             */
+            max_retries: number;
+            /**
+             * Response Status
+             * @description HTTP status code from the last delivery attempt
+             * @example 200
+             */
+            response_status?: number | null;
+            /**
+             * Last Error
+             * @description Error message from the last failed attempt
+             * @example null
+             */
+            last_error?: string | null;
+            /**
+             * Created At
+             * Format: date-time
+             * @description Time at which the event was created
+             * @example 2026-04-03T14:30:00Z
+             */
+            created_at: string;
+            /**
+             * Delivered At
+             * @description Time at which the event was successfully delivered
+             * @example 2026-04-03T14:30:01Z
+             */
+            delivered_at?: string | null;
+            /**
+             * Failed At
+             * @description Time at which the event permanently failed (all retries exhausted)
+             * @example null
+             */
+            failed_at?: string | null;
+            /**
+             * Next Retry At
+             * @description Expected time for the next delivery retry
+             * @example null
+             */
+            next_retry_at?: string | null;
+        };
+        /**
+         * WebhookEventType
+         * @enum {string}
+         */
+        WebhookEventType: "order.paid" | "order.fulfilled" | "order.shipped" | "order.refunded" | "order.disputed" | "order.dispute_closed" | "order.canceled" | "listing.created" | "listing.updated" | "listing.out_of_stock" | "listing.deleted" | "customer.created";
+        /** WebhookListResponse */
+        WebhookListResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `list`.
+             * @default list
+             * @example list
+             * @constant
+             */
+            object: "list";
+            /**
+             * Data
+             * @description Array of webhook objects.
+             */
+            data: components["schemas"]["WebhookResponse"][];
+        };
+        /** WebhookReadiness */
+        WebhookReadiness: {
+            /**
+             * Ready
+             * @description True when the webhook is active and receiving events.
+             * @example true
+             */
+            ready: boolean;
+            /**
+             * Actions
+             * @description Steps to fix the webhook.
+             */
+            actions?: components["schemas"]["Action"][];
+            /**
+             * Next
+             * @description Highest-priority action code.
+             * @example null
+             */
+            next?: string | null;
+        };
+        /** WebhookResponse */
+        WebhookResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `webhook`.
+             * @default webhook
+             * @example webhook
+             * @constant
+             */
+            object: "webhook";
+            /**
+             * Id
+             * @description Unique identifier
+             * @example wh_3mK8nP2qR5tW7xY1
+             */
+            id: string;
+            /**
+             * Name
+             * @description Display name
+             * @example Order notifications
+             */
+            name: string;
+            /**
+             * Url
+             * @description Endpoint URL
+             * @example https://example.com/webhooks/listbee
+             */
+            url: string;
+            /**
+             * Secret
+             * @description HMAC-SHA256 signing secret. Use to verify webhook payload signatures. See docs for verification examples.
+             * @example whsec_a1b2c3d4e5f6
+             */
+            secret: string;
+            /**
+             * Events
+             * @description Subscribed event types. Empty means all events
+             * @example [
+             *       "order.paid"
+             *     ]
+             */
+            events: components["schemas"]["WebhookEventType"][];
+            /**
+             * Enabled
+             * @description `false` when delivery is paused
+             * @example true
+             */
+            enabled: boolean;
+            /**
+             * Disabled Reason
+             * @description Reason the webhook was disabled. `consecutive_failures` when auto-disabled after repeated delivery failures.
+             * @example null
+             */
+            disabled_reason?: string | null;
+            /** @description Readiness status with actionable steps if the webhook needs attention. */
+            readiness: components["schemas"]["WebhookReadiness"];
+            /**
+             * Created At
+             * Format: date-time
+             * @description Time at which the endpoint was created
+             * @example 2026-04-01T09:00:00Z
+             */
+            created_at: string;
+        };
+        /** WebhookTestResponse */
+        WebhookTestResponse: {
+            /**
+             * Object
+             * @description Object type identifier. Always `webhook_test`.
+             * @default webhook_test
+             * @example webhook_test
+             * @constant
+             */
+            object: "webhook_test";
+            /**
+             * Success
+             * @description `true` if the endpoint returned a 2xx status code
+             * @example true
+             */
+            success: boolean;
+            /**
+             * Status Code
+             * @description HTTP status code returned by the endpoint
+             * @example 200
+             */
+            status_code?: number | null;
+            /**
+             * Response Body
+             * @description Response body from the endpoint, truncated to 2000 characters
+             * @example OK
+             */
+            response_body?: string | null;
+            /**
+             * Error
+             * @description Error message if delivery failed entirely
+             * @example null
+             */
+            error?: string | null;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    get_account: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AccountResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    update_account: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateAccountRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AccountResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation error. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    create_account: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateAccountRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreateAccountResponse"];
+                };
+            };
+            /** @description Blocked email domain. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Too many OTP requests. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    delete_account: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    verify_otp: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["VerifyOtpRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VerifyOtpResponse"];
+                };
+            };
+            /** @description Invalid or expired OTP code. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+            /** @description Too many verification attempts. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    list_api_keys: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiKeyListResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    create_api_key: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateApiKeyRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiKeyResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    delete_api_key: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description API key ID. */
+                key_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description API key not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Cannot delete the key used for this request. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    list_customers: {
+        parameters: {
+            query?: {
+                /** @description Filter by exact buyer email address. */
+                email?: string | null;
+                /** @description Only customers created after this ISO 8601 datetime. */
+                created_after?: string | null;
+                /** @description Only customers created before this ISO 8601 datetime. */
+                created_before?: string | null;
+                /** @description Pagination cursor from a previous response. */
+                cursor?: string | null;
+                /** @description Maximum number of customers to return. */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomerListResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_customer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Customer ID. */
+                customer_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomerResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Customer not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    upload_file: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "multipart/form-data": components["schemas"]["Body_upload_file"];
+            };
+        };
+        responses: {
+            /** @description File uploaded. Token valid for 24 hours. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description File exceeds 25 MB. */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Unsupported file type or missing file. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Rate limit exceeded. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    list_listings: {
+        parameters: {
+            query?: {
+                /** @description Filter by listing status. */
+                status?: components["schemas"]["ListingStatus"] | null;
+                /** @description Pagination cursor from a previous response. */
+                cursor?: string | null;
+                /** @description Maximum number of listings to return. */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListingListResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    create_listing: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateListingRequest"];
+            };
+        };
+        responses: {
+            /** @description Listing created and published. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListingResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation error (code: `validation_error`). Check `detail` for specifics: price must be positive, slug already exists, managed mode requires deliverables, deliverable URL unreachable or unsupported format, external mode cannot have deliverables. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Rate limit exceeded. Retry after the `Retry-After` header value. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    get_listing: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Listing ID (lst_ prefixed). */
+                listing_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListingResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    update_listing: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Listing ID (lst_ prefixed). */
+                listing_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateListingRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListingResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation error. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    delete_listing: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Listing ID (lst_ prefixed). */
+                listing_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    set_deliverables: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Listing ID. */
+                listing_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SetDeliverablesRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListingResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing not found or not owned by this account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing is not in draft status. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation error (too many, invalid token, etc). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    remove_deliverables: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Listing ID (lst_ prefixed). */
+                listing_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListingResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing is not in draft state. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    publish_listing: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Listing ID (lst_ prefixed). */
+                listing_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListingResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Publish requirements not met. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    list_orders: {
+        parameters: {
+            query?: {
+                /** @description Filter orders by status. */
+                status?: components["schemas"]["OrderStatus"] | null;
+                /** @description Filter by listing ID (lst_ prefixed). */
+                listing?: string | null;
+                /** @description Filter by exact buyer email address. */
+                buyer_email?: string | null;
+                /** @description Only orders created after this ISO 8601 datetime. */
+                created_after?: string | null;
+                /** @description Only orders created before this ISO 8601 datetime. */
+                created_before?: string | null;
+                /** @description Pagination cursor from a previous response. */
+                cursor?: string | null;
+                /** @description Maximum number of orders to return. */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrderListResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_order: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Order ID. */
+                order_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrderResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Order not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    refund_order: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Order ID. */
+                order_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrderResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Order not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Order cannot be refunded (wrong status or no payment intent). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    deliver_order: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Order ID. */
+                order_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeliverOrderRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrderResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Order not found or not owned by this account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Order cannot be fulfilled. Possible reasons: order not in PAID state, listing uses managed fulfillment (auto-fulfilled on payment), or deliverable URL unreachable. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    ship_order: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Order ID. */
+                order_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ShipOrderRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrderResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Order not found or not owned by this account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Order cannot be shipped. Possible reasons: order not in PAID state, or listing uses managed fulfillment. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    start_stripe_connect: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StripeConnectSessionResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    disconnect_stripe: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        [key: string]: unknown;
+                    };
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    list_webhooks: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookListResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    create_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateWebhookRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation error. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    update_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Webhook endpoint ID. */
+                webhook_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateWebhookRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Webhook not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation error. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    delete_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Webhook endpoint ID. */
+                webhook_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Webhook not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    list_webhook_events: {
+        parameters: {
+            query?: {
+                /** @description Filter by delivery status. `true` for delivered, `false` for pending/failed. */
+                delivered?: boolean | null;
+                /** @description Pagination cursor from a previous response. */
+                cursor?: string | null;
+                /** @description Maximum number of events to return. */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Webhook endpoint ID. */
+                webhook_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookEventListResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Webhook not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    retry_webhook_event: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Webhook endpoint ID. */
+                webhook_id: string;
+                /** @description Webhook event ID. */
+                event_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookEventResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Webhook or event not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    test_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Webhook endpoint ID. */
+                webhook_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookTestResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Webhook not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+}