randmar-api-client 1.576.0 → 1.577.0

package/dist/store/randmarApi.d.ts

@@ -467,39 +467,39 @@ export type PostV4ShopifyByShopifyHostNameAccountSynchronizationAndSynchronizati
 export type PostV4ShopifyByShopifyHostNameAccountSynchronizationAndSynchronizationTypeApiArg = {
     /** The host name of the Shopify store. */
     shopifyHostName: string;
-    /** The type of synchronization to update (e.g., 'Products', 'Orders'). */
+    /** Orders or ProductInventory, producing SyncOrders or SyncProductInventory. Products is not a supported flag. */
     synchronizationType: string;
-    /** The new boolean value for the setting (true to enable, false to disable). */
+    /** Query boolean: true to enable or false to disable. */
     newValue?: boolean;
 };
 export type PostV4ShopifyByShopifyHostNameAccountAndPropertyNameApiResponse = unknown;
 export type PostV4ShopifyByShopifyHostNameAccountAndPropertyNameApiArg = {
     /** The host name of the Shopify store. */
     shopifyHostName: string;
-    /** The name of the account property to update. */
+    /** SyncOrders, ShipComplete, SyncProductInventory, or DefaultCustomization (case-insensitive). */
     propertyName: string;
-    /** The new boolean value for the property. */
+    /** Query boolean value for the property. */
     newValue?: boolean;
 };
 export type PostV4ShopifyByShopifyHostNameAccountDefaultShippingSlipCommentApiResponse = unknown;
 export type PostV4ShopifyByShopifyHostNameAccountDefaultShippingSlipCommentApiArg = {
     /** The host name of the Shopify store. */
     shopifyHostName: string;
-    /** The new default comment string. */
+    /** URL-encoded query text for the default shipping-slip comment. */
     newValue?: string;
 };
 export type PostV4ShopifyByShopifyHostNameAccountAdsGrowthStrategyApiResponse = unknown;
 export type PostV4ShopifyByShopifyHostNameAccountAdsGrowthStrategyApiArg = {
     /** The host name of the Shopify store. */
     shopifyHostName: string;
-    /** The ads growth strategy to store. */
+    /** URL-encoded query value using one of the listed strategies; matching is case-insensitive. */
     newValue?: string;
 };
 export type PostV4ShopifyByShopifyHostNameAccountAdvertisingBudgetPerDayApiResponse = unknown;
 export type PostV4ShopifyByShopifyHostNameAccountAdvertisingBudgetPerDayApiArg = {
     /** The host name of the Shopify store. */
     shopifyHostName: string;
-    /** The daily advertising budget to store. */
+    /** Nonnegative decimal budget supplied as a query value. */
     newValue?: number;
 };
 export type PutV4ShopifyByShopifyHostNameAccountLinkApiResponse = unknown;
@@ -529,7 +529,7 @@ export type PostV4PartnerByApplicationIdAccountAndFieldNameApiResponse = unknown
 export type PostV4PartnerByApplicationIdAccountAndFieldNameApiArg = {
     /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The name of the property to update. */
+    /** PublicName, About, VoiceName, VoiceStyle, or SceneName, with exact casing. */
     fieldName: string;
     /** The new value for the property. */
     newValue?: string;
@@ -639,7 +639,9 @@ export type PostV4PartnerByApplicationIdAccountBillingApiArg = {
 };
 export type PostV4PartnerByApplicationIdAccountResellerShippingApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerShippingApiArg = {
+    /** Target partner application ID. */
     applicationId: string;
+    /** JSON shipping name and complete address: Address1, Address2, City, Province, PostalCode, and Country. */
     newShippingInformation: NewShippingInformation;
 };
 export type PutV4PartnerByApplicationIdAccountSalesAgencyApiResponse = unknown;
@@ -758,9 +760,9 @@ export type DeleteV4PartnerByApplicationIdAccountSocialAndSocialNetworkApiArg =
 export type GetV4ManufacturerByRouteManufacturerIdAccountApiResponse = 
 /** status 200 The manufacturer's account information. */ Manufacturer;
 export type GetV4ManufacturerByRouteManufacturerIdAccountApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** If true, includes detailed specifications in the response. Defaults to true. */
+    /** Query parameter. If true, includes detailed specifications in the response. Defaults to true. */
     withSpecification?: boolean;
 };
 export type GetV4PartnerByRouteApplicationIdAdsPlatformsStatusApiResponse = 
@@ -782,24 +784,24 @@ export type GetV4AgencyByRouteAgencyIdApiArg = {
     routeAgencyId: string;
 };
 export type PostV4AgencyByRouteAgencyIdResellerSalesEmailApiResponse = 
-/** status 200 Returns the result of the email delivery request. */ boolean;
+/** status 200 False if no report content was produced; otherwise true after the send was attempted. This is not a delivery receipt. */ boolean;
 export type PostV4AgencyByRouteAgencyIdResellerSalesEmailApiArg = {
     /** The target agency application ID. Not HQ IDs such as `2` or `FGDCT3037`. Resolve names via `GET V4/Intranet/Search/Partners`. */
     routeAgencyId: string;
-    /** The destination email address that should receive the Excel report. */
+    /** Query destination address. An empty value falls back to the authenticated user. */
     emailAddress?: string;
-    /** The optional start date of the reporting period. */
+    /** Optional query start date in ISO 8601 form; an omitted value is passed to the reporting service's default period. */
     startDate?: string;
-    /** The optional end date of the reporting period. */
+    /** Optional query end date in ISO 8601 form; an omitted value is passed to the reporting service's default period. */
     endDate?: string;
 };
 export type PostV4AgencyByRouteAgencyIdResellerSalesFileApiResponse = unknown;
 export type PostV4AgencyByRouteAgencyIdResellerSalesFileApiArg = {
     /** The target agency application ID. Not HQ IDs such as `2` or `FGDCT3037`. Resolve names via `GET V4/Intranet/Search/Partners`. */
     routeAgencyId: string;
-    /** The optional start date of the reporting period. */
+    /** Optional query start date in ISO 8601 form; omitted values use the reporting service's default period. */
     startDate?: string;
-    /** The optional end date of the reporting period. */
+    /** Optional query end date in ISO 8601 form; omitted values use the reporting service's default period. */
     endDate?: string;
 };
 export type PostV4PartnerByApplicationIdAttachmentUploadApiResponse = 
@@ -1057,7 +1059,7 @@ export type PostV4ResellerByRouteResellerIdCartProcessAndCartNameApiArg = {
     shipToLocation: ShipToLocation;
 };
 export type PostV4ResellerByRouteResellerIdCartProcessNewAndCartNameApiResponse = 
