@wevion/cli 1.0.3230 → 1.0.3240

package/openapi.json

@@ -26225,7 +26225,7 @@
         "tags": [
           "auth"
         ],
-        "description": "Returns the authenticated user profile. Requires a valid JWT token. Includes `is_internal`: true when the profile is outside the clean analytics cohort (internal/staff e-mail domain, Gold/ULTRA, comped, allowlisted, backoffice staff role, or the demo account) — the same population every backoffice dashboard excludes. Used by the SPA to tag the session cohort in analytics; it carries no entitlement and grants nothing.",
+        "description": "Returns the authenticated user profile. Requires a valid JWT token. Includes `is_internal`: true when the profile is outside the clean analytics cohort (internal/staff e-mail domain, Gold/ULTRA, comped, allowlisted, backoffice staff role, or the demo account) — the same population every backoffice dashboard excludes. Used by the SPA to tag the session cohort in analytics; it carries no entitlement and grants nothing. Also includes `organization_id` (the backoffice `organization.id`), used by the SPA to tag the Clarity Live session for a direct backoffice lookup.",
         "security": [
           {
             "bearerAuth": []
@@ -26547,6 +26547,17 @@
                     "is_internal": {
                       "type": "boolean"
                     },
+                    "organization_id": {
+                      "anyOf": [
+                        {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "subscription": {
                       "type": "object",
                       "required": [
@@ -27552,6 +27563,17 @@
                     "is_internal": {
                       "type": "boolean"
                     },
+                    "organization_id": {
+                      "anyOf": [
+                        {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "subscription": {
                       "type": "object",
                       "required": [
@@ -28400,6 +28422,17 @@
                     "is_internal": {
                       "type": "boolean"
                     },
+                    "organization_id": {
+                      "anyOf": [
+                        {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "subscription": {
                       "type": "object",
                       "required": [
@@ -104571,236 +104604,9 @@
                     "error"
                   ],
                   "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "403": {
-            "description": "Forbidden - caller lacks the required role/permission",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "error"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Resource not found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "error"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      },
-      "post": {
-        "operationId": "postApiV1CreativeHubAvatars",
-        "summary": "Create Creative Hub avatar",
-        "tags": [
-          "creative-hub"
-        ],
-        "description": "Queues a custom text-to-avatar or photo-to-avatar generation job.",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "additionalProperties": false,
-                "type": "object",
-                "required": [
-                  "mode",
-                  "name"
-                ],
-                "properties": {
-                  "mode": {
-                    "anyOf": [
-                      {
-                        "type": "string",
-                        "enum": [
-                          "text"
-                        ]
-                      },
-                      {
-                        "type": "string",
-                        "enum": [
-                          "photo"
-                        ]
-                      }
-                    ]
-                  },
-                  "name": {
-                    "minLength": 1,
-                    "maxLength": 120,
-                    "type": "string"
-                  },
-                  "prompt": {
-                    "maxLength": 2000,
-                    "type": "string"
-                  },
-                  "template_avatar_id": {
-                    "type": "string"
-                  },
-                  "source_image_url": {
-                    "type": "string"
-                  },
-                  "gender": {
-                    "maxLength": 20,
-                    "type": "string"
-                  },
-                  "age_bracket": {
-                    "maxLength": 20,
-                    "type": "string"
-                  },
-                  "scenario": {
-                    "maxLength": 40,
-                    "type": "string"
-                  },
-                  "voice_id": {
-                    "type": "string"
-                  }
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "bearerAuth": []
-          },
-          {
-            "apiKeyAuth": []
-          }
-        ],
-        "responses": {
-          "202": {
-            "description": "Accepted - processing asynchronously",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "avatar_id",
-                    "generation_id",
-                    "status",
-                    "estimated_credits",
-                    "polling_interval_ms"
-                  ],
-                  "properties": {
-                    "avatar_id": {
-                      "format": "uuid",
-                      "type": "string"
-                    },
-                    "generation_id": {
-                      "format": "uuid",
-                      "type": "string"
-                    },
-                    "status": {
-                      "type": "string"
-                    },
-                    "estimated_credits": {
-                      "minimum": 0,
-                      "type": "integer"
-                    },
-                    "polling_interval_ms": {
-                      "minimum": 1,
-                      "type": "integer"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Invalid request - schema validation failed",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "error"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized - missing or invalid bearer token",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "error"
-                  ],
-                  "properties": {
-                    "error": {
+                    "code": {
                       "type": "string"
                     },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "402": {
-            "description": "Response 402",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "error"
-                  ],
-                  "properties": {
                     "error": {
                       "type": "string"
                     },
@@ -104823,6 +104629,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -104845,6 +104654,279 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "postApiV1CreativeHubAvatars",
+        "summary": "Create Creative Hub avatar",
+        "tags": [
+          "creative-hub"
+        ],
+        "description": "Queues a custom text-to-avatar or photo-to-avatar generation job.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "mode",
+                  "name"
+                ],
+                "properties": {
+                  "mode": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "text"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "photo"
+                        ]
+                      }
+                    ]
+                  },
+                  "name": {
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "type": "string"
+                  },
+                  "prompt": {
+                    "maxLength": 2000,
+                    "type": "string"
+                  },
+                  "template_avatar_id": {
+                    "type": "string"
+                  },
+                  "source_image_url": {
+                    "type": "string"
+                  },
+                  "gender": {
+                    "maxLength": 20,
+                    "type": "string"
+                  },
+                  "age_bracket": {
+                    "maxLength": 20,
+                    "type": "string"
+                  },
+                  "scenario": {
+                    "maxLength": 40,
+                    "type": "string"
+                  },
+                  "voice_id": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted - processing asynchronously",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "avatar_id",
+                    "generation_id",
+                    "status",
+                    "estimated_credits",
+                    "polling_interval_ms"
+                  ],
+                  "properties": {
+                    "avatar_id": {
+                      "format": "uuid",
+                      "type": "string"
+                    },
+                    "generation_id": {
+                      "format": "uuid",
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    },
+                    "estimated_credits": {
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    "polling_interval_ms": {
+                      "minimum": 1,
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "402": {
+            "description": "Response 402",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -104867,6 +104949,34 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105130,6 +105240,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105152,6 +105265,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105174,6 +105290,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105196,6 +105315,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105250,6 +105372,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105272,6 +105397,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105294,6 +105422,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105495,6 +105626,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105517,6 +105651,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105539,6 +105676,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105918,6 +106058,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105940,6 +106083,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105962,6 +106108,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -105984,6 +106133,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106373,6 +106525,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106395,6 +106550,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106417,6 +106575,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106439,6 +106600,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106493,6 +106657,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106515,6 +106682,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106537,6 +106707,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106727,6 +106900,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -106749,6 +106925,59 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -109542,6 +109771,28 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -109753,6 +110004,28 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -109942,186 +110215,208 @@
                 }
               }
             }
-          }
-        }
-      }
-    },
-    "/api/v1/creative-hub/generate/tts": {
-      "post": {
-        "operationId": "creativeHubGenerateTTS",
-        "summary": "Generate text-to-speech audio",
-        "tags": [
-          "creative-hub",
-          "creative-generation"
-        ],
-        "description": "Queues a TTS audio generation job via ElevenLabs or OpenAI. Returns 202 Accepted with an async-job handle; poll GET /api/v1/creative-hub/generate/jobs/:id to retrieve the result.",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "required": [
-                  "text"
-                ],
-                "properties": {
-                  "text": {
-                    "minLength": 1,
-                    "maxLength": 5000,
-                    "type": "string"
-                  },
-                  "voice_id": {
-                    "type": "string"
-                  },
-                  "language": {
-                    "type": "string"
-                  },
-                  "provider": {
-                    "anyOf": [
-                      {
-                        "type": "string",
-                        "enum": [
-                          "elevenlabs"
-                        ]
-                      },
-                      {
-                        "type": "string",
-                        "enum": [
-                          "openai_tts"
-                        ]
-                      }
-                    ]
-                  },
-                  "drive_folder_id": {
-                    "type": "string"
-                  }
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "bearerAuth": []
-          },
-          {
-            "apiKeyAuth": []
-          }
-        ],
-        "responses": {
-          "202": {
-            "description": "Accepted - processing asynchronously",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "job_id",
-                    "status",
-                    "polling_interval_ms",
-                    "created_at"
-                  ],
-                  "properties": {
-                    "job_id": {
-                      "description": "ID of the queued creative_job row",
-                      "type": "string"
-                    },
-                    "status": {
-                      "description": "Initial job status (always \"pending\" right after enqueue)",
-                      "type": "string"
-                    },
-                    "polling_interval_ms": {
-                      "description": "Suggested polling interval for GET /generate/jobs/:id",
-                      "type": "integer"
-                    },
-                    "estimated_wait_ms": {
-                      "description": "Rough estimated completion wait (provider-dependent)",
-                      "type": "integer"
-                    },
-                    "created_at": {
-                      "format": "date-time",
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized - missing or invalid bearer token",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            }
-          },
-          "402": {
-            "description": "Response 402",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "error"
-                  ],
-                  "properties": {
-                    "code": {
-                      "type": "string"
-                    },
-                    "error": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "403": {
-            "description": "Forbidden - caller lacks the required role/permission",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "error"
-                  ],
-                  "properties": {
-                    "code": {
-                      "type": "string"
-                    },
-                    "error": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Resource not found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "error"
-                  ],
-                  "properties": {
-                    "code": {
-                      "type": "string"
-                    },
-                    "error": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/creative-hub/generate/tts": {
+      "post": {
+        "operationId": "creativeHubGenerateTTS",
+        "summary": "Generate text-to-speech audio",
+        "tags": [
+          "creative-hub",
+          "creative-generation"
+        ],
+        "description": "Queues a TTS audio generation job via ElevenLabs or OpenAI. Returns 202 Accepted with an async-job handle; poll GET /api/v1/creative-hub/generate/jobs/:id to retrieve the result.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "text"
+                ],
+                "properties": {
+                  "text": {
+                    "minLength": 1,
+                    "maxLength": 5000,
+                    "type": "string"
+                  },
+                  "voice_id": {
+                    "type": "string"
+                  },
+                  "language": {
+                    "type": "string"
+                  },
+                  "provider": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "elevenlabs"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "openai_tts"
+                        ]
+                      }
+                    ]
+                  },
+                  "drive_folder_id": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted - processing asynchronously",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "job_id",
+                    "status",
+                    "polling_interval_ms",
+                    "created_at"
+                  ],
+                  "properties": {
+                    "job_id": {
+                      "description": "ID of the queued creative_job row",
+                      "type": "string"
+                    },
+                    "status": {
+                      "description": "Initial job status (always \"pending\" right after enqueue)",
+                      "type": "string"
+                    },
+                    "polling_interval_ms": {
+                      "description": "Suggested polling interval for GET /generate/jobs/:id",
+                      "type": "integer"
+                    },
+                    "estimated_wait_ms": {
+                      "description": "Rough estimated completion wait (provider-dependent)",
+                      "type": "integer"
+                    },
+                    "created_at": {
+                      "format": "date-time",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "402": {
+            "description": "Response 402",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           },
           "429": {
             "description": "Too many requests - rate limit exceeded",
@@ -110144,6 +110439,28 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -110403,6 +110720,28 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -111219,6 +111558,31 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -112834,6 +113198,164 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/creative-hub/image-studio/estimate": {
+      "post": {
+        "operationId": "creativeHubEstimateCinematicImage",
+        "summary": "Estimate cinematic image generation credit cost",
+        "tags": [
+          "creative-hub",
+          "creative-generation"
+        ],
+        "description": "Returns the deterministic credit hold estimate for a cinematic image generation. The estimate resolves the SAME catalog model the generation will run on, so the style preset (which routes to different, differently-priced models) and any reference image are both reflected in the amount.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "num_variants"
+                ],
+                "properties": {
+                  "num_variants": {
+                    "minimum": 1,
+                    "maximum": 4,
+                    "type": "integer"
+                  },
+                  "resolution": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "720p"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "1080p"
+                        ]
+                      }
+                    ]
+                  },
+                  "style": {
+                    "maxLength": 64,
+                    "type": "string"
+                  },
+                  "reference_image_url": {
+                    "maxLength": 2000,
+                    "type": "string"
+                  },
+                  "reference_image_urls": {
+                    "maxItems": 4,
+                    "type": "array",
+                    "items": {
+                      "maxLength": 2000,
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "credits",
+                    "model_id"
+                  ],
+                  "properties": {
+                    "credits": {
+                      "type": "integer"
+                    },
+                    "model_id": {
+                      "description": "Catalog model the generation will be priced and run on.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
           }
         }
       }
@@ -118281,6 +118803,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -118425,6 +118950,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -118457,6 +118985,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -118479,6 +119010,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -118490,8 +119024,8 @@
               }
             }
           },
-          "500": {
-            "description": "Internal server error",
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
             "content": {
               "application/json": {
                 "schema": {
@@ -118501,6 +119035,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -118511,120 +119048,25 @@
                 }
               }
             }
-          }
-        }
-      }
-    },
-    "/api/v1/creative-hub/credits": {
-      "get": {
-        "operationId": "creativeHubGetCredits",
-        "summary": "Creative Hub credit balance",
-        "tags": [
-          "creative-hub"
-        ],
-        "description": "Returns spendable AI credits for Creative Hub generation, including purchased credits and weekly grant credits.",
-        "security": [
-          {
-            "bearerAuth": []
-          },
-          {
-            "apiKeyAuth": []
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successful response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "balance",
-                    "grant_balance",
-                    "monthly_cap",
-                    "monthly_used",
-                    "spendable",
-                    "total_purchased",
-                    "total_used"
-                  ],
-                  "properties": {
-                    "balance": {
-                      "type": "number"
-                    },
-                    "grant_balance": {
-                      "type": "number"
-                    },
-                    "monthly_cap": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "monthly_used": {
-                      "type": "number"
-                    },
-                    "spendable": {
-                      "type": "number"
-                    },
-                    "total_purchased": {
-                      "type": "number"
-                    },
-                    "total_used": {
-                      "type": "number"
-                    }
-                  }
-                }
-              }
-            }
           },
-          "401": {
-            "description": "Unauthorized - missing or invalid bearer token",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/api/v1/creative-hub/ugc/products/upload": {
-      "post": {
-        "operationId": "creativeHubUploadUgcProductImage",
-        "summary": "Upload a product image for UGC product-hand mode",
-        "tags": [
-          "creative-hub",
-          "creative-generation"
-        ],
-        "description": "Uploads one JPEG, PNG or WebP product image for the UGC product-hand generation mode and stores it in team-scoped creative asset storage.",
-        "security": [
-          {
-            "bearerAuth": []
-          }
-        ],
-        "responses": {
-          "201": {
-            "description": "Resource created",
+          "500": {
+            "description": "Internal server error",
             "content": {
               "application/json": {
                 "schema": {
                   "additionalProperties": false,
                   "type": "object",
                   "required": [
-                    "image_url",
-                    "storage_key"
+                    "error"
                   ],
                   "properties": {
-                    "image_url": {
+                    "code": {
                       "type": "string"
                     },
-                    "storage_key": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
                       "type": "string"
                     }
                   }
@@ -118632,8 +119074,153 @@
               }
             }
           },
-          "400": {
-            "description": "Invalid request - schema validation failed",
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/creative-hub/credits": {
+      "get": {
+        "operationId": "creativeHubGetCredits",
+        "summary": "Creative Hub credit balance",
+        "tags": [
+          "creative-hub"
+        ],
+        "description": "Returns spendable AI credits for Creative Hub generation, including purchased credits and weekly grant credits.",
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "balance",
+                    "grant_balance",
+                    "monthly_cap",
+                    "monthly_used",
+                    "spendable",
+                    "total_purchased",
+                    "total_used"
+                  ],
+                  "properties": {
+                    "balance": {
+                      "type": "number"
+                    },
+                    "grant_balance": {
+                      "type": "number"
+                    },
+                    "monthly_cap": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "monthly_used": {
+                      "type": "number"
+                    },
+                    "spendable": {
+                      "type": "number"
+                    },
+                    "total_purchased": {
+                      "type": "number"
+                    },
+                    "total_used": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/creative-hub/ugc/products/upload": {
+      "post": {
+        "operationId": "creativeHubUploadUgcProductImage",
+        "summary": "Upload a product image for UGC product-hand mode",
+        "tags": [
+          "creative-hub",
+          "creative-generation"
+        ],
+        "description": "Uploads one JPEG, PNG or WebP product image for the UGC product-hand generation mode and stores it in team-scoped creative asset storage.",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Resource created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "image_url",
+                    "storage_key"
+                  ],
+                  "properties": {
+                    "image_url": {
+                      "type": "string"
+                    },
+                    "storage_key": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
             "content": {
               "application/json": {
                 "schema": {
@@ -119507,6 +120094,31 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -119519,7 +120131,7 @@
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Returns the deterministic credit estimate for a UGC generation request without starting a provider job.",
+        "description": "Returns the deterministic credit estimate for a UGC generation request without starting a provider job. The estimate is computed from the SAME resolved billing input the generate endpoint charges from, so it accounts for the two effects that used to make the charge exceed the quote: a spoken script longer than the requested duration extends the billable duration (up to 15s, reported as duration_source), and a product photo adds a product-description line. Supply script_word_count and has_product_image to get the exact amount that will be charged; omitting them yields the floor of that amount.",
         "requestBody": {
           "required": true,
           "content": {
@@ -119584,7 +120196,19 @@
                   "captions": {
                     "type": "boolean"
                   },
+                  "has_product_image": {
+                    "description": "Whether a product photo will be attached. It triggers a real product-description model call, so it raises the estimate. mode=product_hand implies true (the photo is mandatory there).",
+                    "type": "boolean"
+                  },
+                  "script_word_count": {
+                    "minimum": 0,
+                    "maximum": 2000,
+                    "description": "Word count of the user-supplied script (not the script itself — this endpoint performs no I/O and stores nothing). Used to detect a spoken duration longer than duration_seconds. Ignored for mode=ai_script, where the script is written to fit the requested duration.",
+                    "type": "integer"
+                  },
                   "model_id": {
+                    "deprecated": true,
+                    "description": "DEPRECATED and ignored: the UGC engine model is not caller-selectable. Kept so existing SDK clients that still send it do not start failing schema validation. It will be removed in a future major version.",
                     "type": "string"
                   }
                 }
@@ -119606,13 +120230,100 @@
             "content": {
               "application/json": {
                 "schema": {
+                  "additionalProperties": false,
                   "type": "object",
                   "required": [
-                    "credits"
+                    "credits",
+                    "breakdown",
+                    "billable_seconds",
+                    "duration_source",
+                    "resolution_multiplier",
+                    "pricing_version"
                   ],
                   "properties": {
                     "credits": {
+                      "description": "Total credits that will be held and charged.",
                       "type": "integer"
+                    },
+                    "breakdown": {
+                      "description": "Per catalog line contribution to the total.",
+                      "type": "array",
+                      "items": {
+                        "additionalProperties": false,
+                        "type": "object",
+                        "required": [
+                          "model_id",
+                          "retail_credits",
+                          "unit",
+                          "units"
+                        ],
+                        "properties": {
+                          "model_id": {
+                            "type": "string"
+                          },
+                          "retail_credits": {
+                            "type": "integer"
+                          },
+                          "unit": {
+                            "type": "string"
+                          },
+                          "units": {
+                            "type": "number"
+                          }
+                        }
+                      }
+                    },
+                    "billable_seconds": {
+                      "description": "Seconds actually billed (minimum 8s, capped at 15s).",
+                      "type": "integer"
+                    },
+                    "duration_source": {
+                      "description": "extended_to_spoken means the spoken script is longer than the requested duration, so the billable duration was raised to fit it.",
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "requested"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "extended_to_spoken"
+                          ]
+                        }
+                      ]
+                    },
+                    "resolution_multiplier": {
+                      "type": "number"
+                    },
+                    "pricing_version": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
                     }
                   }
                 }
@@ -120591,6 +121302,27 @@
               }
             }
           },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error",
             "content": {
@@ -120608,6 +121340,28 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -120964,6 +121718,175 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/creative-hub/video-studio/estimate": {
+      "post": {
+        "operationId": "creativeHubEstimateCinematicVideo",
+        "summary": "Estimate cinematic video generation credit cost",
+        "tags": [
+          "creative-hub",
+          "creative-generation"
+        ],
+        "description": "Returns the deterministic credit hold estimate for a cinematic video generation, from the same catalog rates the generation is charged at.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "properties": {
+                  "duration": {
+                    "anyOf": [
+                      {
+                        "type": "number",
+                        "enum": [
+                          4
+                        ]
+                      },
+                      {
+                        "type": "number",
+                        "enum": [
+                          5
+                        ]
+                      },
+                      {
+                        "type": "number",
+                        "enum": [
+                          6
+                        ]
+                      },
+                      {
+                        "type": "number",
+                        "enum": [
+                          8
+                        ]
+                      },
+                      {
+                        "type": "number",
+                        "enum": [
+                          10
+                        ]
+                      }
+                    ]
+                  },
+                  "provider": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "kling_3_0"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "veo_3_1"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "seedance_pro"
+                        ]
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "credits"
+                  ],
+                  "properties": {
+                    "credits": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
           }
         }
       }
@@ -121892,6 +122815,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -121914,6 +122840,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -121936,6 +122865,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122018,6 +122950,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122040,6 +122975,34 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122069,6 +123032,31 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -122184,6 +123172,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122216,6 +123207,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122349,6 +123343,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122381,6 +123378,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122403,6 +123403,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122425,6 +123428,34 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122447,6 +123478,34 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122611,6 +123670,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -122633,6 +123695,9 @@
                     "error"
                   ],
                   "properties": {
+                    "code": {
+                      "type": "string"
+                    },
                     "error": {
                       "type": "string"
                     },
@@ -176863,7 +177928,7 @@
         "tags": [
           "reports"
         ],
-        "description": "Returns the current job status and, when COMPLETED, a freshly signed S3 download URL with its `expires_at` timestamp (~7 days). Access follows the current workspace for team-stamped runs; legacy runs without a team stamp remain original-owner only. The URL is regenerated on demand from the stored S3 key, so completed runs remain re-downloadable for the lifetime of the underlying object.",
+        "description": "Returns the current job status and, when COMPLETED, a freshly signed S3 download URL with its `expires_at` timestamp (~7 days). Accepts both on-demand exports and scheduled sends. Access follows the current workspace for team-stamped runs; legacy runs without a team stamp remain original-owner only. The URL is regenerated on demand from the stored S3 key, so completed runs remain re-downloadable for the lifetime of the underlying object.",
         "parameters": [
           {
             "schema": {
@@ -177000,7 +178065,7 @@
         "tags": [
           "reports"
         ],
-        "description": "Persistent history of recent PDF/CSV report exports visible to the authenticated caller, ordered newest first. Team-stamped runs follow current workspace access; legacy runs without a team stamp remain original-owner only. Reads worker_run rows joined on the enqueued worker_run_event metadata so the Download Center UI can re-hydrate after a page refresh without losing track of completed exports whose presigned URLs have already expired.",
+        "description": "Persistent history of recent PDF/CSV report exports visible to the authenticated caller, ordered newest first, covering both on-demand exports and scheduled sends. Team-stamped runs follow current workspace access; legacy runs without a team stamp remain original-owner only. Reads worker_run rows joined on the enqueued worker_run_event metadata so the Download Center UI can re-hydrate after a page refresh without losing track of completed exports whose presigned URLs have already expired.",
         "parameters": [
           {
             "schema": {
@@ -177046,7 +178111,9 @@
                           "to_date",
                           "created_at",
                           "completed_at",
-                          "error_message"
+                          "error_message",
+                          "origin",
+                          "retryable"
                         ],
                         "properties": {
                           "id": {
@@ -177153,6 +178220,27 @@
                                 "type": "null"
                               }
                             ]
+                          },
+                          "origin": {
+                            "description": "Who asked for this artifact: `on_demand` = the caller pressed Export; `scheduled` = a recurring send produced it. The UI must not treat a scheduled artifact as a download the user is waiting on.",
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "on_demand"
+                                ]
+                              },
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "scheduled"
+                                ]
+                              }
+                            ]
+                          },
+                          "retryable": {
+                            "description": "Whether POST /api/v1/reports/{id}/retry accepts this run. Only on-demand exports carry the stored request payload a retry replays; a scheduled send is re-run from its schedule instead.",
+                            "type": "boolean"
                           }
                         }
                       }
@@ -177247,6 +178335,8 @@
                           "recipients",
                           "format",
                           "ad_account_ids",
+                          "platforms",
+                          "period",
                           "is_active",
                           "last_run_at",
                           "next_run_at",
@@ -177364,6 +178454,54 @@
                               "type": "string"
                             }
                           },
+                          "platforms": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "period": {
+                            "anyOf": [
+                              {
+                                "description": "Rolling window recomputed at every run. Omitted/null falls back to the template period, else last 7 days.",
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "last7d"
+                                    ]
+                                  },
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "last14d"
+                                    ]
+                                  },
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "last30d"
+                                    ]
+                                  },
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "last90d"
+                                    ]
+                                  },
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "mtd"
+                                    ]
+                                  }
+                                ]
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
                           "is_active": {
                             "type": "boolean"
                           },
