fix(cli): send dynamicIRLanguages on registerApiDefinition instead of the IR bodies

packages/cli/cli/changes/unreleased/send-dynamic-ir-languages.yml

@@ -0,0 +1,6 @@
+- summary: |
+    Fix `PAYLOAD_TOO_LARGE` failures when publishing docs for large APIs with dynamic snippets. The
+    dynamic IRs were sent inline in the `registerApiDefinition` request once per SDK language, even
+    though the registry only needs the language names to issue upload URLs. The request now carries
+    `dynamicIRLanguages` and the IRs themselves are still uploaded to S3 separately.
+  type: fix

packages/cli/generation/remote-generation/remote-workspace-runner/src/publishDocs.ts

@@ -479,16 +479,23 @@ export async function publishDocs({
 
             const effectiveApiName = apiName ?? getOriginalName(ir.apiName);
 
+            const dynamicIRLanguages = dynamicIRsByLanguage != null ? Object.keys(dynamicIRsByLanguage) : undefined;
+            const registerApiDefinitionRequest = {
+                orgId: CjsFdrSdk.OrgId(organization),
+                apiId: CjsFdrSdk.ApiId(effectiveApiName),
+                definition: apiDefinition,
+                dynamicIRLanguages
+            };
+            context.logger.debug(
+                `registerApiDefinition request body for ${effectiveApiName}: ${Buffer.byteLength(
+                    JSON.stringify(registerApiDefinitionRequest)
+                )} bytes, ${dynamicIRLanguages?.length ?? 0} dynamic IR language(s) (IR bodies are uploaded separately)`
+            );
+
             let response;
             try {
                 response = await retryWithBackoff({
-                    fn: () =>
-                        fdr.api.register.registerApiDefinition({
-                            orgId: CjsFdrSdk.OrgId(organization),
-                            apiId: CjsFdrSdk.ApiId(effectiveApiName),
-                            definition: apiDefinition,
-                            dynamicIRs: dynamicIRsByLanguage
-                        }),
+                    fn: () => fdr.api.register.registerApiDefinition(registerApiDefinitionRequest),
                     maxRetries: REGISTER_MAX_RETRIES,
                     baseDelayMs: REGISTER_BASE_DELAY_MS,
                     jitterFactor: REGISTER_JITTER_FACTOR,