randmar-api-client 1.508.0 → 1.509.0

package/dist/store/randmarApi.d.ts

@@ -510,7 +510,7 @@ export type PutV4ShopifyByShopifyHostNameAccountLinkApiArg = {
 export type GetV4ResellerByRouteResellerIdAccountGeneralApiResponse = 
 /** status 200 The reseller's account information. */ Reseller;
 export type GetV4ResellerByRouteResellerIdAccountGeneralApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Whether to include detailed specifications in the response. Defaults to true. */
     withSpecification?: boolean;
@@ -523,7 +523,7 @@ export type GetV4PartnerByApplicationIdAccountApiArg = {
 };
 export type PostV4PartnerByApplicationIdAccountAndFieldNameApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountAndFieldNameApiArg = {
-    /** The application ID of the partner to update. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The name of the property to update. */
     fieldName: string;
@@ -532,9 +532,9 @@ export type PostV4PartnerByApplicationIdAccountAndFieldNameApiArg = {
 };
 export type PostV4PartnerByApplicationIdAccountAboutApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountAboutApiArg = {
-    /** The application ID of the Partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The new text content for the 'About' section. */
+    /** The new text content for the About section. */
     body: string;
 };
 export type GetV4PartnerByApplicationIdAccountLogoApiResponse = unknown;
@@ -550,7 +550,7 @@ export type GetV4PartnerByApplicationIdAccountLogoApiArg = {
 };
 export type PostV4PartnerByApplicationIdAccountLogoApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountLogoApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     body: {
         /** The logo file to upload. */
@@ -569,7 +569,7 @@ export type GetV4PartnerByApplicationIdAccountVideoApiArg = {
 };
 export type PostV4PartnerByApplicationIdAccountVideoApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountVideoApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     body: {
         /** The video file to upload. */
@@ -582,27 +582,29 @@ export type GetV4PartnerByApplicationIdAccountVideoExistsApiArg = {
     applicationId: string;
 };
 export type GetV4PartnerByApplicationIdAccountManufacturerApiResponse = 
-/** status 200 Returns the manufacturer information */ Manufacturer;
+/** status 200 Returns the manufacturer information. */ Manufacturer;
 export type GetV4PartnerByApplicationIdAccountManufacturerApiArg = {
-    /** The application ID of the manufacturer */
+    /** The manufacturer partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** Whether to include detailed specification information (default: true) */
+    /** Whether to include detailed specification information (default: true). */
     withSpecification?: boolean;
 };
 export type PutV4PartnerByApplicationIdAccountManufacturerApiResponse = unknown;
 export type PutV4PartnerByApplicationIdAccountManufacturerApiArg = {
+    /** The partner application ID to convert. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
 };
 export type GetV4PartnerByApplicationIdAccountResellerApiResponse = 
-/** status 200 Returns the reseller information */ Reseller;
+/** status 200 Returns the reseller information. */ Reseller;
 export type GetV4PartnerByApplicationIdAccountResellerApiArg = {
-    /** The application ID of the reseller */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** Whether to include detailed specification information (default: true) */
+    /** Whether to include detailed specification information (default: true). */
     withSpecification?: boolean;
 };
 export type PutV4PartnerByApplicationIdAccountResellerApiResponse = unknown;
 export type PutV4PartnerByApplicationIdAccountResellerApiArg = {
+    /** The partner application ID to convert. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
 };
 export type GetV4PartnerByApplicationIdAccountVendorApiResponse = 
@@ -632,6 +634,7 @@ export type PutV4PartnerByApplicationIdAccountBillingBuyingGroupApiArg = {
 };
 export type PutV4PartnerByApplicationIdAccountSalesAgencyApiResponse = unknown;
 export type PutV4PartnerByApplicationIdAccountSalesAgencyApiArg = {
+    /** The partner application ID to convert. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
 };
 export type PostV4PartnerByApplicationIdAccountFeedbackApiResponse = unknown;
@@ -645,7 +648,7 @@ export type PostV4PartnerByApplicationIdAccountFeedbackApiArg = {
 };
 export type PostV4PartnerByApplicationIdAccountDebugFeedbackApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountDebugFeedbackApiArg = {
-    /** The application ID of the partner submitting the feedback. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The email address for follow-up. */
     emailAddress?: string;
@@ -654,7 +657,7 @@ export type PostV4PartnerByApplicationIdAccountDebugFeedbackApiArg = {
 };
 export type PostV4PartnerByApplicationIdAccountManufacturerAndFieldNameApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountManufacturerAndFieldNameApiArg = {
-    /** The application ID of the manufacturer to update. */
+    /** The manufacturer partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The name of the field to update. */
     fieldName: string;
@@ -663,14 +666,14 @@ export type PostV4PartnerByApplicationIdAccountManufacturerAndFieldNameApiArg =
 };
 export type PostV4PartnerByApplicationIdAccountManufacturerAboutApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountManufacturerAboutApiArg = {
-    /** The application ID of the manufacturer. */
+    /** The manufacturer partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The new content for the 'About' section. */
+    /** The new content for the About section. */
     body: string;
 };
 export type PostV4PartnerByApplicationIdAccountResellerAndFieldNameApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerAndFieldNameApiArg = {
-    /** The application ID of the reseller to update. */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The name of the field to update. */
     fieldName: string;
@@ -679,56 +682,56 @@ export type PostV4PartnerByApplicationIdAccountResellerAndFieldNameApiArg = {
 };
 export type PostV4PartnerByApplicationIdAccountResellerBcTaxExemptionNumberApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerBcTaxExemptionNumberApiArg = {
-    /** The application ID of the reseller to update. */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The new value for the field. Must start with PST- */
+    /** The new tax exemption number. Must start with `PST-`. */
     newValue?: string;
 };
 export type PostV4PartnerByApplicationIdAccountResellerShippingProfileApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerShippingProfileApiArg = {
-    /** The application ID of the reseller to update. */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The new value for the field. */
+    /** The shipping profile code (`A`, `B`, `C`, `D`, or `E`). */
     newValue?: string;
 };
 export type PostV4PartnerByApplicationIdAccountResellerPriceProfileApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerPriceProfileApiArg = {
-    /** The application ID of the reseller to update. */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The new value for the field. */
+    /** The price profile code (`1`, `2`, `3`, `4`, or `5`). */
     newValue?: string;
 };
 export type PostV4PartnerByApplicationIdAccountResellerCreditLimitApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerCreditLimitApiArg = {
-    /** The application ID of the reseller to update. */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The new credit limit value. */
     newValue?: number;
 };
 export type PostV4PartnerByApplicationIdAccountResellerPriorityApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerPriorityApiArg = {
-    /** The application ID of the reseller to update. */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The new priority value. */
     newValue?: string;
 };
 export type PostV4PartnerByApplicationIdAccountResellerTierApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerTierApiArg = {
-    /** The application ID of the reseller to update. */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The new tier value. */
+    /** The new tier value (`Starter`, `E-Commerce`, `Commercial`, or `Exclusive`). */
     newValue?: string;
 };
 export type PostV4PartnerByApplicationIdAccountResellerTermsApiResponse = unknown;
 export type PostV4PartnerByApplicationIdAccountResellerTermsApiArg = {
-    /** The application ID of the reseller to update. */
+    /** The reseller partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The new tier value between "Commercial", "E-Commerce" and "Exclusive". */
+    /** The terms-related tier: `Commercial`, `E-Commerce`, or `Exclusive`. */
     newValue?: string;
 };
 export type PutV4PartnerByApplicationIdAccountSocialAndSocialNetworkApiResponse = unknown;
 export type PutV4PartnerByApplicationIdAccountSocialAndSocialNetworkApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The name of the social network (e.g., "Facebook", "Twitter"). */
     socialNetwork: string;
@@ -737,7 +740,7 @@ export type PutV4PartnerByApplicationIdAccountSocialAndSocialNetworkApiArg = {
 };
 export type DeleteV4PartnerByApplicationIdAccountSocialAndSocialNetworkApiResponse = unknown;
 export type DeleteV4PartnerByApplicationIdAccountSocialAndSocialNetworkApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The name of the social network to remove. */
     socialNetwork: string;
@@ -745,7 +748,7 @@ export type DeleteV4PartnerByApplicationIdAccountSocialAndSocialNetworkApiArg =
 export type GetV4ManufacturerByRouteManufacturerIdAccountApiResponse = 
 /** status 200 The manufacturer's account information. */ Manufacturer;
 export type GetV4ManufacturerByRouteManufacturerIdAccountApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** If true, includes detailed specifications in the response. Defaults to true. */
     withSpecification?: boolean;
@@ -765,13 +768,13 @@ export type GetV4PartnerByRouteApplicationIdAdsPlatformsStatusApiArg = {
 export type GetV4AgencyByRouteAgencyIdApiResponse = 
 /** status 200 Returns the current agency information. */ AgencyInfo;
 export type GetV4AgencyByRouteAgencyIdApiArg = {
-    /** The application ID of the agency making the request. */
+    /** The target agency application ID. Not HQ IDs such as `2` or `FGDCT3037`. Resolve names via `GET V4/Intranet/Search/Partners`. */
     routeAgencyId: string;
 };
 export type PostV4AgencyByRouteAgencyIdResellerSalesEmailApiResponse = 
 /** status 200 Returns the result of the email delivery request. */ boolean;
 export type PostV4AgencyByRouteAgencyIdResellerSalesEmailApiArg = {
-    /** The application ID of the agency making the request. */
+    /** 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. */
     emailAddress?: string;
@@ -782,7 +785,7 @@ export type PostV4AgencyByRouteAgencyIdResellerSalesEmailApiArg = {
 };
 export type PostV4AgencyByRouteAgencyIdResellerSalesFileApiResponse = unknown;
 export type PostV4AgencyByRouteAgencyIdResellerSalesFileApiArg = {
-    /** The application ID of the agency making the request. */
+    /** 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. */
     startDate?: string;
@@ -802,7 +805,7 @@ export type PostV4PartnerByApplicationIdAttachmentUploadApiArg = {
 export type PostV4PartnerByApplicationIdAttachmentCreateApiResponse = 
 /** status 200 The durable attachment UUID for the created text attachment. */ string;
 export type PostV4PartnerByApplicationIdAttachmentCreateApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The file name and text content to store. */
     randmarApiControllersV4PartnerAttachmentControllerCreateTextAttachmentInput: RandmarApiControllersV4PartnerAttachmentControllerCreateTextAttachmentInput;
@@ -818,7 +821,7 @@ export type PutV4PartnerByApplicationIdAttachmentRegisterApiArg = {
 export type GetV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiResponse = 
 /** status 200 The file stream. */ Blob;
 export type GetV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The durable attachment UUID returned by a registration endpoint. */
     attachmentUuid: string;
@@ -826,7 +829,7 @@ export type GetV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiArg = {
 export type PutV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiResponse = 
 /** status 200 The new attachment UUID. */ string;
 export type PutV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The current attachment UUID to replace. */
     attachmentUuid: string;
@@ -835,7 +838,7 @@ export type PutV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiArg = {
 };
 export type DeleteV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiResponse = unknown;
 export type DeleteV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The durable attachment UUID returned by a registration endpoint. */
     attachmentUuid: string;
@@ -843,56 +846,59 @@ export type DeleteV4PartnerByApplicationIdAttachmentAndAttachmentUuidApiArg = {
 export type GetV4PartnerByApplicationIdAttachmentsApiResponse = 
 /** status 200 Registered partner-level attachments uploaded by the partner. */ AttachmentHeader[];
 export type GetV4PartnerByApplicationIdAttachmentsApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
 };
 export type GetV4ResellerByRouteResellerIdBillingApiResponse = 
 /** status 200 A summary of billing information for the reseller. */ BillingSummary;
 export type GetV4ResellerByRouteResellerIdBillingApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdBillingInvoicesApiResponse = 
 /** status 200 A list of all invoices for the reseller. */ Invoice[];
 export type GetV4ResellerByRouteResellerIdBillingInvoicesApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdBillingPaymentsApiResponse = 
 /** status 200 A list of all payments made by the reseller. */ Payment[];
 export type GetV4ResellerByRouteResellerIdBillingPaymentsApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdBillingCreditsApiResponse = 
 /** status 200 A list of all credit memos issued to the reseller. */ Credit;
 export type GetV4ResellerByRouteResellerIdBillingCreditsApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdBillingLastPaymentApiResponse = 
 /** status 200 Details of the most recent payment made by the reseller. */ Payment;
 export type GetV4ResellerByRouteResellerIdBillingLastPaymentApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdBillingStatementDetailsApiResponse = 
 /** status 200 The detailed statement for the reseller. */ StatementDetail[];
 export type GetV4ResellerByRouteResellerIdBillingStatementDetailsApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentCommunityMembersApiResponse = 
-/** status 200 OK */ Partner[];
+/** status 200 A list of community partner profiles. */ Partner[];
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentCommunityMembersApiArg = {
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
+    /** Optional community application ID to filter members. Empty uses the default community. */
     communityApplicationId?: string;
+    /** When true, includes detailed partner specification data (default: false). */
     withSpecification?: boolean;
 };
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPartnerRandmarApiResponse = 
 /** status 200 The conversation header for the conversation with Randmar. */ ConversationHeader;
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPartnerRandmarApiArg = {
-    /** The application ID of the partner initiating the conversation. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The message content sent to Randmar (created as the first message for a new conversation, or appended to an existing one). */
     message?: string;
@@ -900,7 +906,7 @@ export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPart
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPartner2ApiResponse = 
 /** status 200 The conversation header for the conversation with Randmar. */ ConversationHeader;
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPartner2ApiArg = {
-    /** The application ID of the partner initiating the conversation. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The message content sent to Randmar (created as the first message for a new conversation, or appended to an existing one). */
     message?: string;
@@ -908,7 +914,7 @@ export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPart
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPartnerAndPartnerIdApiResponse = 
 /** status 200 The conversation header details. */ ConversationHeader;
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPartnerAndPartnerIdApiArg = {
-    /** The application ID of the partner initiating the conversation. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The partner (application) ID to converse with. */
     partnerId: string;
@@ -918,13 +924,13 @@ export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationPart
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationsApiResponse = 
 /** status 200 A list of conversation headers. */ ConversationHeader[];
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationsApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdMessagesApiResponse = 
 /** status 200 A list of messages in the conversation. */ ChatMessage[];
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdMessagesApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The conversation ID. */
     conversationId: number;
@@ -932,7 +938,7 @@ export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndCo
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdLinksApiResponse = 
 /** status 200 A list of links shared in the conversation. */ ConversationLink[];
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdLinksApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The conversation ID. */
     conversationId: number;
@@ -940,21 +946,21 @@ export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndCo
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdPeopleApiResponse = 
 /** status 200 A list of conversation participants. */ ConversationLink[];
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdPeopleApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The conversation ID. */
     conversationId: number;
 };
 export type DeleteV4PartnerByRouteApplicationIdBusinessDevelopmentConversationLinkAndLinkIdApiResponse = unknown;
 export type DeleteV4PartnerByRouteApplicationIdBusinessDevelopmentConversationLinkAndLinkIdApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The link ID to remove. */
     linkId: string;
 };
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdLinkApiResponse = unknown;
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdLinkApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The conversation ID. */
     conversationId: number;
@@ -964,7 +970,7 @@ export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndC
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationsHasUnreadsApiResponse = 
 /** status 200 A response indicating whether there are any unread messages. */ GetMessagesResponse;
 export type GetV4PartnerByRouteApplicationIdBusinessDevelopmentConversationsHasUnreadsApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndConversationIdReadApiResponse = unknown;
@@ -977,28 +983,28 @@ export type PostV4PartnerByRouteApplicationIdBusinessDevelopmentConversationAndC
 export type GetV4ResellerByRouteResellerIdCartAndCartNameApiResponse = 
 /** status 200 The complete cart information with all items and pricing details. */ Cart;
 export type GetV4ResellerByRouteResellerIdCartAndCartNameApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The name of the cart to retrieve. */
     cartName: string;
 };
 export type DeleteV4ResellerByRouteResellerIdCartAndCartNameApiResponse = unknown;
 export type DeleteV4ResellerByRouteResellerIdCartAndCartNameApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The name of the cart to delete. */
     cartName: string;
 };
 export type PostV4ResellerByRouteResellerIdCartGenerateAndPostalCodeApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdCartGenerateAndPostalCodeApiArg = {
-    /** The application ID of the Reseller for whom the cart is being generated. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The postal code used to determine product recommendations. */
     postalCode: string;
 };
 export type PostV4ResellerByRouteResellerIdCartAddItemAndCartNameRandmarSkuApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdCartAddItemAndCartNameRandmarSkuApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The name of the cart to modify. */
     cartName: string;
@@ -1011,7 +1017,7 @@ export type PostV4ResellerByRouteResellerIdCartAddItemAndCartNameRandmarSkuApiAr
 };
 export type PostV4ResellerByRouteResellerIdCartAddItemAndCartNameRandmarSkuDefaultOpportunityApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdCartAddItemAndCartNameRandmarSkuDefaultOpportunityApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The name of the cart to add the item to. */
     cartName: string;
@@ -1023,7 +1029,7 @@ export type PostV4ResellerByRouteResellerIdCartAddItemAndCartNameRandmarSkuDefau
 export type PostV4ResellerByRouteResellerIdCartShippingMethodsAndCartNameApiResponse = 
 /** status 200 Returns the delivery options and their costs. */ ShippingMethodApiResponse;
 export type PostV4ResellerByRouteResellerIdCartShippingMethodsAndCartNameApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The name of the cart to price for delivery. */
     cartName: string;
@@ -1043,7 +1049,7 @@ export type PostV4ResellerByRouteResellerIdCartProcessAndCartNameApiArg = {
 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;
 export type PostV4ResellerByRouteResellerIdCartProcessNewAndCartNameApiArg = {
-    /** The application ID of the user/reseller. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The name of the cart to process. */
     cartName: string;
@@ -1053,55 +1059,55 @@ export type PostV4ResellerByRouteResellerIdCartProcessNewAndCartNameApiArg = {
 export type GetV4ResellerByRouteResellerIdCartsApiResponse = 
 /** status 200 A list of all open shopping carts for the reseller. */ Cart[];
 export type GetV4ResellerByRouteResellerIdCartsApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type DeleteV4ResellerByRouteResellerIdCartsApiResponse = unknown;
 export type DeleteV4ResellerByRouteResellerIdCartsApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdCategoriesApiResponse = 
 /** status 200 A list of manufacturer categories. */ ManufacturerCategory[];
 export type GetV4ManufacturerByRouteManufacturerIdCategoriesApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdCategoriesNichesApiResponse = 
 /** status 200 A list of product niches. */ ProductNiche[];
 export type GetV4ManufacturerByRouteManufacturerIdCategoriesNichesApiArg = {
-    /** The application ID of the Manufacturer making the request. Used for authorization. */
+    /** The target manufacturer's application ID (authorization only). Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiResponse = 
 /** status 200 The requested category's information. */ ManufacturerCategory;
 export type GetV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The code of the category to retrieve. */
+    /** The category code. Resolve from `GET .../Categories` if the user gave a name. */
     categoryCode: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The code for the new category. */
+    /** The code for the new category (unique for this manufacturer). */
     categoryCode: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The code of the category to delete. */
+    /** The category code to delete. Resolve from `GET .../Categories`. */
     categoryCode: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeFieldNameApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeFieldNameApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The code of the category to update. */
+    /** The category code to update. Resolve from `GET .../Categories`. */
     categoryCode: string;
-    /** The name of the field to update ("WeeksOfStocking", "CategoryName", "Starred", "AutoReorder", "QualificationRequired" or "Niche"). */
+    /** 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. */
     newValue?: string;
@@ -1153,16 +1159,16 @@ export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeCostGp
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeResetApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeResetApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The code of the category to reset. */
+    /** The category code to reset. Resolve from `GET .../Categories`. */
     categoryCode: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeStarredApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeStarredApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The code of the category to star or un-star. */
+    /** The category code to star or un-star. */
     categoryCode: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdCategoryAndCategoryCodeImageApiResponse = unknown;
@@ -1189,7 +1195,7 @@ export type PostV4UserByFieldNameApiArg = {
 export type GetV4ResellerByRouteResellerIdCustomerApiResponse = 
 /** status 200 The customer's information. */ CustomerDetails;
 export type GetV4ResellerByRouteResellerIdCustomerApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The name of the customer to retrieve. */
     customerName?: string;
@@ -1197,9 +1203,9 @@ export type GetV4ResellerByRouteResellerIdCustomerApiArg = {
 export type GetV4ResellerByRouteResellerIdDocumentAndDocumentNumberApiResponse = 
 /** status 200 The requested document details with complete information including header data, line items, and charges if applicable. */ OrderDocument;
 export type GetV4ResellerByRouteResellerIdDocumentAndDocumentNumberApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
-    /** The number of the desired document (e.g., OW01046633, IN12345, etc.) or "STATEMENT" for statement documents. */
+    /** The document number (e.g., OW01046633, IN12345) or "STATEMENT" for statement documents. */
     documentNumber: string;
 };
 export type GetV4ResellerByRouteResellerIdDocumentFormalNoticeApiResponse = unknown;
@@ -1224,7 +1230,7 @@ export type GetV4ResellerByRouteResellerIdDocumentAndDocumentNumberPdfApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdDocumentAndDocumentNumberEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdDocumentAndDocumentNumberEmailApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The number of the document to send. */
     documentNumber: string;
@@ -1235,7 +1241,7 @@ export type PostV4ResellerByRouteResellerIdDocumentAndDocumentNumberEmailApiArg
 };
 export type PostV4ResellerByRouteResellerIdDocumentStatementEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdDocumentStatementEmailApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
@@ -1244,7 +1250,7 @@ export type PostV4ResellerByRouteResellerIdDocumentStatementEmailApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdDocumentAndDocumentNumberEdiApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdDocumentAndDocumentNumberEdiApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The invoice number to be sent. */
     documentNumber: string;
@@ -1283,9 +1289,9 @@ export type GetV4PartnerByApplicationIdDocumentAndDocumentNumberPdfApiArg = {
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The unique number of the document to retrieve. */
+    /** The document number (typically starts with PO, RCP, or RQN). Resolve from Documents lists if unknown. */
     documentNumber: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberPdfApiResponse = unknown;
@@ -1297,28 +1303,28 @@ export type GetV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberPdfAp
 };
 export type PostV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdDocumentAndDocumentNumberEmailApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The unique number of the document to send. */
+    /** The document number to send (PO, RCP, or RQN). */
     documentNumber: string;
-    /** The recipient's email address. */
+    /** The recipient email address. Confirm with the user; do not guess. */
     emailAddress?: string;
-    /** An optional comment to include in the email body. */
+    /** Optional comment included in the email body. */
     comment?: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdDocumentSalesOrderAndOrderNumberExecuteApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdDocumentSalesOrderAndOrderNumberExecuteApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The number of the sales order to execute. */
+    /** 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 application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The number of the sales order to retrieve. */
+    /** The sales order number. Resolve from ActiveOrderDetails or CompletedOrderDetails if unknown. */
     orderNumber: string;
     /** Whether to include detailed product specifications in the response. */
     withSpecification?: boolean;
@@ -1326,85 +1332,85 @@ export type GetV4ManufacturerByRouteManufacturerIdDocumentSalesOrderAndOrderNumb
 export type GetV4ResellerByRouteResellerIdDocumentsActiveOrderDetailsApiResponse = 
 /** status 200 A list of active order details for the reseller. */ OrderDetail[];
 export type GetV4ResellerByRouteResellerIdDocumentsActiveOrderDetailsApiArg = {
-    /** The reseller ID for which to retrieve order details. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdDocumentsGeneralDocumentsApiResponse = 
 /** status 200 An array of general documents for the reseller. */ GeneralDocumentOld[];
 export type GetV4ResellerByRouteResellerIdDocumentsGeneralDocumentsApiArg = {
-    /** The reseller ID for which to retrieve documents. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsRequisitionsApiResponse = 
 /** status 200 A list of requisitions. */ Requisition[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsRequisitionsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentRequisitionsApiResponse = 
 /** status 200 A list of requisitions. */ Requisition[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentRequisitionsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsPurchaseOrdersApiResponse = 
 /** status 200 A list of purchase orders. */ PurchaseOrder[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsPurchaseOrdersApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentPurchaseOrdersApiResponse = 
 /** status 200 A list of purchase orders. */ PurchaseOrder[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentPurchaseOrdersApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsReceiptsApiResponse = 
 /** status 200 A list of receipts. */ Receipt[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsReceiptsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentReceiptsApiResponse = 
 /** status 200 A list of receipts. */ Receipt[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentReceiptsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsInvoicesApiResponse = 
 /** status 200 A list of invoices. */ VendorDocument[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsInvoicesApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentInvoicesApiResponse = 
 /** status 200 A list of invoices. */ VendorDocument[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentInvoicesApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsActiveOrderDetailsApiResponse = 
 /** status 200 A list of active order details. */ OrderDetail[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsActiveOrderDetailsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentActiveOrderDetailsApiResponse = 
 /** status 200 A list of active order details. */ OrderDetail[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentActiveOrderDetailsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsCompletedOrderDetailsApiResponse = 
 /** status 200 A list of completed order details. */ OrderDetail[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentsCompletedOrderDetailsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdDocumentCompletedOrderDetailsApiResponse = 
 /** status 200 A list of completed order details. */ OrderDetail[];
 export type GetV4ManufacturerByRouteManufacturerIdDocumentCompletedOrderDetailsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdDraftPurchasesApiResponse = unknown;
@@ -1430,23 +1436,26 @@ export type PutV4PartnerEmailByNotificationTypeApiArg = {
 export type GetV4PartnerByApplicationIdGeneralDocumentAndGeneralDocumentNumberApiResponse = 
 /** status 200 The requested order's information. */ GeneralDocument;
 export type GetV4PartnerByApplicationIdGeneralDocumentAndGeneralDocumentNumberApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
-    /** The order number to retrieve. */
+    /** The order/document number to retrieve. */
     generalDocumentNumber: string;
-    /** Whether to include detailed product specifications in the response. Defaults to true. */
+    /** Whether to include detailed product specifications in the response. Defaults to false. */
     withSpecification?: boolean;
 };
 export type PostV4PartnerByApplicationIdGeneralDocumentAndGeneralDocumentNumberShippingAddressApiResponse = unknown;
 export type PostV4PartnerByApplicationIdGeneralDocumentAndGeneralDocumentNumberShippingAddressApiArg = {
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
+    /** The order/document number whose ship-to address will change. */
     generalDocumentNumber: string;
+    /** The replacement shipping address. */
     shippingAddress: ShippingAddress;
 };
 export type GetV4PartnerByRouteApplicationIdGeneralDocumentsApiResponse = 
 /** status 200 An array of general documents for the reseller. */ RandmarApiControllersV4PartnerGeneralDocumentRead[];
 export type GetV4PartnerByRouteApplicationIdGeneralDocumentsApiArg = {
-    /** The reseller ID for which to retrieve documents. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type PostV4PartnerByApplicationIdGenerationTextApiResponse = 
@@ -1458,7 +1467,7 @@ export type PostV4PartnerByApplicationIdGenerationTextApiArg = {
 export type PostV4PartnerByApplicationIdGenerationGoogleGroundedTextApiResponse = 
 /** status 200 Returns a ContentSubset containing the assistant's reply (usually a Text part) along with the usage percentage of the context. */ GenerationResult;
 export type PostV4PartnerByApplicationIdGenerationGoogleGroundedTextApiArg = {
-    /** The ID of the partner making the request */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** The conversation parts; typically a single User content with a single Text part. */
     generateGoogleGroundedTextBody: GenerateGoogleGroundedTextBody;
@@ -1472,7 +1481,7 @@ export type PostV4PartnerByApplicationIdGenerationJsonApiArg = {
 export type PostV4PartnerByApplicationIdGenerationImageApiResponse = 
 /** status 200 Returns the generated images (base64) and the usage percentage of the context. */ ImageGenerationResult;
 export type PostV4PartnerByApplicationIdGenerationImageApiArg = {
-    /** The ID of the partner making the request */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** Prompt and options for image generation. */
     generateImageBody: GenerateImageBody;
@@ -1480,7 +1489,7 @@ export type PostV4PartnerByApplicationIdGenerationImageApiArg = {
 export type PostV4PartnerByApplicationIdGenerationImageUrlApiResponse = 
 /** status 200 Returns short-lived URLs for the generated images and the usage percentage of the context. */ ImageUrlGenerationResult;
 export type PostV4PartnerByApplicationIdGenerationImageUrlApiArg = {
-    /** The ID of the partner making the request */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     applicationId: string;
     /** Prompt and options for image generation. */
     generateImageBody: GenerateImageBody;
@@ -1687,21 +1696,21 @@ export type GetV4PartnerByRouteApplicationIdGoogleAdsBillingSetupsApiArg = {
 export type PutV4PartnerByRouteApplicationIdIntegrationKeyAndKeyNameApiResponse = 
 /** status 200 The newly created integration key password. */ string;
 export type PutV4PartnerByRouteApplicationIdIntegrationKeyAndKeyNameApiArg = {
-    /** The application ID of the partner for whom the key is being created. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** A name for the integration key. */
     keyName: string;
 };
 export type PostV4PartnerByRouteApplicationIdIntegrationKeyAndKeyNameApiResponse = unknown;
 export type PostV4PartnerByRouteApplicationIdIntegrationKeyAndKeyNameApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The name of the integration key to renew. */
     keyName: string;
 };
 export type DeleteV4PartnerByRouteApplicationIdIntegrationKeyAndKeyNameApiResponse = unknown;
 export type DeleteV4PartnerByRouteApplicationIdIntegrationKeyAndKeyNameApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The name of the integration key to delete. */
     keyName: string;
@@ -1709,24 +1718,26 @@ export type DeleteV4PartnerByRouteApplicationIdIntegrationKeyAndKeyNameApiArg =
 export type GetV4PartnerByRouteApplicationIdIntegrationKeysApiResponse = 
 /** status 200 A list of integration keys. */ IntegrationKey[];
 export type GetV4PartnerByRouteApplicationIdIntegrationKeysApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdInventoryValueApiResponse = 
 /** status 200 A list of inventory values. */ InventoryValueEntry[];
 export type GetV4ManufacturerByRouteManufacturerIdInventoryValueApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4PartnerByRouteApplicationIdJobAndJobIdApiResponse = 
 /** status 200 The job details (Types.Job) were returned. */ Job;
 export type GetV4PartnerByRouteApplicationIdJobAndJobIdApiArg = {
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The job identifier. */
     jobId: string;
 };
 export type DeleteV4PartnerByRouteApplicationIdJobAndJobIdApiResponse = unknown;
 export type DeleteV4PartnerByRouteApplicationIdJobAndJobIdApiArg = {
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The job identifier. */
     jobId: string;
@@ -1735,6 +1746,7 @@ export type DeleteV4PartnerByRouteApplicationIdJobAndJobIdApiArg = {
 };
 export type PostV4PartnerByRouteApplicationIdJobAndJobIdRestartApiResponse = unknown;
 export type PostV4PartnerByRouteApplicationIdJobAndJobIdRestartApiArg = {
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The job identifier. */
     jobId: string;
@@ -1742,12 +1754,12 @@ export type PostV4PartnerByRouteApplicationIdJobAndJobIdRestartApiArg = {
 export type GetV4PartnerByRouteApplicationIdJobsApiResponse = 
 /** status 200 A list of jobs. */ Job[];
 export type GetV4PartnerByRouteApplicationIdJobsApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type GetV4PartnerByRouteApplicationIdJobsCompletedOrCancelApiResponse = unknown;
 export type GetV4PartnerByRouteApplicationIdJobsCompletedOrCancelApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The maximum number of jobs to return (defaults to 100). */
     max?: number;
@@ -1755,7 +1767,7 @@ export type GetV4PartnerByRouteApplicationIdJobsCompletedOrCancelApiArg = {
 export type PutV4PartnerByRouteApplicationIdJobsAssistantTaskApiResponse = 
 /** status 200 The assistant task was queued successfully. */ boolean;
 export type PutV4PartnerByRouteApplicationIdJobsAssistantTaskApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** Assistant task request including prompt, optional public file URLs, and optional SOP IDs. */
     createPartnerAssistantJobInput: CreatePartnerAssistantJobInput;
@@ -1763,7 +1775,7 @@ export type PutV4PartnerByRouteApplicationIdJobsAssistantTaskApiArg = {
 export type PutV4PartnerByRouteApplicationIdJobsAssistantTaskAndJobIdScheduledTimeApiResponse = 
 /** status 200 The scheduled time was changed successfully. */ boolean;
 export type PutV4PartnerByRouteApplicationIdJobsAssistantTaskAndJobIdScheduledTimeApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The assistant task job ID. */
     jobId: string;
@@ -1772,7 +1784,7 @@ export type PutV4PartnerByRouteApplicationIdJobsAssistantTaskAndJobIdScheduledTi
 };
 export type GetV4PartnerByRouteApplicationIdLogsApiResponse = unknown;
 export type GetV4PartnerByRouteApplicationIdLogsApiArg = {
-    /** The application ID of the partner */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** Only the logs on or after this date will be returned. MUST be in a valid date format like YYYY-MM-DD. */
     startDate?: string;
@@ -1780,7 +1792,7 @@ export type GetV4PartnerByRouteApplicationIdLogsApiArg = {
 export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdApiResponse = 
 /** status 200 Manufacturer details. */ Manufacturer;
 export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdApiArg = {
-    /** Reseller identifier in the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Manufacturer identifier to retrieve. */
     manufacturerId: string;
@@ -1790,7 +1802,7 @@ export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdApiArg =
 export type PutV4ResellerByRouteResellerIdManufacturerAndManufacturerIdApiResponse = 
 /** status 200 Boolean indicating whether the qualification request was accepted/processed. */ boolean;
 export type PutV4ResellerByRouteResellerIdManufacturerAndManufacturerIdApiArg = {
-    /** Reseller identifier in the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Manufacturer identifier to qualify with. */
     manufacturerId: string;
@@ -1800,14 +1812,14 @@ export type PutV4ResellerByRouteResellerIdManufacturerAndManufacturerIdApiArg =
 export type DeleteV4ResellerByRouteResellerIdManufacturerAndManufacturerIdApiResponse = 
 /** status 200 Updated manufacturer object as returned by the underlying service. */ Manufacturer;
 export type DeleteV4ResellerByRouteResellerIdManufacturerAndManufacturerIdApiArg = {
-    /** Reseller identifier in the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Manufacturer identifier whose qualification should be removed. */
     manufacturerId: string;
 };
 export type PostV4ResellerByRouteResellerIdManufacturerAndManufacturerIdShopifyApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdManufacturerAndManufacturerIdShopifyApiArg = {
-    /** Reseller identifier in the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Manufacturer identifier to synchronize. */
     manufacturerId: string;
@@ -1817,7 +1829,7 @@ export type PostV4ResellerByRouteResellerIdManufacturerAndManufacturerIdShopifyA
 export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdSalesStatisticsApiResponse = 
 /** status 200 Sales statistics rows. */ SalesStatistic[];
 export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdSalesStatisticsApiArg = {
-    /** Reseller identifier in the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Manufacturer identifier. */
     manufacturerId: string;
@@ -1827,9 +1839,9 @@ export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdSalesStat
     endDate?: string;
 };
 export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdCategoryCodeApiResponse = 
-/** status 200 OK */ ManufacturerCategory;
+/** status 200 Manufacturer category details. */ ManufacturerCategory;
 export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdCategoryCodeApiArg = {
-    /** Reseller identifier in the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Manufacturer identifier. */
     manufacturerId: string;
@@ -1838,7 +1850,7 @@ export type GetV4ResellerByRouteResellerIdManufacturerAndManufacturerIdCategoryC
 };
 export type PostV4ResellerByRouteResellerIdManufacturerAndManufacturerIdCategoryCodeShopifyApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdManufacturerAndManufacturerIdCategoryCodeShopifyApiArg = {
-    /** Reseller identifier in the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Manufacturer identifier. */
     manufacturerId: string;
@@ -1850,7 +1862,7 @@ export type PostV4ResellerByRouteResellerIdManufacturerAndManufacturerIdCategory
 export type GetV4PartnerByRouteApplicationIdManufacturerAndManufacturerIdCategoryCodeApiResponse = 
 /** status 200 The requested manufacturer category details. */ ManufacturerCategory;
 export type GetV4PartnerByRouteApplicationIdManufacturerAndManufacturerIdCategoryCodeApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The ID of the manufacturer. */
     manufacturerId: string;
@@ -1860,7 +1872,7 @@ export type GetV4PartnerByRouteApplicationIdManufacturerAndManufacturerIdCategor
 export type GetV4ResellerByRouteResellerIdManufacturersApiResponse = 
 /** status 200 A list of manufacturers. */ Manufacturer[];
 export type GetV4ResellerByRouteResellerIdManufacturersApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Whether to include detailed specifications for each manufacturer in the response. Defaults to false. */
     withSpecification?: boolean;
@@ -1868,7 +1880,7 @@ export type GetV4ResellerByRouteResellerIdManufacturersApiArg = {
 export type GetV4PartnerByRouteApplicationIdManufacturersApiResponse = 
 /** status 200 Returns the manufacturer list */ Manufacturer[];
 export type GetV4PartnerByRouteApplicationIdManufacturersApiArg = {
-    /** The application ID of the partner */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** Whether to include detailed specification information (default: false) */
     withSpecification?: boolean;
@@ -1876,7 +1888,7 @@ export type GetV4PartnerByRouteApplicationIdManufacturersApiArg = {
 export type GetV4AgencyByRouteAgencyIdManufacturersApiResponse = 
 /** status 200 A list of manufacturers. */ Manufacturer[];
 export type GetV4AgencyByRouteAgencyIdManufacturersApiArg = {
-    /** The unique identifier for the agency making the request. */
+    /** 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. */
     withSpecification?: boolean;
@@ -1884,12 +1896,12 @@ export type GetV4AgencyByRouteAgencyIdManufacturersApiArg = {
 export type GetV4AgencyByRouteAgencyIdManufacturersOpenOrdersApiResponse = 
 /** status 200 A list of open order details. */ OrderDetail[];
 export type GetV4AgencyByRouteAgencyIdManufacturersOpenOrdersApiArg = {
-    /** The unique identifier for the agency making the request. */
+    /** The target agency application ID. Not HQ IDs such as `2` or `FGDCT3037`. Resolve names via `GET V4/Intranet/Search/Partners`. */
     routeAgencyId: string;
 };
 export type GetV4ResellerByRouteResellerIdMediaAndDocumentNumberSubfolderApiResponse = unknown;
 export type GetV4ResellerByRouteResellerIdMediaAndDocumentNumberSubfolderApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The document number or identifier for the media. */
     documentNumber: string;
@@ -1899,19 +1911,19 @@ export type GetV4ResellerByRouteResellerIdMediaAndDocumentNumberSubfolderApiArg
 export type GetV4PartnerByRouteApplicationIdMediaShortsApiResponse = 
 /** status 200 A list of dynamic objects, each representing a short video. */ any[];
 export type GetV4PartnerByRouteApplicationIdMediaShortsApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type GetV4PartnerByRouteApplicationIdMediaShortAndFileNameApiResponse = unknown;
 export type GetV4PartnerByRouteApplicationIdMediaShortAndFileNameApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The filename of the short video to download. */
     fileName: string;
 };
 export type PostV4PartnerByRouteApplicationIdMediaShortAndFileNameApiResponse = unknown;
 export type PostV4PartnerByRouteApplicationIdMediaShortAndFileNameApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The current filename of the short video. */
     fileName: string;
@@ -1920,14 +1932,14 @@ export type PostV4PartnerByRouteApplicationIdMediaShortAndFileNameApiArg = {
 };
 export type DeleteV4PartnerByRouteApplicationIdMediaShortAndFileNameApiResponse = unknown;
 export type DeleteV4PartnerByRouteApplicationIdMediaShortAndFileNameApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The filename of the short video to delete. */
     fileName: string;
 };
 export type PutV4PartnerByRouteApplicationIdMediaTextToSpeechApiResponse = unknown;
 export type PutV4PartnerByRouteApplicationIdMediaTextToSpeechApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The text-to-speech request details. */
     textToSpeechModel: TextToSpeechModel;
@@ -1953,7 +1965,7 @@ export type PostV4PartnerByRouteApplicationIdMicrosoftAdsAccountLinksApiArg = {
 export type GetV4ResellerByRouteResellerIdNicheAndNicheNameManufacturersApiResponse = 
 /** status 200 A list of manufacturers within the specified niche. */ Manufacturer[];
 export type GetV4ResellerByRouteResellerIdNicheAndNicheNameManufacturersApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The name of the niche to retrieve manufacturers for. */
     nicheName: string;
@@ -1961,18 +1973,18 @@ export type GetV4ResellerByRouteResellerIdNicheAndNicheNameManufacturersApiArg =
 export type GetV4ResellerByRouteResellerIdOpportunitiesApiResponse = 
 /** status 200 A list of opportunities available to the reseller. */ OpportunityEntry[];
 export type GetV4ResellerByRouteResellerIdOpportunitiesApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdOpportunitiesApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdOpportunitiesApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberApiResponse = 
 /** status 200 The detailed information for the specified opportunity. */ OpportunityEntry;
 export type GetV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The ID of the manufacturer offering the opportunity. */
     manufacturerId: string;
@@ -1983,7 +1995,7 @@ export type GetV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberA
 };
 export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The ID of the manufacturer offering the opportunity. */
     manufacturerId: string;
@@ -1994,7 +2006,7 @@ export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumber
 };
 export type PutV4ResellerByRouteResellerIdOpportunityAndManufacturerIdDefaultApiResponse = unknown;
 export type PutV4ResellerByRouteResellerIdOpportunityAndManufacturerIdDefaultApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The ID of the manufacturer for which to set the default opportunity. */
     manufacturerId: string;
@@ -2003,7 +2015,7 @@ export type PutV4ResellerByRouteResellerIdOpportunityAndManufacturerIdDefaultApi
 };
 export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberFileApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberFileApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The ID of the manufacturer offering the opportunity. */
     manufacturerId: string;
@@ -2012,7 +2024,7 @@ export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumber
 };
 export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberShopifyApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumberShopifyApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The ID of the manufacturer offering the opportunity. */
     manufacturerId: string;
@@ -2023,105 +2035,105 @@ export type PostV4ResellerByRouteResellerIdOpportunityAndManufacturerIdBidNumber
 };
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityApiArg = {
-    /** The ID of the manufacturer for whom the opportunity is being inserted. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The details of the opportunity to create. */
+    /** The opportunity payload (bid number, title, dates, default resellers, quoteOnly). */
     createOpportunityInput: CreateOpportunityInput;
 };
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiArg = {
-    /** The ID of the manufacturer renewing the opportunity. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The bid number of the opportunity to renew. */
+    /** The existing bid number to renew. Resolve from `GET .../Opportunities`. */
     bidNumber: string;
-    /** The details for the new, renewed opportunity. */
+    /** 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 application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The bid number of the opportunity to retrieve. */
+    /** The bid number. Resolve from `GET .../Opportunities` if unknown. */
     bidNumber: string;
-    /** If true, includes detailed specifications in the response. Defaults to true. */
+    /** If true, includes detailed specifications. Defaults to true. */
     withSpecification?: boolean;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberApiArg = {
-    /** The application ID of the requestor. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The BidNumber of the opportunity to delete. */
+    /** The bid number to delete. Resolve from `GET .../Opportunities`. */
     bidNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberFieldNameApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberFieldNameApiArg = {
-    /** The application ID of the requestor. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The BidNumber of the opportunity to edit. */
+    /** The bid number to edit. Resolve from `GET .../Opportunities`. */
     bidNumber: string;
-    /** The name of the opportunity field to edit. Case-sensitive, so use the field name as seen in the JSON received from API. */
+    /** The opportunity field to edit. Case-sensitive; use the name from the opportunity JSON. */
     fieldName: string;
     /** The new value for the field. */
     newValue?: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdApiArg = {
-    /** The application ID of the requestor. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The BidNumber of the opportunity to edit. */
+    /** The bid number to edit. */
     bidNumber: string;
-    /** The reseller ID of the reseller to add to the opportunity. */
+    /** The reseller application ID to add. Resolve from the Resellers list. */
     resellerId: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdApiArg = {
-    /** The application ID of the requestor. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The BidNumber of the opportunity to edit. */
+    /** The bid number to edit. */
     bidNumber: string;
-    /** The reseller ID of the reseller to add to the opportunity. */
+    /** The reseller application ID to remove from the bid. */
     resellerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberResellerResellerIdEmailApiArg = {
-    /** The application ID of the Manufacturer. Used for authorization. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The bid number of the opportunity to send. */
+    /** The bid number to send. */
     bidNumber: string;
-    /** The ID of the reseller sending the email. */
+    /** The reseller application ID on whose behalf the email is sent. */
     resellerId: string;
-    /** The recipient's email address. */
+    /** The recipient email address. Confirm with the user; do not guess. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberPartNumberRandmarSkuApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberPartNumberRandmarSkuApiArg = {
-    /** The application ID of the requestor. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The BidNumber of the opportunity to edit. */
+    /** The bid number to edit. */
     bidNumber: string;
-    /** The RandmarSKU of the part number given by the user. From the part number given by the user, the API will get the RandmarSKU from the database. */
+    /** 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). */
     bidPrice?: number;
-    /** The type of the bid amount. Defaults to "ItemRebate". */
+    /** The bid amount type. Defaults to "ItemRebate". */
     bidPriceType?: string;
-    /** Indicates if the bid is a Randmar discount. Requires super admin authorization. */
+    /** If true, marks the bid as a Randmar discount. Requires super-admin authorization. */
     randmarDiscount?: boolean;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberPartNumberRandmarSkuApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdOpportunityAndBidNumberPartNumberRandmarSkuApiArg = {
-    /** The application ID of the requestor. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The BidNumber of the opportunity to edit. */
+    /** The bid number to edit. */
     bidNumber: string;
-    /** The RandmarSKU of the part number given by the user. From the part number given by the user, the API will get the RandmarSKU from the database. */
+    /** The Randmar SKU to remove. Resolve from product GET if the user gave an MPN/UPC. */
     randmarSku: string;
 };
 export type GetV4ResellerByRouteResellerIdOrderAndOrderNumberApiResponse = 
 /** status 200 The requested order's information. */ GeneralDocumentOld;
 export type GetV4ResellerByRouteResellerIdOrderAndOrderNumberApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to retrieve. */
     orderNumber: string;
@@ -2130,7 +2142,7 @@ export type GetV4ResellerByRouteResellerIdOrderAndOrderNumberApiArg = {
 };
 export type PutV4ResellerByRouteResellerIdOrderAndOrderNumberCommentApiResponse = unknown;
 export type PutV4ResellerByRouteResellerIdOrderAndOrderNumberCommentApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to add the comment to. */
     orderNumber: string;
@@ -2139,7 +2151,7 @@ export type PutV4ResellerByRouteResellerIdOrderAndOrderNumberCommentApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdOrderAndDocumentNumberShippingSlipApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndDocumentNumberShippingSlipApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to attach the shipping slip to. */
     documentNumber: string;
@@ -2151,14 +2163,14 @@ export type PostV4ResellerByRouteResellerIdOrderAndDocumentNumberShippingSlipApi
 export type GetV4ResellerByRouteResellerIdOrderPoNumberAndResellerPoNumberApiResponse = 
 /** status 200 The requested order's information. */ GeneralDocumentOld;
 export type GetV4ResellerByRouteResellerIdOrderPoNumberAndResellerPoNumberApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The reseller's PO number. */
     resellerPoNumber: string;
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to send. */
     orderNumber: string;
@@ -2174,7 +2186,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndDocumentNumberLuggaBeastApiAr
 };
 export type DeleteV4ResellerByRouteResellerIdOrderAndOrderNumberCancelApiResponse = unknown;
 export type DeleteV4ResellerByRouteResellerIdOrderAndOrderNumberCancelApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to cancel. */
     orderNumber: string;
@@ -2183,7 +2195,7 @@ export type DeleteV4ResellerByRouteResellerIdOrderAndOrderNumberCancelApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberChangeLocationApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberChangeLocationApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2192,7 +2204,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberChangeLocationApiA
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberOnHoldApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberOnHoldApiArg = {
-    /** The application ID of the Reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number of which to change the On Hold status. */
     orderNumber: string;
@@ -2201,7 +2213,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberOnHoldApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberShipViaChangeApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberShipViaChangeApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2210,7 +2222,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberShipViaChangeApiAr
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberChangeShipViaApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberChangeShipViaApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2220,14 +2232,14 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberChangeShipViaApiAr
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberShipViaEstimateApiResponse = 
 /** status 200 A list of shipping methods and their estimated costs. */ ShipViaEstimate[];
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberShipViaEstimateApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to estimate shipping for. */
     orderNumber: string;
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditInformationApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditInformationApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to edit. */
     orderNumber: string;
@@ -2254,7 +2266,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditInformationApi
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditItemRandmarSkuApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditItemRandmarSkuApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number containing the item to edit. */
     orderNumber: string;
@@ -2267,7 +2279,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditItemRandmarSku
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberOrderDateApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberOrderDateApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to edit. */
     orderNumber: string;
@@ -2276,7 +2288,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberOrderDateApiArg =
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberShippingDateApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberShippingDateApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2285,7 +2297,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberShippingDateApiArg
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberExpeditionLineApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberExpeditionLineApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2294,7 +2306,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberExpeditionLineApiA
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberPoNumberApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberPoNumberApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2303,7 +2315,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberPoNumberApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEndUserPoNumberApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEndUserPoNumberApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2312,14 +2324,14 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEndUserPoNumberApi
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberTodayApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberTodayApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to release. */
     orderNumber: string;
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditChargeMiscellaneousChargeApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditChargeMiscellaneousChargeApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2330,7 +2342,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditChargeMiscella
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditMiscellaneousChargeMiscellaneousChargeApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditMiscellaneousChargeMiscellaneousChargeApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2341,7 +2353,7 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberEditMiscellaneousC
 };
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberTermsTermsCodeApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberTermsTermsCodeApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The order number to modify. */
     orderNumber: string;
@@ -2351,19 +2363,19 @@ export type PostV4ResellerByRouteResellerIdOrderAndOrderNumberTermsTermsCodeApiA
 export type GetV4ResellerByRouteResellerIdOrdersApiResponse = 
 /** status 200 A list of orders. */ Order[];
 export type GetV4ResellerByRouteResellerIdOrdersApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdOrdersShipmentsApiResponse = 
 /** status 200 A list of shipments. */ Shipment[];
 export type GetV4ResellerByRouteResellerIdOrdersShipmentsApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4PartnerByRouteApplicationIdPartnerAndPartnerIdApiResponse = 
 /** status 200 The requested partner's information. */ Partner;
 export type GetV4PartnerByRouteApplicationIdPartnerAndPartnerIdApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID of the caller. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The application ID of the partner to retrieve. */
     partnerId: string;
@@ -2386,7 +2398,7 @@ export type GetV4ShopifyByShopifyHostNameProductAndRandmarSkuApiArg = {
 export type GetV4ResellerByRouteResellerIdProductAndRandmarSkuApiResponse = 
 /** status 200 The product information. */ Product;
 export type GetV4ResellerByRouteResellerIdProductAndRandmarSkuApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The Randmar SKU of the product to retrieve. */
     randmarSku: string;
@@ -2398,7 +2410,7 @@ export type GetV4ResellerByRouteResellerIdProductAndRandmarSkuApiArg = {
 export type GetV4ResellerByRouteResellerIdProductAndRandmarSkuSalesStatisticsApiResponse = 
 /** status 200 A list of sales statistics records for the requested period. */ SalesStatistic[];
 export type GetV4ResellerByRouteResellerIdProductAndRandmarSkuSalesStatisticsApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2409,7 +2421,7 @@ export type GetV4ResellerByRouteResellerIdProductAndRandmarSkuSalesStatisticsApi
 };
 export type PostV4ResellerByRouteResellerIdProductAndRandmarSkuShopifyApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdProductAndRandmarSkuShopifyApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The Randmar SKU to synchronize to Shopify. */
     randmarSku: string;
@@ -2420,7 +2432,7 @@ export type PostV4ResellerByRouteResellerIdProductAndRandmarSkuShopifyApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdProductAndRandmarSkuShopifyProductPageWritingApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdProductAndRandmarSkuShopifyProductPageWritingApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The Randmar SKU whose Shopify product page should be written. */
     randmarSku: string;
@@ -2431,7 +2443,7 @@ export type PostV4ResellerByRouteResellerIdProductAndRandmarSkuShopifyProductPag
 };
 export type PutV4ResellerByRouteResellerIdProductAndRandmarSkuRequisitionApiResponse = unknown;
 export type PutV4ResellerByRouteResellerIdProductAndRandmarSkuRequisitionApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The Randmar SKU of the product to request. */
     randmarSku: string;
@@ -2450,7 +2462,7 @@ export type PutV4ResellerByRouteResellerIdProductAndRandmarSkuSerializeApiArg =
 export type GetV4PartnerByRouteApplicationIdProductAndRandmarSkuApiResponse = 
 /** status 200 The product information. */ Product;
 export type GetV4PartnerByRouteApplicationIdProductAndRandmarSkuApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Randmar SKU of the product to retrieve. */
     randmarSku: string;
@@ -2463,7 +2475,7 @@ export type GetV4PartnerByRouteApplicationIdProductAndRandmarSkuApiArg = {
 export type PostV4PartnerByRouteApplicationIdProductAndRandmarSkuGenerateImageApiResponse = 
 /** status 200 A short-lived staging URL for the generated image. */ string;
 export type PostV4PartnerByRouteApplicationIdProductAndRandmarSkuGenerateImageApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Randmar SKU whose primary image is used as the reference. */
     randmarSku: string;
@@ -2475,7 +2487,7 @@ export type PostV4PartnerByRouteApplicationIdProductAndRandmarSkuGenerateImageAp
 export type PostV4PartnerByRouteApplicationIdProductAndRandmarSkuGenerateVideoApiResponse = 
 /** status 200 A short-lived staging URL for the generated video. */ string;
 export type PostV4PartnerByRouteApplicationIdProductAndRandmarSkuGenerateVideoApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Randmar SKU whose primary image is used as the reference. */
     randmarSku: string;
@@ -2484,7 +2496,7 @@ export type PostV4PartnerByRouteApplicationIdProductAndRandmarSkuGenerateVideoAp
 };
 export type GetV4PartnerByRouteApplicationIdProductAndRandmarSkuLocationDetailsWarehouseIdApiResponse = unknown;
 export type GetV4PartnerByRouteApplicationIdProductAndRandmarSkuLocationDetailsWarehouseIdApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2493,7 +2505,7 @@ export type GetV4PartnerByRouteApplicationIdProductAndRandmarSkuLocationDetailsW
 };
 export type PutV4PartnerByRouteApplicationIdProductAndRandmarSkuLocationDetailsWarehouseIdApiResponse = unknown;
 export type PutV4PartnerByRouteApplicationIdProductAndRandmarSkuLocationDetailsWarehouseIdApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2505,7 +2517,7 @@ export type PutV4PartnerByRouteApplicationIdProductAndRandmarSkuLocationDetailsW
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberApiResponse = 
 /** status 200 The requested product's data. */ Product;
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU, MPN, or UPC of the product to retrieve. */
     productNumber: string;
@@ -2515,7 +2527,7 @@ export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberApiArg
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberSalesStatisticsApiResponse = 
 /** status 200 A list of sales statistics for the product. */ SalesStatistic[];
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberSalesStatisticsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU, MPN, or UPC of the product. */
     productNumber: string;
@@ -2527,14 +2539,14 @@ export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumberSalesSt
 export type PutV4ManufacturerByRouteManufacturerIdProductApiResponse = 
 /** status 200 The newly created product object (some fields may require re-fetch by Randmar SKU). */ Product;
 export type PutV4ManufacturerByRouteManufacturerIdProductApiArg = {
-    /** The ID of the manufacturer for whom the product is being inserted. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The details of the product to create. */
     insertProductInput: InsertProductInput;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberFieldNameApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberFieldNameApiArg = {
-    /** The application ID of the requestor. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU, MPN or UPC of the product to edit. */
     productNumber: string;
@@ -2545,7 +2557,7 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberFieldN
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberBodyHtmlApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberBodyHtmlApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU, MPN, or UPC of the product to edit. */
     productNumber: string;
@@ -2559,14 +2571,14 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberRandma
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberDiscontinueApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberDiscontinueApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU, MPN, or UPC of the product to discontinue. */
     productNumber: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdProductAndProductNumberOrderNumberApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdProductAndProductNumberOrderNumberApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU, MPN, or UPC of the product to cancel. */
     productNumber: string;
@@ -2577,7 +2589,7 @@ export type DeleteV4ManufacturerByRouteManufacturerIdProductAndProductNumberOrde
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberUpcApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberUpcApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU or MPN of the product to update. */
     productNumber: string;
@@ -2586,7 +2598,7 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndProductNumberUpcApi
 };
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuInstantRebateApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuInstantRebateApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product to apply the rebate to. */
     randmarSku: string;
@@ -2595,7 +2607,7 @@ export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuInstantReb
 };
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuRequisitionApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuRequisitionApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product to add. */
     randmarSku: string;
@@ -2607,7 +2619,7 @@ export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuRequisitio
 export type GetV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiResponse = 
 /** status 200 A list of product images. */ ProductImageInfo[];
 export type GetV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2615,7 +2627,7 @@ export type GetV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiA
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiResponse = 
 /** status 200 Information about the uploaded image. */ ProductImageUploadResult;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2631,7 +2643,7 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesApi
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAttachmentApiResponse = 
 /** status 200 The registered attachment UUID. */ string;
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAttachmentApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2641,7 +2653,7 @@ export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAttachment
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAppendImageApiResponse = 
 /** status 200 Information about the appended image. */ ProductImageUploadResult;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAppendImageApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2650,7 +2662,7 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuAppendIma
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesImageIdPrimaryApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesImageIdPrimaryApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2659,7 +2671,7 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesIma
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesReorderApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesReorderApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2668,7 +2680,7 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesReo
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesImageIdApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesImageIdApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
@@ -2677,7 +2689,7 @@ export type DeleteV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImagesI
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImageApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImageApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product to update. */
     randmarSku: string;
@@ -2688,28 +2700,28 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuImageApiA
 };
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuGenerateImageApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuGenerateImageApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product. */
     randmarSku: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumber3DModelApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumber3DModelApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU, MPN, or UPC of the product. */
     productNumber: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumber3DModelExistsApiResponse = unknown;
 export type GetV4ManufacturerByRouteManufacturerIdProductAndProductNumber3DModelExistsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU, MPN, or UPC of the product. */
     productNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSku3DModelApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSku3DModelApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product to update. */
     randmarSku: string;
@@ -2720,7 +2732,7 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSku3DModelAp
 };
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuVideoApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuVideoApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The Randmar SKU of the product to update. */
     randmarSku: string;
@@ -2732,25 +2744,25 @@ export type PostV4ManufacturerByRouteManufacturerIdProductAndRandmarSkuVideoApiA
 export type GetV4ResellerByRouteResellerIdProductsNichesApiResponse = 
 /** status 200 A list of product niches. */ ProductNiche[];
 export type GetV4ResellerByRouteResellerIdProductsNichesApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdProductsReceivingsApiResponse = 
 /** status 200 A list of recent product receivings. */ Receipt[];
 export type GetV4ResellerByRouteResellerIdProductsReceivingsApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdProductsInstantRebatesApiResponse = 
 /** status 200 A list of products with instant rebates. */ Product[];
 export type GetV4ResellerByRouteResellerIdProductsInstantRebatesApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ResellerByRouteResellerIdProductsNewestApiResponse = 
 /** status 200 A list of the newest products. */ Product[];
 export type GetV4ResellerByRouteResellerIdProductsNewestApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4PartnerByRouteApplicationIdProductsApiResponse = 
@@ -2762,7 +2774,7 @@ export type GetV4PartnerByRouteApplicationIdProductsApiArg = {
 export type GetV4ManufacturerByRouteManufacturerIdProductsApiResponse = 
 /** status 200 A list of products. */ Product[];
 export type GetV4ManufacturerByRouteManufacturerIdProductsApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetGuidelinesApiResponse = unknown;
@@ -2912,377 +2924,381 @@ export type GetShortsGenerationContentSceneBySceneNameAmbientSoundApiArg = {
 };
 export type GetWarehousesByPostalCodeApiResponse = unknown;
 export type GetWarehousesByPostalCodeApiArg = {
+    /** Ship-to postal/ZIP code. */
     postalCode?: string;
+    /** Ship-to country code (typically CA or US). */
     country?: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdPurchaseOrderApiResponse = 
 /** status 200 The purchase order number of the newly created purchase order. */ string;
 export type PutV4ManufacturerByRouteManufacturerIdPurchaseOrderApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** If true, the purchase order is sent to the manufacturer. Defaults to true. It is important for chatbots to confirm with the user whether they want the PO to be sent or not before calling this endpoint. */
+    /** If true, the PO is sent to the manufacturer on create. Defaults to true—confirm with the user before calling. */
     sendToManufacturer?: boolean;
-    /** A list of requisition numbers to be included in the purchase order. */
+    /** Requisition numbers to include. Obtain from `GET .../Documents/Requisitions`. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderCreditCheckApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderCreditCheckApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** A list of requisition numbers to perform the credit check against. */
+    /** Requisition numbers to credit-check. Obtain from `GET .../Documents/Requisitions`. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberEditExpectedDateApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberEditExpectedDateApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The purchase order number to modify. */
+    /** The PO number (typically starts with PO). Resolve from Documents/PurchaseOrders if unknown. */
     purchaseOrderNumber: string;
-    /** The new expected date in a string format (e.g., "YYYYMMDD"). */
+    /** The new expected date as a string (e.g., "YYYYMMDD"). */
     newValue?: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The purchase order number to cancel. */
+    /** The PO number to cancel. Resolve from Documents/PurchaseOrders if unknown. */
     purchaseOrderNumber: string;
 };
 export type PutV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberSendApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberSendApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The purchase order number to send. */
+    /** The PO number to send. Resolve from Documents/PurchaseOrders if unknown. */
     purchaseOrderNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberEditItemRandmarSkuApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdPurchaseOrderAndPurchaseOrderNumberEditItemRandmarSkuApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The purchase order number (PO) to edit. */
+    /** The PO number to edit. */
     purchaseOrderNumber: string;
-    /** The Randmar SKU of the product to edit. */
+    /** The Randmar SKU on the PO. Resolve from product GET if the user gave an MPN/UPC. */
     randmarSku: string;
-    /** The quantity of the product to edit. */
+    /** New quantity. 0 removes the item from the PO. */
     quantity?: number;
-    /** The unit price of the product to edit. */
+    /** New unit price for the line. */
     unitPrice?: number;
-    /** Whether or not the standard cost should also be set to unitPrice. */
+    /** If true, also sets standard cost to unitPrice (catalog cost change). */
     editStandardCost?: boolean;
 };
 export type PostV4ResellerByRouteResellerIdReportHpAmplifiedEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportHpAmplifiedEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportUniversalEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportUniversalEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
+    /** Optional manufacturer filter. When provided, only products from that manufacturer are included. */
     manufacturerId?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportProductsEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportProductsEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
+    /** Optional manufacturer filter. When provided, only products from that manufacturer are included. */
     manufacturerId?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportUniversalFileApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportUniversalFileApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Optional manufacturer filter. When provided, only products from that manufacturer are included. */
     manufacturerId?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportProductsFileApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportProductsFileApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Optional manufacturer filter. When provided, only products from that manufacturer are included. */
     manufacturerId?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportUniversalJsonApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportUniversalJsonApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Optional manufacturer filter. When provided, only products from that manufacturer are returned. */
     manufacturerId?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportProductsJsonApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportProductsJsonApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Optional manufacturer filter. When provided, only products from that manufacturer are returned. */
     manufacturerId?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportUniversalProductListWithDefaultOpportunityJsonApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportUniversalProductListWithDefaultOpportunityJsonApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** Optional manufacturer filter. When provided, only products from that manufacturer are returned. */
     manufacturerId?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportShipmentsEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportShipmentsEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportInvoicesEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportInvoicesEmailApiArg = {
-    /** The application ID of the Partner making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The email address to send the report to. */
     emailAddress?: string;
-    /** The start date for the report. The date at which the user wants to start the report. */
+    /** The start date for the report. */
     startDate?: string;
-    /** The end date for the report. The date at which the user wants to end the report. */
+    /** The end date for the report. */
     endDate?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportOpenOrdersEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportOpenOrdersEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportReturnsEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportReturnsEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportOpportunitiesEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportOpportunitiesEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportAmazonTrackingFileEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportAmazonTrackingFileEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportAmazonTrackingFileFileApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportAmazonTrackingFileFileApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type PostV4ResellerByRouteResellerIdReportWalmartTrackingFileEmailApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportWalmartTrackingFileEmailApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The recipient's email address. */
     emailAddress?: string;
 };
 export type PostV4ResellerByRouteResellerIdReportWalmartTrackingFileFileApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReportWalmartTrackingFileFileApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The email address to send the report to (optional; if empty, sends to the authenticated user). */
+    /** Recipient email (optional; if empty, sends to the authenticated user). Confirm before sending. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportResellersEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportResellersEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The email address to send the report to (optional; if empty, sends to the authenticated user). */
+    /** Recipient email (optional; if empty, sends to the authenticated user). Confirm before sending. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderFileApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderAndWarehouseLocationJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportReorderAndWarehouseLocationJsonApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The warehouse location code for the report. */
+    /** The warehouse location code (business/DC identifier) for the report. */
     warehouseLocation: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The email address to send the report to (optional; if empty, sends to the authenticated user). */
+    /** Recipient email (optional; if empty, sends to the authenticated user). Confirm before sending. */
     emailAddress?: string;
-    /** The start date for the sales report (optional). */
+    /** Optional start date. Defaults to the first day of the current month if omitted. */
     startDate?: string;
-    /** The end date for the sales report (optional). */
+    /** Optional end date. Defaults to the first day of the current month if omitted. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesAndResellerIdEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesAndResellerIdEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The reseller ID to scope the report to. */
+    /** The reseller application ID to scope the report. Resolve from the Resellers list. */
     resellerId: string;
-    /** The email address to send the report to (optional; if empty, sends to the authenticated user). */
+    /** Recipient email (optional; if empty, sends to the authenticated user). Confirm before sending. */
     emailAddress?: string;
-    /** The start date for the sales report (optional). */
+    /** Optional start date. Defaults to the first day of the current month if omitted. */
     startDate?: string;
-    /** The end date for the sales report (optional). */
+    /** Optional end date. Defaults to the first day of the current month if omitted. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesFileApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The start date for the sales report (optional). */
+    /** Optional start date. Defaults to the first day of the current month if omitted. */
     startDate?: string;
-    /** The end date for the sales report (optional). */
+    /** Optional end date. Defaults to the first day of the current month if omitted. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportSalesJsonApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The start date for the sales report (optional). */
+    /** Optional start date. Defaults to the first day of the current month if omitted. */
     startDate?: string;
-    /** The end date for the sales report (optional). */
+    /** Optional end date. Defaults to the first day of the current month if omitted. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportBestCanadianFulfillmentCentersApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportBestCanadianFulfillmentCentersApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** A list of Canadian postal codes. Postal codes longer than 7 characters are ignored. */
+    /** Canadian postal codes. Codes longer than 7 characters are ignored. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportBestActiveCanadianFulfillmentCentersApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportBestActiveCanadianFulfillmentCentersApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** A list of Canadian postal codes. Postal codes longer than 7 characters are ignored. */
+    /** Canadian postal codes. Codes longer than 7 characters are ignored. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportBestCanadianWarehousesApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportBestCanadianWarehousesApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** A list of Canadian postal codes. Postal codes longer than 7 characters are ignored. */
+    /** Canadian postal codes. Codes longer than 7 characters are ignored. */
     body: string[];
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The email address to send the report to. */
+    /** Recipient email. Confirm before sending. */
     emailAddress?: string;
-    /** The date for the inventory report. Defaults to the current date if not provided. */
+    /** Inventory as-of date. Defaults to the current date if omitted. */
     inventoryDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryFileApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The date for the inventory report. Defaults to the current date if not provided. */
+    /** Inventory as-of date. Defaults to the current date if omitted. */
     inventoryDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportInventoryJsonApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The date for the inventory report. Defaults to the current date if not provided. */
+    /** Inventory as-of date. Defaults to the current date if omitted. */
     inventoryDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportClaimEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportClaimEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The email address to send the report to (required). */
+    /** Recipient email (required; no fallback). Confirm before sending. */
     emailAddress?: string;
-    /** The start date for the claim report. */
+    /** Optional start date for the claim report. */
     startDate?: string;
-    /** The end date for the claim report. */
+    /** Optional end date for the claim report. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportClaimFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportClaimFileApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The start date for the claim report. */
+    /** Optional start date for the claim report. */
     startDate?: string;
-    /** The end date for the claim report. */
+    /** Optional end date for the claim report. */
     endDate?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportOpenOrdersEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportOpenOrdersEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The email address to send the report to. */
+    /** Recipient email. Confirm before sending. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportOpenOrdersJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportOpenOrdersJsonApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** This parameter is currently not used by the underlying service. */
+    /** Unused by the service; you may pass an empty string. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The email address to send the report to. */
+    /** Recipient email. Confirm before sending. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsFileApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsTsvApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsTsvApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsJsonApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportProductsJsonApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportPurchasedOrdersEmailApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportPurchasedOrdersEmailApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The email address to send the report to. */
+    /** Recipient email. Confirm before sending. */
     emailAddress?: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdReportPurchasedOrdersFileApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdReportPurchasedOrdersFileApiArg = {
-    /** The ID of the manufacturer. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumberApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumberApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The requisition number to cancel. */
+    /** The requisition number to cancel. Obtain from `GET .../Documents/Requisitions`. */
     requisitionNumber: string;
 };
 export type PostV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumberEditItemRandmarSkuApiResponse = unknown;
 export type PostV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumberEditItemRandmarSkuApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The requisition number to edit. */
+    /** The requisition number to edit. Obtain from `GET .../Documents/Requisitions`. */
     requisitionNumber: string;
     /** The Randmar SKU to edit. */
     randmarSku: string;
@@ -3292,7 +3308,7 @@ export type PostV4ManufacturerByRouteManufacturerIdRequisitionAndRequisitionNumb
 export type PutV4ManufacturerByRouteManufacturerIdRequisitionApiResponse = 
 /** status 200 The requisition number of the newly created requisition. */ string;
 export type PutV4ManufacturerByRouteManufacturerIdRequisitionApiArg = {
-    /** The application ID of the Manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The requisition payload including location, reference, and part numbers with quantities. */
     createRequisitionInput: CreateRequisitionInput;
@@ -3300,9 +3316,9 @@ export type PutV4ManufacturerByRouteManufacturerIdRequisitionApiArg = {
 export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdApiResponse = 
 /** status 200 The requested reseller's information. */ Reseller;
 export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdApiArg = {
-    /** The ID of the manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The ID of the reseller to retrieve. */
+    /** 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. */
     withSpecification?: boolean;
@@ -3310,19 +3326,19 @@ export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdApiArg =
 export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdSalesStatisticsApiResponse = 
 /** status 200 A list of sales statistics for the reseller. */ SalesStatistic[];
 export type GetV4ManufacturerByRouteManufacturerIdResellerAndResellerIdSalesStatisticsApiArg = {
-    /** The ID of the manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The ID of the reseller whose sales statistics are to be retrieved. */
+    /** The reseller application ID whose sales statistics are requested. */
     resellerId: string;
-    /** The start date for the statistics period. */
+    /** Optional start date for the statistics period. */
     startDate?: string;
-    /** The end date for the statistics period. */
+    /** Optional end date for the statistics period. */
     endDate?: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdResellerQualificationAndQualificationIdApiResponse = 
 /** status 200 The requested reseller's information. */ Reseller;
 export type GetV4ManufacturerByRouteManufacturerIdResellerQualificationAndQualificationIdApiArg = {
-    /** The ID of the manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
     /** The qualification ID associated with the reseller. */
     qualificationId: string;
@@ -3331,32 +3347,32 @@ export type GetV4ManufacturerByRouteManufacturerIdResellerQualificationAndQualif
 };
 export type PutV4ManufacturerByRouteManufacturerIdResellerAndResellerIdQualificationApiResponse = unknown;
 export type PutV4ManufacturerByRouteManufacturerIdResellerAndResellerIdQualificationApiArg = {
-    /** The ID of the manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The ID of the reseller to qualify. */
+    /** The reseller application ID to qualify. Resolve from the Resellers list if needed. */
     resellerId: string;
-    /** The new qualification value to assign. */
+    /** The qualification value to assign. */
     newValue?: string;
 };
 export type DeleteV4ManufacturerByRouteManufacturerIdResellerAndResellerIdQualificationApiResponse = unknown;
 export type DeleteV4ManufacturerByRouteManufacturerIdResellerAndResellerIdQualificationApiArg = {
-    /** The ID of the manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
-    /** The ID of the reseller whose qualification is to be deleted. */
+    /** 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 ID of the manufacturer making the request. */
+    /** The target manufacturer's application ID. Admins must pass the manufacturer ID, not HQ. */
     routeManufacturerId: string;
 };
 export type GetV4AgencyByRouteAgencyIdResellersApiResponse = 
 /** status 200 A list of resellers. */ Reseller[];
 export type GetV4AgencyByRouteAgencyIdResellersApiArg = {
-    /** The unique identifier for the agency making the request. */
+    /** 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;
-    /** A boolean flag to indicate whether to include detailed specifications for each reseller. Defaults to false. */
+    /** Whether to include detailed specifications for each reseller. Defaults to false. */
     withSpecification?: boolean;
 };
 export type GetV4ResellerByRouteResellerIdReturnAndReturnNumberApiResponse = 
@@ -3367,7 +3383,7 @@ export type GetV4ResellerByRouteResellerIdReturnAndReturnNumberApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdReturnCreateApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReturnCreateApiArg = {
-    /** The ID of the reseller initiating the return. This is taken from the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** ReturnRequest with ReturnPartNumbers. */
     returnRequest: ReturnRequest;
@@ -3395,7 +3411,7 @@ export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberAddCommentApiArg
 };
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberRandmarSkuEditReasonApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberRandmarSkuEditReasonApiArg = {
-    /** The ID of the reseller associated with the return. This is taken from the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The unique identifier for the return/RMA. */
     returnNumber: string;
@@ -3406,7 +3422,7 @@ export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberRandmarSkuEditRe
 };
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberRandmarSkuEditQuantityApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberRandmarSkuEditQuantityApiArg = {
-    /** The ID of the reseller associated with the return. This is taken from the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The unique identifier for the return/RMA. */
     returnNumber: string;
@@ -3451,7 +3467,7 @@ export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberCreditApiArg = {
 };
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberDeclineApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdReturnAndReturnNumberDeclineApiArg = {
-    /** The ID of the reseller initiating the return. This is taken from the route. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The return number that is to be declined. */
     returnNumber: string;
@@ -3470,16 +3486,16 @@ export type PutV4ResellerByRouteResellerIdReturnAndReturnNumberAdminCreditApiArg
 export type GetV4PartnerByRoutePartnerIdReturnAndReturnNumberApiResponse = 
 /** status 200 Returns the complete return information. */ ReturnOld;
 export type GetV4PartnerByRoutePartnerIdReturnAndReturnNumberApiArg = {
-    /** The ID of the partner who initiated the return. This is taken from the route. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routePartnerId: string;
     /** The unique identifier for the return/RMA. */
     returnNumber: string;
-    /** Whether to include detailed retun specifications in the response. */
+    /** Whether to include detailed return specifications in the response. */
     withSpecification?: boolean;
 };
 export type PostV4PartnerByRoutePartnerIdReturnAndReturnNumberAddCommentApiResponse = unknown;
 export type PostV4PartnerByRoutePartnerIdReturnAndReturnNumberAddCommentApiArg = {
-    /** The ID of the Partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routePartnerId: string;
     /** The unique identifier for the return/RMA. */
     returnNumber: string;
@@ -3489,7 +3505,7 @@ export type PostV4PartnerByRoutePartnerIdReturnAndReturnNumberAddCommentApiArg =
 export type PostV4PartnerByRoutePartnerIdReturnAndReturnNumberAcceptApiResponse = 
 /** status 200 The status was changed successfully. */ boolean;
 export type PostV4PartnerByRoutePartnerIdReturnAndReturnNumberAcceptApiArg = {
-    /** The partner scope for this request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routePartnerId: string;
     /** The return number that is to be accepted. */
     returnNumber: string;
@@ -3497,7 +3513,7 @@ export type PostV4PartnerByRoutePartnerIdReturnAndReturnNumberAcceptApiArg = {
 export type PostV4PartnerByRoutePartnerIdReturnCreateAndResellerIdApiResponse = 
 /** status 200 Returns the created return number. */ string;
 export type PostV4PartnerByRoutePartnerIdReturnCreateAndResellerIdApiArg = {
-    /** The partner scope for this request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routePartnerId: string;
     /** The reseller ID for which the return is created. */
     resellerId: string;
@@ -3507,7 +3523,7 @@ export type PostV4PartnerByRoutePartnerIdReturnCreateAndResellerIdApiArg = {
 export type GetV4ResellerByRouteResellerIdReturnsApiResponse = 
 /** status 200 Returns a list of all returns of this reseller */ ReturnOld[];
 export type GetV4ResellerByRouteResellerIdReturnsApiArg = {
-    /** The ID of the reseller */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type GetV4ManufacturerByRouteManufacturerIdReturnsApiResponse = 
@@ -3535,7 +3551,7 @@ export type GetV4ResellerByRouteResellerIdSearchApiArg = {
 export type GetV4PartnerByRouteApplicationIdSearchApiResponse = 
 /** status 200 An array of search results matching the query. */ SearchResult;
 export type GetV4PartnerByRouteApplicationIdSearchApiArg = {
-    /** The application ID of the Partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The search query string. */
     q?: string;
@@ -3551,7 +3567,7 @@ export type GetV4ManufacturerByRouteManufacturerIdSearchApiArg = {
 export type PutV4ResellerByRouteResellerIdShippingLabelGenerateApiResponse = 
 /** status 200 Returns the tracking number of the generated shipping label. */ string;
 export type PutV4ResellerByRouteResellerIdShippingLabelGenerateApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The details of the shipment, including from/to addresses, carrier, and package information. */
     shipmentDetails: ShipmentDetails;
@@ -3567,7 +3583,7 @@ export type PutV4ResellerByRouteResellerIdShippingLabelLogisticsApiArg = {
 export type PostV4ResellerByRouteResellerIdShippingLabelEstimateApiResponse = 
 /** status 200 A list of shipping carriers and their estimated prices. */ ShipViaEstimate[];
 export type PostV4ResellerByRouteResellerIdShippingLabelEstimateApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The details of the shipment, including from/to addresses and package information. */
     shipmentDetails: ShipmentDetails;
@@ -3575,12 +3591,12 @@ export type PostV4ResellerByRouteResellerIdShippingLabelEstimateApiArg = {
 export type GetV4ResellerByRouteResellerIdShopifyAccountsApiResponse = 
 /** status 200 A list of Shopify account information. */ any[];
 export type GetV4ResellerByRouteResellerIdShopifyAccountsApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
 };
 export type PostV4ResellerByRouteResellerIdShopifyAndShopifyhostNameFulfillmentShopifyFulfillmentOrderIrderIdSupportedActionApiResponse = unknown;
 export type PostV4ResellerByRouteResellerIdShopifyAndShopifyhostNameFulfillmentShopifyFulfillmentOrderIrderIdSupportedActionApiArg = {
-    /** The ID of the reseller making the request. */
+    /** The target reseller application ID. */
     routeResellerId: string;
     /** The Shopify store host name (e.g., `your-store.myshopify.com`). */
     shopifyhostName: string;
@@ -3599,7 +3615,7 @@ export type GetV4PartnerByRouteApplicationIdShopifyApiArg = {
 export type GetV4PartnerByRouteApplicationIdShopifyAndShopifyHostNameAttachmentsApiResponse = 
 /** status 200 Attachments associated with the Shopify store host name. */ AttachmentHeader[];
 export type GetV4PartnerByRouteApplicationIdShopifyAndShopifyHostNameAttachmentsApiArg = {
-    /** The application ID associated with the Shopify store. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Shopify store host name (e.g., `your-store.myshopify.com`). */
     shopifyHostName: string;
@@ -3607,7 +3623,7 @@ export type GetV4PartnerByRouteApplicationIdShopifyAndShopifyHostNameAttachments
 export type PutV4PartnerByRouteApplicationIdShopifyAndShopifyHostNameAttachmentApiResponse = 
 /** status 200 The registered attachment UUID. */ string;
 export type PutV4PartnerByRouteApplicationIdShopifyAndShopifyHostNameAttachmentApiArg = {
-    /** The application ID associated with the Shopify store. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Shopify store host name (e.g., `your-store.myshopify.com`). */
     shopifyHostName: string;
@@ -3663,7 +3679,7 @@ export type PostV4PartnerByRouteApplicationIdShopifyProductPricingStrategyApiArg
 };
 export type PostV4PartnerByRouteApplicationIdShopifyAdsGrowthStrategyApiResponse = unknown;
 export type PostV4PartnerByRouteApplicationIdShopifyAdsGrowthStrategyApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Shopify store host name. */
     shopifyHostName?: string;
@@ -3672,7 +3688,7 @@ export type PostV4PartnerByRouteApplicationIdShopifyAdsGrowthStrategyApiArg = {
 };
 export type PostV4PartnerByRouteApplicationIdShopifyAdvertisingBudgetPerDayApiResponse = unknown;
 export type PostV4PartnerByRouteApplicationIdShopifyAdvertisingBudgetPerDayApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Shopify store host name. */
     shopifyHostName?: string;
@@ -3681,11 +3697,11 @@ export type PostV4PartnerByRouteApplicationIdShopifyAdvertisingBudgetPerDayApiAr
 };
 export type PostV4PartnerByRouteApplicationIdShopifyGoogleAdsIdApiResponse = unknown;
 export type PostV4PartnerByRouteApplicationIdShopifyGoogleAdsIdApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The Shopify store host name. */
     shopifyHostName?: string;
-    /** The Google Ads customer ID to store. */
+    /** The Google Ads customer ID to store (10 digits, or empty to clear). */
     newValue?: string;
 };
 export type PutV4PartnerByRouteApplicationIdShopifyWebhookAndModuleStatusApiResponse = unknown;
@@ -3760,7 +3776,7 @@ export type DeleteV4PartnerByRouteApplicationIdUserAndEmailAddressNotificationNo
 export type GetV4PartnerByRouteApplicationIdUserNotificationTypesApiResponse = 
 /** status 200 A list of notification types (strings). */ string[];
 export type GetV4PartnerByRouteApplicationIdUserNotificationTypesApiArg = {
-    /** The partner application ID. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type GetV4PartnerByRouteApplicationIdUsersApiResponse = 
@@ -3772,13 +3788,13 @@ export type GetV4PartnerByRouteApplicationIdUsersApiArg = {
 export type GetV4PartnerByRouteApplicationIdUsersRandmarTeamApiResponse = 
 /** status 200 A list of users. */ User[];
 export type GetV4PartnerByRouteApplicationIdUsersRandmarTeamApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type PutV4PartnerByRouteApplicationIdUtilitiesExcelToJsonApiResponse = 
 /** status 200 The JSON representation of the Excel file. */ JsonRepresentation;
 export type PutV4PartnerByRouteApplicationIdUtilitiesExcelToJsonApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     body: {
         /** The Excel file to be converted. The file should be sent as form data. */
@@ -3787,7 +3803,7 @@ export type PutV4PartnerByRouteApplicationIdUtilitiesExcelToJsonApiArg = {
 };
 export type PutV4PartnerByRouteApplicationIdUtilitiesJsonArrayToExcelApiResponse = unknown;
 export type PutV4PartnerByRouteApplicationIdUtilitiesJsonArrayToExcelApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** Optional download file name (defaults to `data.xlsx`). */
     fileName?: string;
@@ -3804,7 +3820,7 @@ export type GetV4PartnerByRouteApplicationIdUtilitiesStandardOperatingProcedures
 };
 export type GetV4PartnerByRouteApplicationIdUtilitiesStandardOperatingProcedureAndIdApiResponse = unknown;
 export type GetV4PartnerByRouteApplicationIdUtilitiesStandardOperatingProcedureAndIdApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The SOP file ID. */
     id: string;
@@ -3812,13 +3828,13 @@ export type GetV4PartnerByRouteApplicationIdUtilitiesStandardOperatingProcedureA
 export type GetV4PartnerByRouteApplicationIdVendorInvoicesAndCreditsApiResponse = 
 /** status 200 Returns the vendor's invoices and credits as a collection of `VendorDocument` records. */ VendorDocument[];
 export type GetV4PartnerByRouteApplicationIdVendorInvoicesAndCreditsApiArg = {
-    /** The application ID of the vendor making the request. */
+    /** The vendor partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdApiResponse = 
 /** status 200 The warehouse information. */ Warehouse;
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The warehouse ID to retrieve. */
     warehouseId: string;
@@ -3826,7 +3842,7 @@ export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdApiArg = {
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdReturnsApiResponse = 
 /** status 200 A list of returns. */ ReturnOld[];
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdReturnsApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The warehouse ID. */
     warehouseId: string;
@@ -3868,7 +3884,7 @@ export type PostV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdReturnReturn
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdOrdersApiResponse = 
 /** status 200 A list of orders. */ Order[];
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdOrdersApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The warehouse ID. */
     warehouseId: string;
@@ -3876,7 +3892,7 @@ export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdOrdersApiArg
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdShipmentsApiResponse = 
 /** status 200 A list of shipments. */ Shipment[];
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdShipmentsApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The warehouse ID. */
     warehouseId: string;
@@ -3892,7 +3908,7 @@ export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdInvoicesRecen
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdPurchaseOrdersApiResponse = 
 /** status 200 A list of purchase orders. */ PurchaseOrder[];
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdPurchaseOrdersApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The ID of the warehouse. */
     warehouseId: string;
@@ -3900,7 +3916,7 @@ export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdPurchaseOrder
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdPurchaseOrderPoNumberApiResponse = 
 /** status 200 The purchase order details. */ PurchaseOrderDetail[];
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdPurchaseOrderPoNumberApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The ID of the warehouse. */
     warehouseId: string;
@@ -3932,7 +3948,7 @@ export type PutV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdReceiptRcpNum
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdReceiptRcpNumberApiResponse = 
 /** status 200 The line items included on this receipt. */ ReceiptDetail[];
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdReceiptRcpNumberApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The ID of the warehouse. */
     warehouseId: string;
@@ -3942,7 +3958,7 @@ export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdReceiptRcpNum
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdStocktransfersApiResponse = 
 /** status 200 A list of stock transfers. */ StockTransfer[];
 export type GetV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdStocktransfersApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The warehouse ID. */
     warehouseId: string;
@@ -3961,7 +3977,7 @@ export type PutV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdProductRandma
 };
 export type PostV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdFieldNameApiResponse = unknown;
 export type PostV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdFieldNameApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The warehouse ID to edit. */
     warehouseId: string;
@@ -3972,7 +3988,7 @@ export type PostV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdFieldNameApi
 };
 export type PutV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdCarrierIntegrationApiResponse = unknown;
 export type PutV4PartnerByRouteApplicationIdWarehouseAndWarehouseIdCarrierIntegrationApiArg = {
-    /** The application ID of the partner making the request. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
     /** The warehouse ID. */
     warehouseId: string;
@@ -4021,7 +4037,7 @@ export type PutV4PartnerByRouteApplicationIdWarehouseApiArg = {
 export type GetV4PartnerByRouteApplicationIdWarehousesApiResponse = 
 /** status 200 A list of warehouses. */ Warehouse[];
 export type GetV4PartnerByRouteApplicationIdWarehousesApiArg = {
-    /** The application ID of the partner. */
+    /** The partner application ID. Admins must pass the target partner ID, not HQ (`2` / `FGDCT3037`). */
     routeApplicationId: string;
 };
 export type GetV4PartnerByRouteApplicationIdWorkflowProjectsApiResponse = 
@@ -6726,7 +6742,8 @@ export type ShipViaEstimate = {
 export type RandmarApiControllersV4PartnerProductControllerGenerateProductMediaRequest = {
     /** The description of the image or video to generate. */
     Prompt: string;
-    /** Optional public image URLs to use as visual references. When supplied, these replace the product's primary image. */
+    /** Optional public image URLs to use as visual references. When supplied, these replace the product's primary image.
+    Obtain anonymously downloadable URLs via `POST V4/Partner/{applicationId}/Generation/Upload`—never private Google Drive or login-gated links. */
     ReferenceImageUrls?: string[] | null;
 };
 export type InsertProductInput = {