@@ -177428,6 +178566,33 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Scheduled reports are not enabled for this account.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Scheduled reports are not enabled for this account.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "FEATURE_DISABLED"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       },
@@ -177447,7 +178612,8 @@
                 "type": "object",
                 "required": [
                   "name",
-                  "frequency"
+                  "frequency",
+                  "recipients"
                 ],
                 "properties": {
                   "name": {
@@ -177518,6 +178684,9 @@
                     "type": "integer"
                   },
                   "recipients": {
+                    "minItems": 1,
+                    "maxItems": 10,
+                    "description": "Destination inboxes. Up to 10 on paid plans; lower plans are capped further and may be restricted to the owner's own address.",
                     "type": "array",
                     "items": {
                       "additionalProperties": false,
@@ -177554,12 +178723,66 @@
                     ]
                   },
                   "ad_account_ids": {
+                    "maxItems": 50,
+                    "description": "Ad accounts included in the export. Empty/omitted = every account in scope.",
                     "type": "array",
                     "items": {
                       "minLength": 1,
                       "type": "string"
                     }
                   },
+                  "platforms": {
+                    "maxItems": 10,
+                    "description": "Restricts the export to these ad platforms (meta, google, tiktok, taboola, snapchat, outbrain). Empty = every platform, and the export gains a Platform column.",
+                    "type": "array",
+                    "items": {
+                      "minLength": 1,
+                      "maxLength": 20,
+                      "type": "string"
+                    }
+                  },
+                  "period": {
+                    "anyOf": [
+                      {
+                        "description": "Rolling window recomputed at every run. Omitted/null falls back to the template period, else last 7 days.",
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "last7d"
+                            ]
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "last14d"
+                            ]
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "last30d"
+                            ]
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "last90d"
+                            ]
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "mtd"
+                            ]
+                          }
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
                   "is_active": {
                     "type": "boolean"
                   }