-/** status 200 Returns an object that contains the OrderID that was created. If this fails, make sure items are in stock and have a bid number (when needed). */ ProcessOrderNewResponse;
+/** status 200 Returns an object with OrderNumber. The source cart is deleted after order creation. Custom shipping-slip failures are recorded as order comments, not returned as warnings or used to roll back the order. */ ProcessOrderNewResponse;
 export type PostV4ResellerByRouteResellerIdCartProcessNewAndCartNameApiArg = {
     /** The target reseller application ID. */
     routeResellerId: string;
@@ -1080,115 +1082,115 @@ export type DeleteV4ResellerByRouteResellerIdCartsApiArg = {
 export type GetV4ManufacturerByRouteManufacturerIdCategoriesApiResponse = 
 /** status 200 A list of manufacturer categories. */ ManufacturerCategory[];
 export type GetV4ManufacturerByRouteManufacturerIdCategoriesApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdCategoriesNichesApiResponse = 
 /** status 200 A list of product niches. */ ProductNiche[];
 export type GetV4ManufacturerByRouteManufacturerIdCategoriesNichesApiArg = {
-    /** The target manufacturer's application ID (authorization only). Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiResponse = 
 /** status 200 The requested category's information. */ ManufacturerCategory;
 export type GetV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The category code. Resolve from `GET .../Categories` if the user gave a name. */
+    /** Path parameter. The category code. Resolve from `GET .../Categories` if the user gave a name. */
     categoryCode: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The code for the new category (unique for this manufacturer). */
+    /** Path parameter. The code for the new category (unique for this manufacturer). */
     categoryCode: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The category code to delete. Resolve from `GET .../Categories`. */
+    /** Path parameter. The category code to delete. Resolve from `GET .../Categories`. */
     categoryCode: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeFieldNameApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeFieldNameApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The category code to update. Resolve from `GET .../Categories`. */
+    /** Path parameter. The category code to update. Resolve from `GET .../Categories`. */
     categoryCode: string;
-    /** Field to update: "WeeksOfStocking", "CategoryName", "Starred", "AutoReorder", "QualificationRequired", or "Niche". Case-sensitive; use the name from the category JSON. */
+    /** Path parameter. Field to update: "WeeksOfStocking", "CategoryName", "Starred", "AutoReorder", "QualificationRequired", or "Niche". Case-sensitive; use the name from the category JSON. */
     fieldName: string;
-    /** The new value for the field. */
+    /** Query parameter. The new value for the field. */
     newValue?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeAGpApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeAGpApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The code of the category to update. */
+    /** Path parameter. The code of the category to update. */
     categoryCode: string;
-    /** The new margin percentage. */
+    /** Query parameter. New margin value from 0 through 250 inclusive. */
     newValue?: number;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeBGpApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeBGpApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The code of the category to update. */
+    /** Path parameter. The code of the category to update. */
     categoryCode: string;
-    /** The new margin percentage. */
+    /** Query parameter. New margin value from 0 through 250 inclusive. */
     newValue?: number;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeCGpApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeCGpApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The code of the category to update. */
+    /** Path parameter. The code of the category to update. */
     categoryCode: string;
-    /** The new margin percentage. */
+    /** Query parameter. New margin value from 0 through 250 inclusive. */
     newValue?: number;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeDGpApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeDGpApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The code of the category to update. */
+    /** Path parameter. The code of the category to update. */
     categoryCode: string;
-    /** The new margin percentage. */
+    /** Query parameter. New margin value from 0 through 250 inclusive. */
     newValue?: number;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeCostGpApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeCostGpApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The code of the category to update. */
+    /** Path parameter. The code of the category to update. */
     categoryCode: string;
-    /** The new margin percentage. */
+    /** Query parameter. New margin value from 0 through 250 inclusive. */
     newValue?: number;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeResetApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeResetApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The category code to reset. Resolve from `GET .../Categories`. */
+    /** Path parameter. The category code to reset. Resolve from `GET .../Categories`. */
     categoryCode: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeStarredApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeStarredApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The category code to star or un-star. */
+    /** Path parameter. The category code to star or un-star. */
     categoryCode: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeImageApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeImageApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The code of the category to update. */
+    /** Path parameter. The code of the category to update. */
     categoryCode: string;
     body: {
-        /** The image file to upload. */
+        /** Multipart form field. The image file to upload. */
         file?: Blob;
     };
 };
@@ -1299,44 +1301,44 @@ export type GetV4PartnerByApplicationIdDocumentAndDocumentNumberPdfApiArg = {
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The document number (typically starts with PO, RCP, or RQN). Resolve from Documents lists if unknown. */
+    /** Path parameter. The document number (typically starts with PO, RCP, or RQN). Resolve from Documents lists if unknown. */
     documentNumber: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberPdfApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberPdfApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The unique number of the document to retrieve as a PDF. */
+    /** Path parameter. The unique number of the document to retrieve as a PDF. */
     documentNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The document number to send (PO, RCP, or RQN). */
+    /** Path parameter. The document number to send (PO, RCP, or RQN). */
     documentNumber: string;
-    /** The recipient email address. Confirm with the user; do not guess. */
+    /** Query parameter. The recipient email address. Confirm with the user; do not guess. */
     emailAddress?: string;
-    /** Optional comment included in the email body. */
+    /** Query parameter. Optional comment included in the email body. */
     comment?: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdDocumentSalesOrderAndOrderNumberExecuteApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdDocumentSalesOrderAndOrderNumberExecuteApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The sales order number to execute. Resolve from ActiveOrderDetails if unknown. */
+    /** Path parameter. The sales order number to execute. Resolve from ActiveOrderDetails if unknown. */
     orderNumber: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentSalesOrderAndOrderNumberApiResponse = 
 /** status 200 The requested sales order's data. */ Order;
 export type GetV4ManufacturerByRouteManufacturerIdDocumentSalesOrderAndOrderNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The sales order number. Resolve from ActiveOrderDetails or CompletedOrderDetails if unknown. */
+    /** Path parameter. The sales order number. Resolve from ActiveOrderDetails or CompletedOrderDetails if unknown. */
     orderNumber: string;
-    /** Whether to include detailed product specifications in the response. */
+    /** Query parameter. Defaults to true. False additionally loads ActiveOrderDetails and CompletedSalesOrderDetails; this flag does not request product specifications in this service. */
     withSpecification?: boolean;
 };
 export type GetV4ResellerByRouteResellerIdDocumentsActiveOrderDetailsApiResponse = 
@@ -1354,84 +1356,85 @@ export type GetV4ResellerByRouteResellerIdDocumentsGeneralDocumentsApiArg = {
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsRequisitionsApiResponse = 
 /** status 200 A list of requisitions. */ Requisition[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsRequisitionsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentRequisitionsApiResponse = 
 /** status 200 A list of requisitions. */ Requisition[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentRequisitionsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsPurchaseOrdersApiResponse = 
 /** status 200 A list of purchase orders. */ PurchaseOrder[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsPurchaseOrdersApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentPurchaseOrdersApiResponse = 
 /** status 200 A list of purchase orders. */ PurchaseOrder[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentPurchaseOrdersApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsReceiptsApiResponse = 
 /** status 200 A list of receipts. */ Receipt[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsReceiptsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentReceiptsApiResponse = 
 /** status 200 A list of receipts. */ Receipt[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentReceiptsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsInvoicesApiResponse = 
 /** status 200 A list of invoices. */ VendorDocument[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsInvoicesApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentInvoicesApiResponse = 
 /** status 200 A list of invoices. */ VendorDocument[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentInvoicesApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsActiveOrderDetailsApiResponse = 
 /** status 200 A list of active order details. */ OrderDetail[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsActiveOrderDetailsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentActiveOrderDetailsApiResponse = 
 /** status 200 A list of active order details. */ OrderDetail[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentActiveOrderDetailsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsCompletedOrderDetailsApiResponse = 
 /** status 200 A list of completed order details. */ OrderDetail[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsCompletedOrderDetailsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentCompletedOrderDetailsApiResponse = 
 /** status 200 A list of completed order details. */ OrderDetail[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentCompletedOrderDetailsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdDraftPurchasesApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdDraftPurchasesApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type PutV4PartnerEmailApiResponse = unknown;
 export type PutV4PartnerEmailApiArg = {
     /** The outbound email definition, including `ToEmails`, `Title`, `BodyHtml`, optional `ReplyTo`,
-      and optional publicly accessible attachment URLs. Inquiry messages must include the verified originating
+      and optional publicly accessible attachment URLs. Supply a non-null ToEmails array and nonblank Title and BodyHtml.
+      Inquiry messages must include the verified originating
       reseller/Partner and enough context for the recipient to respond. */
     sendEmailRequest: SendEmailRequest;
 };
@@ -1470,9 +1473,11 @@ export type GetV4PartnerByRouteApplicationIdGeneralDocumentsApiArg = {
     routeApplicationId: string;
 };
 export type PostV4PartnerByApplicationIdGenerationTextApiResponse = 
-/** status 200 OK */ GenerationResult;
+/** status 200 GenerationResult containing the generated content and context utilization. */ GenerationResult;
 export type PostV4PartnerByApplicationIdGenerationTextApiArg = {
+    /** Partner account whose authorization and generation context are used. */
     applicationId: string;
+    /** Conversation messages in order, including roles and content parts. */
     body: ContentSubset[];
 };
 export type PostV4PartnerByApplicationIdGenerationGoogleGroundedTextApiResponse = 
@@ -1518,15 +1523,19 @@ export type PostV4PartnerByApplicationIdGenerationUploadApiArg = {
     };
 };
 export type PostV4PartnerByApplicationIdGenerationV2JsonApiResponse = 
-/** status 200 OK */ GenerationResult;
+/** status 200 The JSON generation result. */ GenerationResult;
 export type PostV4PartnerByApplicationIdGenerationV2JsonApiArg = {
+    /** Partner account whose authorization and generation context are used. */
     applicationId: string;
+    /** Conversation messages in order, using the request schema for this endpoint. */
     body: ContentSubset[];
 };
 export type PostV4PartnerByApplicationIdGenerationV2RandmarAssistantApiResponse = 
-/** status 200 OK */ RandmarAssistantV2GenerationResult;
+/** status 200 The assistant text or function-call result. */ RandmarAssistantV2GenerationResult;
 export type PostV4PartnerByApplicationIdGenerationV2RandmarAssistantApiArg = {
+    /** Partner account whose authorization and generation context are used. */
     applicationId: string;
+    /** Conversation messages in order, using the request schema for this endpoint. */
     body: RandmarAssistantV2Content[];
 };
 export type PostV4PartnerByRouteApplicationIdGoogleAdsInvitationApiResponse = 
@@ -1538,7 +1547,7 @@ export type PostV4PartnerByRouteApplicationIdGoogleAdsInvitationApiArg = {
     shopifyHostName?: string;
 };
 export type GetV4PartnerByRouteApplicationIdGoogleAdsInvitationApiResponse = 
-/** status 200 OK */ GoogleAdsManagerInvitationStatus;
+/** status 200 Current manager-link status. IsAccepted is true only for an ACTIVE link. */ GoogleAdsManagerInvitationStatus;
 export type GetV4PartnerByRouteApplicationIdGoogleAdsInvitationApiArg = {
     /** The Randmar application ID that owns the Shopify store. */
     routeApplicationId: string;
@@ -1558,7 +1567,7 @@ export type GetV4PartnerByRouteApplicationIdGoogleAdsOverviewApiArg = {
     endDate?: string;
 };
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsApiResponse = 
-/** status 200 OK */ GoogleAdsCampaign[];
+/** status 200 Campaign collection; an empty collection is valid. */ GoogleAdsCampaign[];
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsApiArg = {
     /** The Randmar application ID that owns the Shopify store. */
     routeApplicationId: string;
@@ -1590,7 +1599,7 @@ export type DeleteV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAp
     validateOnly?: boolean;
 };
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdApiResponse = 
-/** status 200 OK */ GoogleAdsCampaignDetails;
+/** status 200 Selected campaign configuration and period totals. */ GoogleAdsCampaignDetails;
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdApiArg = {
     /** The Randmar application ID that owns the Shopify store. */
     routeApplicationId: string;
@@ -1632,7 +1641,7 @@ export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdConve
     endDate?: string;
 };
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAssetGroupsApiResponse = 
-/** status 200 OK */ GoogleAdsAssetGroup[];
+/** status 200 Asset-group collection for the selected campaign and reporting period. */ GoogleAdsAssetGroup[];
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAssetGroupsApiArg = {
     /** The Randmar application ID that owns the Shopify store. */
     routeApplicationId: string;
@@ -1646,7 +1655,7 @@ export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAsset
     endDate?: string;
 };
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAssetGroupsAssetGroupIdAssetsApiResponse = 
-/** status 200 OK */ GoogleAdsAssetGroupAsset[];
+/** status 200 Asset placements within the selected campaign asset group. */ GoogleAdsAssetGroupAsset[];
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAssetGroupsAssetGroupIdAssetsApiArg = {
     /** The Randmar application ID that owns the Shopify store. */
     routeApplicationId: string;
@@ -1662,7 +1671,7 @@ export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAsset
     endDate?: string;
 };
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAssetGroupsAssetGroupIdAssetsAssetIdApiResponse = 
-/** status 200 OK */ GoogleAdsAssetDetails;
+/** status 200 Selected asset and its placements within the specified group. */ GoogleAdsAssetDetails;
 export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAssetGroupsAssetGroupIdAssetsAssetIdApiArg = {
     /** The Randmar application ID that owns the Shopify store. */
     routeApplicationId: string;
@@ -1680,7 +1689,7 @@ export type GetV4PartnerByRouteApplicationIdGoogleAdsCampaignsAndCampaignIdAsset
     endDate?: string;
 };
 export type GetV4PartnerByRouteApplicationIdGoogleAdsBillingSetupsApiResponse = 
-/** status 200 OK */ GoogleAdsBillingSetup[];
+/** status 200 Billing setup records; does not create or change billing. */ GoogleAdsBillingSetup[];
 export type GetV4PartnerByRouteApplicationIdGoogleAdsBillingSetupsApiArg = {
     /** The Randmar application ID that owns the Shopify store. */
     routeApplicationId: string;
@@ -1718,7 +1727,7 @@ export type GetV4PartnerByRouteApplicationIdIntegrationKeysApiArg = {
 export type GetV4ManufacturerByRouteManufacturerIdInventoryValueApiResponse = 
 /** status 200 A list of inventory values. */ InventoryValueEntry[];
 export type GetV4ManufacturerByRouteManufacturerIdInventoryValueApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4PartnerByRouteApplicationIdJobAndJobIdApiResponse = 
@@ -1773,7 +1782,7 @@ export type PutV4PartnerByRouteApplicationIdJobsAssistantTaskAndJobIdScheduledTi
     routeApplicationId: string;
     /** The assistant task job ID. */
     jobId: string;
-    /** The new scheduled timestamp, in UTC Unix seconds. Use 0 to clear the scheduled time. */
+    /** JSON object with scheduledTimeSecondsUTC in UTC Unix seconds, more than one minute in the future. Zero is rejected. */
     setPartnerAssistantJobScheduledTimeInput: SetPartnerAssistantJobScheduledTimeInput;
 };
 export type GetV4PartnerByRouteApplicationIdLogsApiResponse = unknown;
@@ -1884,7 +1893,7 @@ export type GetV4AgencyByRouteAgencyIdManufacturersApiResponse =
 export type GetV4AgencyByRouteAgencyIdManufacturersApiArg = {
     /** The target agency application ID. Not HQ IDs such as `2` or `FGDCT3037`. Resolve partner/agency names via `GET V4/Intranet/Search/Partners`. */
     routeAgencyId: string;
-    /** Whether to include detailed specifications for each manufacturer. Defaults to false. */
+    /** Query flag, false by default. True adds SalesData and InventoryValue to each represented manufacturer. */
     withSpecification?: boolean;
 };
 export type GetV4AgencyByRouteAgencyIdManufacturersOpenOrdersApiResponse = 
@@ -1947,7 +1956,7 @@ export type GetV4PartnerByRouteApplicationIdMicrosoftAdsAccountsApiArg = {
     shopifyHostName?: string;
 };
 export type PostV4PartnerByRouteApplicationIdMicrosoftAdsAccountLinksApiResponse = 
-/** status 200 OK */ MicrosoftAdsAccountLinkResult;
+/** status 200 Management-link result; a pending invitation still requires client acceptance. */ MicrosoftAdsAccountLinkResult;
 export type PostV4PartnerByRouteApplicationIdMicrosoftAdsAccountLinksApiArg = {
     /** The Randmar application ID requesting the management link. */
     routeApplicationId: string;
@@ -1972,7 +1981,7 @@ export type GetV4ResellerByRouteResellerIdOpportunitiesApiArg = {
 };
 export type GetV4ManufacturerByRouteManufacturerIdOpportunitiesApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdOpportunitiesApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberApiResponse = 
@@ -2029,99 +2038,99 @@ export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumber
 };
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The opportunity payload (bid number, title, dates, default resellers, quoteOnly). */
+    /** JSON request body. The opportunity payload (bid number, title, dates, default resellers, quoteOnly). */
     createOpportunityInput: CreateOpportunityInput;
 };
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The existing bid number to renew. Resolve from `GET .../Opportunities`. */
+    /** Path parameter. The existing bid number to renew. Resolve from `GET .../Opportunities`. */
     bidNumber: string;
-    /** The new bid number, title, dates, and quoteOnly for the renewal. */
+    /** JSON request body. The new bid number, title, dates, and quoteOnly for the renewal. */
     renewOpportunityInput: RenewOpportunityInput;
 };
 export type GetV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiResponse = 
 /** status 200 The requested opportunity's data. */ OpportunityEntry;
 export type GetV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The bid number. Resolve from `GET .../Opportunities` if unknown. */
+    /** Path parameter. The bid number. Resolve from `GET .../Opportunities` if unknown. */
     bidNumber: string;
-    /** If true, includes detailed specifications. Defaults to true. */
+    /** Query parameter. If true, includes detailed specifications. Defaults to true. */
     withSpecification?: boolean;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The bid number to delete. Resolve from `GET .../Opportunities`. */
+    /** Path parameter. The bid number to delete. Resolve from `GET .../Opportunities`. */
     bidNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberFieldNameApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberFieldNameApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The bid number to edit. Resolve from `GET .../Opportunities`. */
+    /** Path parameter. The bid number to edit. Resolve from `GET .../Opportunities`. */
     bidNumber: string;
-    /** The opportunity field to edit. Case-sensitive; use the name from the opportunity JSON. */
+    /** Path parameter. The opportunity field to edit. Case-sensitive; use the name from the opportunity JSON. */
     fieldName: string;
-    /** The new value for the field. */
+    /** Query parameter. The new value for the field. */
     newValue?: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The bid number to edit. */
+    /** Path parameter. The bid number to edit. */
     bidNumber: string;
-    /** The reseller application ID to add. Resolve from the Resellers list. */
+    /** Path parameter. The reseller application ID to add. Resolve from the Resellers list. */
     resellerId: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The bid number to edit. */
+    /** Path parameter. The bid number to edit. */
     bidNumber: string;
-    /** The reseller application ID to remove from the bid. */
+    /** Path parameter. The reseller application ID to remove from the bid. */
     resellerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The bid number to send. */
+    /** Path parameter. The bid number to send. */
     bidNumber: string;
-    /** The reseller application ID on whose behalf the email is sent. */
+    /** Path parameter. The reseller application ID on whose behalf the email is sent. */
     resellerId: string;
-    /** The recipient email address. Confirm with the user; do not guess. */
+    /** Query parameter. The recipient email address. Confirm with the user; do not guess. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberPartNumberRandmarSkuApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberPartNumberRandmarSkuApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The bid number to edit. */
+    /** Path parameter. The bid number to edit. */
     bidNumber: string;
-    /** The Randmar SKU to add or update. Resolve from product GET if the user gave an MPN/UPC. */
+    /** Path parameter. The Randmar SKU to add or update. Resolve from product GET if the user gave an MPN/UPC. */
     randmarSku: string;
-    /** The bid amount (e.g., rebate value). */
+    /** Query parameter. The bid amount (e.g., rebate value). */
     bidPrice?: number;
-    /** The bid amount type. Defaults to "ItemRebate". */
+    /** Query parameter. The bid amount type. Defaults to "ItemRebate". */
     bidPriceType?: string;
-    /** If true, marks the bid as a Randmar discount. Requires super-admin authorization. */
+    /** Query parameter. If true, marks the bid as a Randmar discount. Requires super-admin authorization. */
     randmarDiscount?: boolean;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberPartNumberRandmarSkuApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberPartNumberRandmarSkuApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The bid number to edit. */
+    /** Path parameter. The bid number to edit. */
     bidNumber: string;
-    /** The Randmar SKU to remove. Resolve from product GET if the user gave an MPN/UPC. */
+    /** Path parameter. The Randmar SKU to remove. Resolve from product GET if the user gave an MPN/UPC. */
     randmarSku: string;
 };
 export type GetV4ResellerByRouteResellerIdOrderAndOrderNumberApiResponse = 
@@ -2175,7 +2184,9 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEmailApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdOrderAndDocumentNumberLuggaBeastApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndDocumentNumberLuggaBeastApiArg = {
+    /** Reseller application ID used to retrieve the document and notification recipients. */
     routeResellerId: string;
+    /** General-document or order identifier to include in the confirmation. */
     documentNumber: string;
 };
 export type DeleteV4ResellerByRouteResellerIdOrderAndOrderNumberCancelApiResponse = unknown;
@@ -2378,7 +2389,9 @@ export type GetV4PartnerByRouteApplicationIdPartnerAndPartnerIdApiArg = {
 };
 export type PutV4AgencyByRouteAgencyIdPartnerAndNewUserEmailAddressApiResponse = unknown;
 export type PutV4AgencyByRouteAgencyIdPartnerAndNewUserEmailAddressApiArg = {
+    /** The target sales agency's application ID, accessible to the caller. */
     routeAgencyId: string;
+    /** URL-encoded destination email address for the invitation. */
     newUserEmailAddress: string;
 };
 export type GetV4ShopifyByShopifyHostNameProductAndRandmarSkuApiResponse = 
@@ -2522,47 +2535,47 @@ export type PutV4PartnerByRouteApplicationIdProductAndRandmarSkuLocationDetailsW
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberApiResponse = 
 /** status 200 The requested product's data. */ Product;
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU, MPN, or UPC of the product to retrieve. */
+    /** Path parameter. The Randmar SKU, MPN, or UPC of the product to retrieve. */
     productNumber: string;
-    /** If true, includes detailed specifications in the response. Defaults to true. */
+    /** Query parameter. If true, includes detailed specifications in the response. Defaults to true. */
     withSpecification?: boolean;
 };
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberSalesStatisticsApiResponse = 
 /** status 200 A list of sales statistics for the product. */ SalesStatistic[];
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberSalesStatisticsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU, MPN, or UPC of the product. */
+    /** Path parameter. The Randmar SKU, MPN, or UPC of the product. */
     productNumber: string;
-    /** Optional start date for the reporting period. */
+    /** Query parameter. Optional start date; defaults to one year before the current server time. */
     startDate?: string;
-    /** Optional end date for the reporting period. */
+    /** Query parameter. Optional end date; defaults to the current server time. */
     endDate?: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdProductApiResponse = 
 /** status 200 The newly created product object (some fields may require re-fetch by Randmar SKU). */ Product;
 export type PutV4ManufacturerByRouteManufacturerIdProductApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The details of the product to create. */
+    /** JSON request body. The details of the product to create. */
     insertProductInput: InsertProductInput;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberFieldNameApiResponse = 
-/** status 200 A boolean: true if the update succeeded, false if validation, product lookup, or persistence failed. Re-fetch to verify. */ boolean;
+/** status 200 True if the update was successful. */ boolean;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberFieldNameApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU, MPN or UPC of the product to edit. */
+    /** Path parameter. The Randmar SKU, MPN or UPC of the product to edit. */
     productNumber: string;
-    /** Case-sensitive field name from the supported list in this operation's description. */
+    /** Path parameter. Case-sensitive supported field: State, CountryCodeOfOrigin, UnitHeight, UnitLength, UnitWidth, Require3DScan, MasterCarton, UnitWeight, OpportunityOnly, TransparencyCode, SerialNumber, Category, StandardCost, MPN, AutoUpdate, SkidQuantity, Title, MSRP, MAP, BodyHTML, VoiceoverCaption, or SceneName. */
     fieldName: string;
-    /** Scalar new value serialized as a query parameter string. */
+    /** Query parameter. The new value for the field. */
     newValue?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberBodyHtmlApiResponse = 
-/** status 200 A boolean: true if the update succeeded, false if the product could not be found or persistence failed. Re-fetch to verify. */ boolean;
+/** status 200 True if the update was successful. */ boolean;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberBodyHtmlApiArg = {
     /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
@@ -2578,65 +2591,65 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberRandma
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberDiscontinueApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberDiscontinueApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU, MPN, or UPC of the product to discontinue. */
+    /** Path parameter. The Randmar SKU, MPN, or UPC of the product to discontinue. */
     productNumber: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdProductAndProductNumberOrderNumberApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdProductAndProductNumberOrderNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU, MPN, or UPC of the product to cancel. */
+    /** Path parameter. The Randmar SKU, MPN, or UPC of the product to cancel. */
     productNumber: string;
-    /** The order number from which to cancel the product. */
+    /** Path parameter. The order number from which to cancel the product. */
     orderNumber: string;
-    /** An optional comment for the cancellation reason. */
+    /** Query parameter. An optional comment for the cancellation reason. */
     comment?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberUpcApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberUpcApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU or MPN of the product to update. */
+    /** Path parameter. The Randmar SKU or MPN of the product to update. */
     productNumber: string;
-    /** The new UPC value. */
+    /** Query parameter. The new UPC value. */
     newValue?: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuInstantRebateApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuInstantRebateApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product to apply the rebate to. */
+    /** Path parameter. The Randmar SKU of the product to apply the rebate to. */
     randmarSku: string;
-    /** The details of the instant rebate. */
+    /** JSON request body. The details of the instant rebate. */
     instantRebateInput: InstantRebateInput;
 };
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuRequisitionApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuRequisitionApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product to add. */
+    /** Path parameter. The Randmar SKU of the product to add. */
     randmarSku: string;
-    /** The warehouse location code for the requisition. */
+    /** Query parameter. The warehouse location code for the requisition. */
     location?: string;
-    /** The quantity to add (should be the product `MasterCarton` value). */
+    /** Query parameter. The quantity to add (should be the product `MasterCarton` value). */
     quantity?: number;
 };
 export type GetV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiResponse = 
 /** status 200 A list of product images. */ ProductImageInfo[];
 export type GetV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product. */
+    /** Path parameter. The Randmar SKU of the product. */
     randmarSku: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiResponse = 
 /** status 200 Information about the uploaded image. */ ProductImageUploadResult;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product. */
+    /** Path parameter. The Randmar SKU of the product. */
     randmarSku: string;
     body: {
         /** The image file to upload. */
@@ -2650,101 +2663,101 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApi
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAttachmentApiResponse = 
 /** status 200 The registered attachment UUID. */ string;
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAttachmentApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product. */
+    /** Path parameter. The Randmar SKU of the product. */
     randmarSku: string;
-    /** The registration payload containing the temporary storage key. */
+    /** JSON request body. The registration payload containing the temporary storage key. */
     randmarApiControllersV4ManufacturerProductControllerRegisterProductAttachmentRequest: RandmarApiControllersV4ManufacturerProductControllerRegisterProductAttachmentRequest;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAppendImageApiResponse = 
 /** status 200 Information about the appended image. */ ProductImageUploadResult;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAppendImageApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product. */
+    /** Path parameter. The Randmar SKU of the product. */
     randmarSku: string;
-    /** JSON payload containing the public image URL and optional metadata. */
+    /** JSON request body. JSON payload containing the public image URL and optional metadata. */
     randmarApiControllersV4ManufacturerProductControllerAppendProductImageRequest: RandmarApiControllersV4ManufacturerProductControllerAppendProductImageRequest;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesImageIdPrimaryApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesImageIdPrimaryApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product. */
+    /** Path parameter. The Randmar SKU of the product. */
     randmarSku: string;
-    /** The image ID to set as primary. */
+    /** Path parameter. The image ID to set as primary. */
     imageId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesReorderApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesReorderApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product. */
+    /** Path parameter. The Randmar SKU of the product. */
     randmarSku: string;
-    /** The desired image ordering. */
+    /** JSON request body. The desired image ordering. */
     reorderProductImagesInput: ReorderProductImagesInput;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesImageIdApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesImageIdApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product. */
+    /** Path parameter. The Randmar SKU of the product. */
     randmarSku: string;
-    /** The image ID to delete. */
+    /** Path parameter. The image ID to delete. */
     imageId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImageApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImageApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product to update. */
+    /** Path parameter. The Randmar SKU of the product to update. */
     randmarSku: string;
     body: {
-        /** The image file to upload. */
+        /** Multipart form field. The image file to upload. */
         file?: Blob;
     };
 };
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuGenerateImageApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuGenerateImageApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product. */
+    /** Path parameter. The Randmar SKU of the product. */
     randmarSku: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumber3DModelApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumber3DModelApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU, MPN, or UPC of the product. */
+    /** Path parameter. The Randmar SKU, MPN, or UPC of the product. */
     productNumber: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumber3DModelExistsApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumber3DModelExistsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU, MPN, or UPC of the product. */
+    /** Path parameter. The Randmar SKU, MPN, or UPC of the product. */
     productNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSku3DModelApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSku3DModelApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product to update. */
+    /** Path parameter. The Randmar SKU of the product to update. */
     randmarSku: string;
     body: {
-        /** The 3D model file to upload (e.g., .glb). */
+        /** Multipart form field. The 3D model file to upload (e.g., .glb). */
         file?: Blob;
     };
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuVideoApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuVideoApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The Randmar SKU of the product to update. */
+    /** Path parameter. The Randmar SKU of the product to update. */
     randmarSku: string;
     body: {
-        /** The video file to upload. */
+        /** Multipart form field. The video file to upload. */
         file?: Blob;
     };
 };
@@ -2781,7 +2794,7 @@ export type GetV4PartnerByRouteApplicationIdProductsApiArg = {
 export type GetV4ManufacturerByRouteManufacturerIdProductsApiResponse = 
 /** status 200 A list of products. */ Product[];
 export type GetV4ManufacturerByRouteManufacturerIdProductsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetGuidelinesApiResponse = unknown;
@@ -2867,7 +2880,7 @@ export type GetProductByRandmarSkuImageAndImageIdApiArg = {
     width?: number;
     /** Optional desired height of the image. */
     height?: number;
-    /** Optional alignment for letterboxing (Left/Right). */
+    /** Optional horizontal alignment for padding: Left or Right (case-insensitive); otherwise centered. */
     align?: string;
 };
 export type GetProductByRandmarSkuImageApiResponse = unknown;
@@ -2931,87 +2944,94 @@ export type GetShortsGenerationContentSceneBySceneNameAmbientSoundApiArg = {
 };
 export type GetWarehousesByPostalCodeApiResponse = unknown;
 export type GetWarehousesByPostalCodeApiArg = {
-    /** Ship-to postal/ZIP code. */
+    /** Query ship-to postal/ZIP code; send the canonical uppercase form because matching uses stored prefixes. */
     postalCode?: string;
-    /** Ship-to country code (typically CA or US). */
+    /** Query country code, normally CA or US. Empty values default to CA; matching is case-sensitive. */
     country?: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdPurchaseOrderApiResponse = 
 /** status 200 The purchase order number of the newly created purchase order. */ string;
 export type PutV4ManufacturerByRouteManufacturerIdPurchaseOrderApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** If true, the PO is sent to the manufacturer on create. Defaults to true—confirm with the user before calling. */
+    /** Query parameter. If true, the PO is sent to the manufacturer on create. Defaults to true—confirm with the user before calling. */
     sendToManufacturer?: boolean;
-    /** Requisition numbers to include. Obtain from `GET .../Documents/Requisitions`. */
+    /** JSON request body. Requisition numbers to include. Obtain from `GET .../Documents/Requisitions`. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderCreditCheckApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderCreditCheckApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Requisition numbers to credit-check. Obtain from `GET .../Documents/Requisitions`. */
+    /** JSON request body. Requisition numbers to credit-check. Obtain from `GET .../Documents/Requisitions`. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberEditExpectedDateApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberEditExpectedDateApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The PO number (typically starts with PO). Resolve from Documents/PurchaseOrders if unknown. */
+    /** Path parameter. The PO number (typically starts with PO). Resolve from Documents/PurchaseOrders if unknown. */
     purchaseOrderNumber: string;
-    /** The new expected date as a string (e.g., "YYYYMMDD"). */
+    /** Query parameter. The new expected date as a string (e.g., "YYYYMMDD"). */
     newValue?: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The PO number to cancel. Resolve from Documents/PurchaseOrders if unknown. */
+    /** Path parameter. The PO number to cancel. Resolve from Documents/PurchaseOrders if unknown. */
     purchaseOrderNumber: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberSendApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberSendApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The PO number to send. Resolve from Documents/PurchaseOrders if unknown. */
+    /** Path parameter. The PO number to send. Resolve from Documents/PurchaseOrders if unknown. */
     purchaseOrderNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberEditItemRandmarSkuApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberEditItemRandmarSkuApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The PO number to edit. */
+    /** Path parameter. The PO number to edit. */
     purchaseOrderNumber: string;
-    /** The Randmar SKU on the PO. Resolve from product GET if the user gave an MPN/UPC. */
+    /** Path parameter. The Randmar SKU on the PO. Resolve from product GET if the user gave an MPN/UPC. */
     randmarSku: string;
-    /** New quantity. 0 removes the item from the PO. */
+    /** Query parameter. Optional replacement order quantity; null leaves quantity unchanged. */
     quantity?: number;
-    /** New unit price for the line. */
+    /** Query parameter. Optional replacement unit price. Values at or below zero are ignored. */
     unitPrice?: number;
-    /** If true, also sets standard cost to unitPrice (catalog cost change). */
+    /** Query parameter. Defaults to false. When true and a positive unitPrice is supplied, also attempts to update the product StandardCost. */
     editStandardCost?: boolean;
 };
 export type GetV4PartnerByRouteApplicationIdStripeSubscriptionApiResponse = 
-/** status 200 OK */ RandmarSubscriptionStatus;
+/** status 200 Saved subscription status, including a default unsubscribed status when no subscription record exists. Response is not cached. */ RandmarSubscriptionStatus;
 export type GetV4PartnerByRouteApplicationIdStripeSubscriptionApiArg = {
+    /** Partner application ID identifying the reseller. */
     routeApplicationId: string;
 };
 export type PostV4PartnerByRouteApplicationIdStripeSubscriptionCheckoutApiResponse = 
-/** status 200 OK */ RandmarSubscriptionSession;
+/** status 200 Hosted session URL. Opening a session does not confirm a billing change. */ RandmarSubscriptionSession;
 export type PostV4PartnerByRouteApplicationIdStripeSubscriptionCheckoutApiArg = {
+    /** Partner application ID identifying the reseller; requires authorization for this account. */
     routeApplicationId: string;
+    /** When true, return HTTP 303 with the hosted URL in Location; otherwise return a JSON SessionUrl. */
     redirect?: boolean;
 };
 export type PostV4PartnerByRouteApplicationIdStripeSubscriptionCancelApiResponse = 
-/** status 200 OK */ RandmarSubscriptionSession;
+/** status 200 Hosted session URL. Opening a session does not confirm a billing change. */ RandmarSubscriptionSession;
 export type PostV4PartnerByRouteApplicationIdStripeSubscriptionCancelApiArg = {
+    /** Partner application ID identifying the reseller; requires authorization for this account. */
     routeApplicationId: string;
+    /** When true, return HTTP 303 with the hosted URL in Location; otherwise return a JSON SessionUrl. */
     redirect?: boolean;
 };
 export type PostV4PartnerByRouteApplicationIdStripeSubscriptionPortalApiResponse = 
-/** status 200 OK */ RandmarSubscriptionSession;
+/** status 200 Hosted session URL. Opening a session does not confirm a billing change. */ RandmarSubscriptionSession;
 export type PostV4PartnerByRouteApplicationIdStripeSubscriptionPortalApiArg = {
+    /** Partner application ID identifying the reseller; requires authorization for this account. */
     routeApplicationId: string;
+    /** When true, return HTTP 303 with the hosted URL in Location; otherwise return a JSON SessionUrl. */
     redirect?: boolean;
 };
 export type PostV4ResellerByRouteResellerIdReportHpAmplifiedEmailApiResponse = unknown;
@@ -3139,262 +3159,262 @@ export type PostV4ResellerByRouteResellerIdReportWalmartTrackingFileFileApiArg =
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Recipient email (optional; if empty, sends to the authenticated user). Confirm before sending. */
+    /** Query parameter. Recipient email address. When empty, the report service uses the authenticated caller’s email. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportResellersEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportResellersEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Recipient email (optional; if empty, sends to the authenticated user). Confirm before sending. */
+    /** Query parameter. Recipient email address. When empty, the report service uses the authenticated caller’s email. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderFileApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderAndWarehouseLocationJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderAndWarehouseLocationJsonApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The warehouse location code (business/DC identifier) for the report. */
+    /** Path parameter. The warehouse location code (business/DC identifier) for the report. */
     warehouseLocation: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Recipient email (optional; if empty, sends to the authenticated user). Confirm before sending. */
+    /** Query parameter. Recipient email address. When empty, the report service uses the authenticated caller’s email. */
     emailAddress?: string;
-    /** Optional start date. Defaults to the first day of the current month if omitted. */
+    /** Query parameter. Optional report start date. If omitted, uses the first day of the current server month. */
     startDate?: string;
-    /** Optional end date. Defaults to the first day of the current month if omitted. */
+    /** Query parameter. Optional report end date. If omitted, also uses the first day of the current server month; supply explicit bounds for a full-month report. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesAndResellerIdEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesAndResellerIdEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The reseller application ID to scope the report. Resolve from the Resellers list. */
+    /** Path parameter. The reseller application ID to scope the report. Resolve from the Resellers list. */
     resellerId: string;
-    /** Recipient email (optional; if empty, sends to the authenticated user). Confirm before sending. */
+    /** Query parameter. Recipient email address. When empty, the report service uses the authenticated caller’s email. */
     emailAddress?: string;
-    /** Optional start date. Defaults to the first day of the current month if omitted. */
+    /** Query parameter. Optional report start date. If omitted, uses the first day of the current server month. */
     startDate?: string;
-    /** Optional end date. Defaults to the first day of the current month if omitted. */
+    /** Query parameter. Optional report end date. If omitted, also uses the first day of the current server month; supply explicit bounds for a full-month report. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesFileApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Optional start date. Defaults to the first day of the current month if omitted. */
+    /** Query parameter. Optional report start date. If omitted, uses the first day of the current server month. */
     startDate?: string;
-    /** Optional end date. Defaults to the first day of the current month if omitted. */
+    /** Query parameter. Optional report end date. If omitted, also uses the first day of the current server month; supply explicit bounds for a full-month report. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesJsonApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Optional start date. Defaults to the first day of the current month if omitted. */
+    /** Query parameter. Optional report start date. If omitted, uses the first day of the current server month. */
     startDate?: string;
-    /** Optional end date. Defaults to the first day of the current month if omitted. */
+    /** Query parameter. Optional report end date. If omitted, also uses the first day of the current server month; supply explicit bounds for a full-month report. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportBestCanadianFulfillmentCentersApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportBestCanadianFulfillmentCentersApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Canadian postal codes. Codes longer than 7 characters are ignored. */
+    /** JSON request body. Canadian postal codes. Codes longer than 7 characters are ignored. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportBestActiveCanadianFulfillmentCentersApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportBestActiveCanadianFulfillmentCentersApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Canadian postal codes. Codes longer than 7 characters are ignored. */
+    /** JSON request body. Canadian postal codes. Codes longer than 7 characters are ignored. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportBestCanadianWarehousesApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportBestCanadianWarehousesApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Canadian postal codes. Codes longer than 7 characters are ignored. */
+    /** JSON request body. Canadian postal codes. Codes longer than 7 characters are ignored. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Recipient email. Confirm before sending. */
+    /** Query parameter. Recipient email address. When empty, the report service uses the authenticated caller’s email. */
     emailAddress?: string;
-    /** Inventory as-of date. Defaults to the current date if omitted. */
+    /** Query parameter. Inventory as-of date. Defaults to the current date if omitted. */
     inventoryDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryFileApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Inventory as-of date. Defaults to the current date if omitted. */
+    /** Query parameter. Inventory as-of date. Defaults to the current date if omitted. */
     inventoryDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryJsonApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Inventory as-of date. Defaults to the current date if omitted. */
+    /** Query parameter. Inventory as-of date. Defaults to the current date if omitted. */
     inventoryDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportClaimEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportClaimEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Recipient email (required; no fallback). Confirm before sending. */
+    /** Query parameter. Semicolon-separated recipient addresses. If omitted (null), uses subscribers to the manufacturer-claims notification; internal claim contacts are also copied. */
     emailAddress?: string;
-    /** Optional start date for the claim report. */
+    /** Query parameter. Optional start date for the claim report. */
     startDate?: string;
-    /** Optional end date for the claim report. */
+    /** Query parameter. Optional end date for the claim report. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportClaimFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportClaimFileApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Optional start date for the claim report. */
+    /** Query parameter. Optional start date for the claim report. */
     startDate?: string;
-    /** Optional end date for the claim report. */
+    /** Query parameter. Optional end date for the claim report. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportOpenOrdersEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportOpenOrdersEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Recipient email. Confirm before sending. */
+    /** Query parameter. Recipient email address. When empty, the report service uses the authenticated caller’s email. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportOpenOrdersJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportOpenOrdersJsonApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Unused by the service; you may pass an empty string. */
+    /** Query parameter. Legacy unused query parameter; this action does not send an email. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Recipient email. Confirm before sending. */
+    /** Query parameter. Recipient email address. When empty, the report service uses the authenticated caller’s email. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsFileApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsTsvApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsTsvApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsJsonApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportPurchasedOrdersEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportPurchasedOrdersEmailApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** Recipient email. Confirm before sending. */
+    /** Query parameter. Recipient email address. When empty, the report service uses the authenticated caller’s email. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportPurchasedOrdersFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportPurchasedOrdersFileApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumberApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumberApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The requisition number to cancel. Obtain from `GET .../Documents/Requisitions`. */
+    /** Path parameter. The requisition number to cancel. Obtain from `GET .../Documents/Requisitions`. */
     requisitionNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumberEditItemRandmarSkuApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumberEditItemRandmarSkuApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The requisition number to edit. Obtain from `GET .../Documents/Requisitions`. */
+    /** Path parameter. The requisition number to edit. Obtain from `GET .../Documents/Requisitions`. */
     requisitionNumber: string;
-    /** The Randmar SKU to edit. */
+    /** Path parameter. The Randmar SKU to edit. */
     randmarSku: string;
-    /** The new quantity (0 removes the item). */
+    /** Query parameter. The new quantity (0 removes the item). */
     quantity?: number;
 };
 export type PutV4ManufacturerByRouteManufacturerIdRequisitionApiResponse = 
 /** status 200 The requisition number of the newly created requisition. */ string;
 export type PutV4ManufacturerByRouteManufacturerIdRequisitionApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The requisition payload including location, reference, and part numbers with quantities. */
+    /** JSON request body. The requisition payload including location, reference, and part numbers with quantities. */
     createRequisitionInput: CreateRequisitionInput;
 };
 export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdApiResponse = 
 /** status 200 The requested reseller's information. */ Reseller;
 export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The reseller application ID. Resolve from the Resellers list if the user gave a name. */
+    /** Path parameter. The reseller application ID. Resolve from the Resellers list if the user gave a name. */
     resellerId: string;
-    /** Whether to include detailed specifications in the response. Defaults to true. */
+    /** Query parameter. Whether to include detailed specifications in the response. Defaults to true. */
     withSpecification?: boolean;
 };
 export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdSalesStatisticsApiResponse = 
 /** status 200 A list of sales statistics for the reseller. */ SalesStatistic[];
 export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdSalesStatisticsApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The reseller application ID whose sales statistics are requested. */
+    /** Path parameter. The reseller application ID whose sales statistics are requested. */
     resellerId: string;
-    /** Optional start date for the statistics period. */
+    /** Query parameter. Optional start date for the statistics period. */
     startDate?: string;
-    /** Optional end date for the statistics period. */
+    /** Query parameter. Optional end date for the statistics period. */
     endDate?: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdResellerQualificationAndQualificationIdApiResponse = 
 /** status 200 The requested reseller's information. */ Reseller;
 export type GetV4ManufacturerByRouteManufacturerIdResellerQualificationAndQualificationIdApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The qualification ID associated with the reseller. */
+    /** Path parameter. The qualification ID associated with the reseller. */
     qualificationId: string;
-    /** Whether to include detailed specifications in the response. Defaults to false. */
+    /** Query parameter. Whether to include detailed specifications in the response. Defaults to false. */
     withSpecification?: boolean;
 };
 export type PutV4ManufacturerByRouteManufacturerIdResellerAndResellerIdQualificationApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdResellerAndResellerIdQualificationApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The reseller application ID to qualify. Resolve from the Resellers list if needed. */
+    /** Path parameter. The reseller application ID to qualify. Resolve from the Resellers list if needed. */
     resellerId: string;
-    /** The qualification value to assign. */
+    /** Query parameter. The qualification value to assign. */
     newValue?: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdResellerAndResellerIdQualificationApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdResellerAndResellerIdQualificationApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The reseller application ID whose qualification will be removed. */
+    /** Path parameter. The reseller application ID whose qualification will be removed. */
     resellerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdResellersApiResponse = 
 /** status 200 A list of resellers. */ Reseller[];
 export type GetV4ManufacturerByRouteManufacturerIdResellersApiArg = {
-    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4AgencyByRouteAgencyIdResellersApiResponse = 
@@ -3402,13 +3422,15 @@ export type GetV4AgencyByRouteAgencyIdResellersApiResponse =
 export type GetV4AgencyByRouteAgencyIdResellersApiArg = {
     /** The target agency application ID. Not HQ IDs such as `2` or `FGDCT3037`. Resolve partner/agency names via `GET V4/Intranet/Search/Partners`. */
     routeAgencyId: string;
-    /** Whether to include detailed specifications for each reseller. Defaults to false. */
+    /** Query flag, false by default. True adds SalesData and agency information, including the reseller association's ProgramPercentage. */
     withSpecification?: boolean;
 };
 export type GetV4ResellerByRouteResellerIdReturnAndReturnNumberApiResponse = 
-/** status 200 OK */ ReturnOld;
+/** status 200 Return details and related records. */ ReturnOld;
 export type GetV4ResellerByRouteResellerIdReturnAndReturnNumberApiArg = {
+    /** Target reseller application ID. */
     routeResellerId: string;
+    /** Return number to retrieve within that reseller's account. */
     returnNumber: string;
 };
 export type PostV4ResellerByRouteResellerIdReturnCreateApiResponse = unknown;
@@ -3435,8 +3457,11 @@ export type PutV4ResellerByRouteResellerIdReturnAndReturnNumberManufacturerRmaAp
 };
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberAddCommentApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberAddCommentApiArg = {
+    /** Target reseller application ID. */
     routeResellerId: string;
+    /** Return number belonging to the reseller. */
     returnNumber: string;
+    /** Comment text supplied as a query parameter. */
     comment?: string;
 };
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberRandmarSkuEditReasonApiResponse = unknown;
@@ -3491,7 +3516,7 @@ export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberCreditApiRespons
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberCreditApiArg = {
     /** The return number to be credited. */
     returnNumber: string;
-    /** The optional credit document number to associate with this credit. */
+    /** Required existing credit document number: exactly eight characters beginning with CN. */
     creditNumber?: string;
     routeResellerId: string;
 };
@@ -3505,7 +3530,7 @@ export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberDeclineApiArg =
     reason?: string;
 };
 export type PutV4ResellerByRouteResellerIdReturnAndReturnNumberAdminCreditApiResponse = 
-/** status 200 Returns a result object indicating success. */ string;
+/** status 200 Created credit document number. The return is linked and marked Credited; credit-email failures do not roll back the credit. */ string;
 export type PutV4ResellerByRouteResellerIdReturnAndReturnNumberAdminCreditApiArg = {
     /** The return number to be credited. */
     returnNumber: string;
@@ -3559,7 +3584,7 @@ export type GetV4ResellerByRouteResellerIdReturnsApiArg = {
 export type GetV4ManufacturerByRouteManufacturerIdReturnsApiResponse = 
 /** status 200 A list of returns. */ ReturnOld[];
 export type GetV4ManufacturerByRouteManufacturerIdReturnsApiArg = {
-    /** The ID of the manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
 };
 export type GetV4ShopifyByShopifyHostNameSearchApiResponse = 
@@ -3567,7 +3592,7 @@ export type GetV4ShopifyByShopifyHostNameSearchApiResponse =
 export type GetV4ShopifyByShopifyHostNameSearchApiArg = {
     /** The host name of the Shopify store (e.g., 'your-store.myshopify.com'). */
     shopifyHostName: string;
-    /** The search query string. */
+    /** URL-encoded query text; use at least three characters for catalog searching. */
     q?: string;
 };
 export type GetV4ResellerByRouteResellerIdSearchApiResponse = 
@@ -3587,11 +3612,11 @@ export type GetV4PartnerByRouteApplicationIdSearchApiArg = {
     q?: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdSearchApiResponse = 
-/** status 200 An array of search results matching the query. */ SearchResult;
+/** status 200 A JSON array of typed search hits; an empty array when the manufacturer is unavailable, the query is too short, or no matches are found. */ SearchResult;
 export type GetV4ManufacturerByRouteManufacturerIdSearchApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** Path parameter. Target manufacturer application ID; this identifies the manufacturer being accessed, not the caller’s application. */
     routeManufacturerId: string;
-    /** The search query string (e.g., order number, reseller name, product SKU). */
+    /** Query parameter. Search query, at least three characters. Supports recognized PO/RCP/RQN numbers and general reseller, product, or opportunity terms. */
     s?: string;
 };
 export type PutV4ResellerByRouteResellerIdShippingLabelGenerateApiResponse = 
@@ -4150,6 +4175,7 @@ export type DeleteV4PartnerByRouteApplicationIdWorkflowProjectAndProjectIdTaskTa
 };
 export type PutV4PartnerByRouteApplicationIdWorkflowAssistantTaskApiResponse = unknown;
 export type PutV4PartnerByRouteApplicationIdWorkflowAssistantTaskApiArg = {
+    /** Partner application whose workflows the queued assistant should process. */
     routeApplicationId: string;
 };
 export type PostV4PartnerByRouteApplicationIdWorkflowProjectAndProjectIdTaskTaskIdStandardOperatingProcedureSopIdApiResponse = unknown;