@@ -177606,6 +178829,8 @@
                     "recipients",
                     "format",
                     "ad_account_ids",
+                    "platforms",
+                    "period",
                     "is_active",
                     "last_run_at",
                     "next_run_at",
@@ -177723,6 +178948,54 @@
                         "type": "string"
                       }
                     },
+                    "platforms": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "period": {
+                      "anyOf": [
+                        {
+                          "description": "Rolling window recomputed at every run. Omitted/null falls back to the template period, else last 7 days.",
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last7d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last14d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last30d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last90d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "mtd"
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "is_active": {
                       "type": "boolean"
                     },
@@ -177801,6 +179074,29 @@
                           ]
                         }
                       }
+                    },
+                    {
+                      "description": "The request failed schema validation.",
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        }
+                      }
                     }
                   ]
                 }
@@ -177916,6 +179212,33 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Scheduled reports are not enabled for this account.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Scheduled reports are not enabled for this account.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "FEATURE_DISABLED"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -177975,6 +179298,8 @@
                     "recipients",
                     "format",
                     "ad_account_ids",
+                    "platforms",
+                    "period",
                     "is_active",
                     "last_run_at",
                     "next_run_at",
@@ -178092,6 +179417,54 @@
                         "type": "string"
                       }
                     },
+                    "platforms": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "period": {
+                      "anyOf": [
+                        {
+                          "description": "Rolling window recomputed at every run. Omitted/null falls back to the template period, else last 7 days.",
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last7d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last14d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last30d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last90d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "mtd"
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "is_active": {
                       "type": "boolean"
                     },
@@ -178171,6 +179544,33 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Scheduled reports are not enabled for this account.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Scheduled reports are not enabled for this account.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "FEATURE_DISABLED"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       },
@@ -178180,7 +179580,7 @@
         "tags": [
           "reports"
         ],
-        "description": "Partially updates the schedule. Any subset of mutable fields may be supplied. Recomputes `next_run_at` if cadence (frequency / day_of_week / day_of_month / hour_utc) changes. Returns 400 if `template_id` is reassigned to a template not owned by the session.",
+        "description": "Partially updates the schedule. Any subset of mutable fields may be supplied. Recomputes `next_run_at` if cadence (frequency / day_of_week / day_of_month / hour_utc) changes. Returns 400 if `template_id` is reassigned to a template not owned by the session. Responds 503 when scheduled reports are disabled for the caller, EXCEPT for a body of exactly `{\"is_active\": false}` - pausing your own sends is always allowed.",
         "requestBody": {
           "required": true,
           "content": {
@@ -178257,6 +179657,9 @@
                     "type": "integer"
                   },
                   "recipients": {
+                    "minItems": 1,
+                    "maxItems": 10,
+                    "description": "Destination inboxes. Up to 10 on paid plans; lower plans are capped further and may be restricted to the owner's own address.",
                     "type": "array",
                     "items": {
                       "additionalProperties": false,
@@ -178293,12 +179696,66 @@
                     ]
                   },
                   "ad_account_ids": {
+                    "maxItems": 50,
+                    "description": "Ad accounts included in the export. Empty/omitted = every account in scope.",
+                    "type": "array",
+                    "items": {
+                      "minLength": 1,
+                      "type": "string"
+                    }
+                  },
+                  "platforms": {
+                    "maxItems": 10,
+                    "description": "Restricts the export to these ad platforms (meta, google, tiktok, taboola, snapchat, outbrain). Empty = every platform, and the export gains a Platform column.",
                     "type": "array",
                     "items": {
                       "minLength": 1,
+                      "maxLength": 20,
                       "type": "string"
                     }
                   },
+                  "period": {
+                    "anyOf": [
+                      {
+                        "description": "Rolling window recomputed at every run. Omitted/null falls back to the template period, else last 7 days.",
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "last7d"
+                            ]
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "last14d"
+                            ]
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "last30d"
+                            ]
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "last90d"
+                            ]
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "mtd"
+                            ]
+                          }
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
                   "is_active": {
                     "type": "boolean"
                   }
@@ -178354,6 +179811,8 @@
                     "recipients",
                     "format",
                     "ad_account_ids",
+                    "platforms",
+                    "period",
                     "is_active",
                     "last_run_at",
                     "next_run_at",
@@ -178471,6 +179930,54 @@
                         "type": "string"
                       }
                     },
+                    "platforms": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "period": {
+                      "anyOf": [
+                        {
+                          "description": "Rolling window recomputed at every run. Omitted/null falls back to the template period, else last 7 days.",
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last7d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last14d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last30d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "last90d"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "mtd"
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "is_active": {
                       "type": "boolean"
                     },
@@ -178512,6 +180019,7 @@
                 "schema": {
                   "anyOf": [
                     {
+                      "additionalProperties": false,
                       "type": "object",
                       "required": [
                         "error"
@@ -178548,6 +180056,29 @@
                           ]
                         }
                       }
+                    },
+                    {
+                      "description": "The request failed schema validation.",
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        }
+                      }
                     }
                   ]
                 }
@@ -178617,6 +180148,33 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Scheduled reports are not enabled for this account.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Scheduled reports are not enabled for this account.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "FEATURE_DISABLED"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       },
@@ -178626,7 +180184,7 @@
         "tags": [
           "reports"
         ],
-        "description": "Marks the schedule as deleted (sets deleted_at) so the cron loop stops picking it up. Idempotent: returns 404 if the schedule was already deleted or never existed.",
+        "description": "Marks the schedule as deleted (sets deleted_at) so the cron loop stops picking it up. Idempotent: returns 404 if the schedule was already deleted or never existed. Not gated by the scheduled-reports feature flag: stopping your own sends must stay possible while the feature is switched off.",
         "parameters": [
           {
             "schema": {
@@ -178661,35 +180219,74 @@
             "description": "No content"
           },
           "400": {
-            "description": "Explicit destination workspace required: send the x-team-id header or activate a team scope for this operation.",
+            "description": "Invalid request - schema validation failed",
             "content": {
               "application/json": {
                 "schema": {
-                  "description": "Explicit destination workspace required: send the x-team-id header or activate a team scope for this operation.",
-                  "additionalProperties": false,
-                  "type": "object",
-                  "required": [
-                    "statusCode",
-                    "error",
-                    "message"
-                  ],
-                  "properties": {
-                    "statusCode": {
-                      "type": "number"
-                    },
-                    "error": {
-                      "type": "string"
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "error"
+                      ],
+                      "properties": {
+                        "error": {
+                          "type": "string"
+                        }
+                      }
                     },
-                    "message": {
-                      "type": "string"
+                    {
+                      "description": "Explicit destination workspace required: send the x-team-id header or activate a team scope for this operation.",
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string",
+                          "enum": [
+                            "SCOPE_TEAM_REQUIRED"
+                          ]
+                        }
+                      }
                     },
-                    "code": {
-                      "type": "string",
-                      "enum": [
-                        "SCOPE_TEAM_REQUIRED"
-                      ]
+                    {
+                      "description": "The request failed schema validation.",
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        }
+                      }
                     }
-                  }
+                  ]
                 }
               }
             }
@@ -178768,7 +180365,7 @@
         "tags": [
           "reports"
         ],
-        "description": "Enqueues a one-off GENERATE_SCHEDULED_REPORT job for the given schedule, bypassing the cron cadence. The job emails the artifact to the schedule recipients and records a manual-trigger audit event. Returns the canonical async-job envelope (worker_run_id mirrored as job_id).",
+        "description": "Enqueues a one-off GENERATE_SCHEDULED_REPORT job for the given schedule, bypassing the cron cadence. The job emails the artifact to the schedule recipients and records a manual-trigger audit event. Returns the canonical async-job envelope (worker_run_id mirrored as job_id). Rate limited to 5 calls per 1 hour per user: one call is a PDF render plus an email fan-out, not a download.",
         "parameters": [
           {
             "schema": {
@@ -178846,6 +180443,79 @@
               }
             }
           },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "error"
+                      ],
+                      "properties": {
+                        "error": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    {
+                      "description": "Explicit destination workspace required: send the x-team-id header or activate a team scope for this operation.",
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string",
+                          "enum": [
+                            "SCOPE_TEAM_REQUIRED"
+                          ]
+                        }
+                      }
+                    },
+                    {
+                      "description": "The request failed schema validation.",
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          },
           "401": {
             "description": "Unauthorized - missing or invalid bearer token",
             "content": {
@@ -178856,6 +180526,24 @@
               }
             }
           },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "404": {
             "description": "Resource not found",
             "content": {
@@ -178874,6 +180562,24 @@
               }
             }
           },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error",
             "content": {
@@ -178891,6 +180597,33 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Scheduled reports are not enabled for this account.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Scheduled reports are not enabled for this account.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "code"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "FEATURE_DISABLED"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }