@wevion/cli 1.0.3823 → 1.0.3826

package/openapi.json

@@ -5246,14 +5246,46 @@
         ]
       }
     },
-    "/api/v1/ads/{id}/edit-canonical": {
-      "post": {
-        "operationId": "postApiV1AdsByIdEditCanonical",
-        "summary": "Build an inline canonical campaign for the Edit Ad editor",
+    "/api/v1/ads/{adId}/name": {
+      "patch": {
+        "operationId": "renameAd",
+        "summary": "Rename an ad in-place",
         "tags": [
-          "ads"
+          "campaigns"
         ],
-        "description": "Resolves an existing ad (Meta, Snapchat, Taboola, Google, or TikTok — creative/item, ad set, campaign, account) and returns an `ads_only` canonical campaign prefilled for the campaign-creator pro mode editor. No `campaign_draft` row is created — the editor keeps the canonical inline and posts it back to `/edit-publish` when the user clicks Publish.",
+        "description": "Updates only the `name` field of a Meta ad (Graph API POST /<ad_id>). The creative is never touched: the existing way to change an ad's name was the creative editor, which re-sends the creative and can restart the learning phase on a delivering ad. Intended for the inline rename affordance in the ads list, so it is safe to wire to an optimistic update with rollback. Meta accepts 400 characters (measured 2026-09-12) and the schema rejects 401 rather than letting the call fail at Meta. Meta also allows one write per object every 30 seconds: this route renames one object per call, so a bulk version needs a spaced queue.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "name",
+                  "account_id"
+                ],
+                "properties": {
+                  "name": {
+                    "minLength": 1,
+                    "maxLength": 400,
+                    "type": "string"
+                  },
+                  "account_id": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "platform": {
+                    "type": "string",
+                    "enum": [
+                      "meta"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
         "parameters": [
           {
             "schema": {
@@ -5261,13 +5293,16 @@
               "type": "string"
             },
             "in": "path",
-            "name": "id",
+            "name": "adId",
             "required": true
           }
         ],
         "security": [
           {
             "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
           }
         ],
         "responses": {
@@ -5279,47 +5314,15 @@
                   "additionalProperties": false,
                   "type": "object",
                   "required": [
-                    "canonical",
-                    "platform"
+                    "ad_id",
+                    "name"
                   ],
                   "properties": {
-                    "canonical": {
-                      "$comment": "json-value",
-                      "description": "Arbitrary JSON value with nested arrays and objects."
+                    "ad_id": {
+                      "type": "string"
                     },
-                    "platform": {
-                      "anyOf": [
-                        {
-                          "type": "string",
-                          "enum": [
-                            "meta"
-                          ]
-                        },
-                        {
-                          "type": "string",
-                          "enum": [
-                            "snapchat"
-                          ]
-                        },
-                        {
-                          "type": "string",
-                          "enum": [
-                            "taboola"
-                          ]
-                        },
-                        {
-                          "type": "string",
-                          "enum": [
-                            "google"
-                          ]
-                        },
-                        {
-                          "type": "string",
-                          "enum": [
-                            "tiktok"
-                          ]
-                        }
-                      ]
+                    "name": {
+                      "type": "string"
                     }
                   }
                 }
@@ -5331,21 +5334,14 @@
             "content": {
               "application/json": {
                 "schema": {
+                  "additionalProperties": false,
                   "type": "object",
                   "required": [
-                    "error",
-                    "message",
-                    "statusCode"
+                    "error"
                   ],
                   "properties": {
                     "error": {
                       "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "type": "number"
                     }
                   }
                 }
@@ -5357,75 +5353,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "type": "number"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Resource not found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "type": "number"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "422": {
-            "description": "Unprocessable entity - semantic validation failed",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "type": "number"
-                    }
-                  }
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
               }
             }
@@ -5435,21 +5363,14 @@
             "content": {
               "application/json": {
                 "schema": {
+                  "additionalProperties": false,
                   "type": "object",
                   "required": [
-                    "error",
-                    "message",
-                    "statusCode"
+                    "error"
                   ],
                   "properties": {
                     "error": {
                       "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "type": "number"
                     }
                   }
                 }
@@ -5459,14 +5380,14 @@
         }
       }
     },
-    "/api/v1/adsets/{adsetId}/add-ad-canonical": {
+    "/api/v1/ads/{id}/edit-canonical": {
       "post": {
-        "operationId": "postApiV1AdsetsByAdsetIdAddAdCanonical",
-        "summary": "Build an inline empty-ad canonical campaign for the Add Ad editor",
+        "operationId": "postApiV1AdsByIdEditCanonical",
+        "summary": "Build an inline canonical campaign for the Edit Ad editor",
         "tags": [
           "ads"
         ],
-        "description": "Resolves an existing ad set (Meta, Snapchat, Taboola, Google, or TikTok — its parent campaign + account) and returns an `ads_only` canonical campaign with the campaign + ad set read-only and exactly one BLANK ad (no `platformId`) so the publish worker creates a brand-new ad under the reused campaign/ad set. No `campaign_draft` row is created — the editor keeps the canonical inline and posts it back to `/edit-publish`.",
+        "description": "Resolves an existing ad (Meta, Snapchat, Taboola, Google, or TikTok — creative/item, ad set, campaign, account) and returns an `ads_only` canonical campaign prefilled for the campaign-creator pro mode editor. No `campaign_draft` row is created — the editor keeps the canonical inline and posts it back to `/edit-publish` when the user clicks Publish.",
         "parameters": [
           {
             "schema": {
@@ -5474,7 +5395,7 @@
               "type": "string"
             },
             "in": "path",
-            "name": "adsetId",
+            "name": "id",
             "required": true
           }
         ],
@@ -5672,14 +5593,14 @@
         }
       }
     },
-    "/api/v1/campaigns/{campaignId}/add-adset-canonical": {
+    "/api/v1/adsets/{adsetId}/add-ad-canonical": {
       "post": {
-        "operationId": "postApiV1CampaignsByCampaignIdAddAdsetCanonical",
-        "summary": "Build an inline add-ad-set canonical campaign for the Add Ad Set editor",
+        "operationId": "postApiV1AdsetsByAdsetIdAddAdCanonical",
+        "summary": "Build an inline empty-ad canonical campaign for the Add Ad editor",
         "tags": [
           "ads"
         ],
-        "description": "Resolves an existing Meta campaign (its account + business + default page) and returns an `add_adset` canonical campaign with the campaign read-only and exactly one BRAND-NEW ad set (no `platformId`) carrying one BLANK ad, so the publish worker creates a new ad set under the live campaign. No `campaign_draft` row is created — the editor keeps the canonical inline and posts it back to `/campaigns/:campaignId/add-adset-publish`. Meta only.",
+        "description": "Resolves an existing ad set (Meta, Snapchat, Taboola, Google, or TikTok — its parent campaign + account) and returns an `ads_only` canonical campaign with the campaign + ad set read-only and exactly one BLANK ad (no `platformId`) so the publish worker creates a brand-new ad under the reused campaign/ad set. No `campaign_draft` row is created — the editor keeps the canonical inline and posts it back to `/edit-publish`.",
         "parameters": [
           {
             "schema": {
@@ -5687,7 +5608,7 @@
               "type": "string"
             },
             "in": "path",
-            "name": "campaignId",
+            "name": "adsetId",
             "required": true
           }
         ],
@@ -5714,9 +5635,37 @@
                       "description": "Arbitrary JSON value with nested arrays and objects."
                     },
                     "platform": {
-                      "type": "string",
-                      "enum": [
-                        "meta"
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "meta"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "snapchat"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "taboola"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "google"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "tiktok"
+                          ]
+                        }
                       ]
                     }
                   }
@@ -5857,14 +5806,14 @@
         }
       }
     },
-    "/api/v1/adsets/{adsetId}/duplicate-canonical": {
+    "/api/v1/campaigns/{campaignId}/add-adset-canonical": {
       "post": {
-        "operationId": "postApiV1AdsetsByAdsetIdDuplicateCanonical",
-        "summary": "Build an inline duplicate-ad-set canonical campaign for the editor",
+        "operationId": "postApiV1CampaignsByCampaignIdAddAdsetCanonical",
+        "summary": "Build an inline add-ad-set canonical campaign for the Add Ad Set editor",
         "tags": [
           "ads"
         ],
-        "description": "Reads an existing Meta ad set (and its ads) and returns an `add_adset` canonical campaign that DUPLICATES it: the parent campaign is reused (read-only) and the ad set + ads are BRAND-NEW (no platformId). The editor edits any field, then posts it back to /campaigns/:campaignId/add-adset-publish which CREATES the new ad set under the live campaign. Mirrors Meta duplicate→editor. No draft row. Meta only.",
+        "description": "Resolves an existing Meta campaign (its account + business + default page) and returns an `add_adset` canonical campaign with the campaign read-only and exactly one BRAND-NEW ad set (no `platformId`) carrying one BLANK ad, so the publish worker creates a new ad set under the live campaign. No `campaign_draft` row is created — the editor keeps the canonical inline and posts it back to `/campaigns/:campaignId/add-adset-publish`. Meta only.",
         "parameters": [
           {
             "schema": {
@@ -5872,7 +5821,7 @@
               "type": "string"
             },
             "in": "path",
-            "name": "adsetId",
+            "name": "campaignId",
             "required": true
           }
         ],
@@ -6038,32 +5987,217 @@
                 }
               }
             }
-          },
-          "503": {
-            "description": "Service unavailable",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "type": "number"
-                    }
-                  }
-                }
-              }
-            }
+          }
+        }
+      }
+    },
+    "/api/v1/adsets/{adsetId}/duplicate-canonical": {
+      "post": {
+        "operationId": "postApiV1AdsetsByAdsetIdDuplicateCanonical",
+        "summary": "Build an inline duplicate-ad-set canonical campaign for the editor",
+        "tags": [
+          "ads"
+        ],
+        "description": "Reads an existing Meta ad set (and its ads) and returns an `add_adset` canonical campaign that DUPLICATES it: the parent campaign is reused (read-only) and the ad set + ads are BRAND-NEW (no platformId). The editor edits any field, then posts it back to /campaigns/:campaignId/add-adset-publish which CREATES the new ad set under the live campaign. Mirrors Meta duplicate→editor. No draft row. Meta only.",
+        "parameters": [
+          {
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "in": "path",
+            "name": "adsetId",
+            "required": true
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "canonical",
+                    "platform"
+                  ],
+                  "properties": {
+                    "canonical": {
+                      "$comment": "json-value",
+                      "description": "Arbitrary JSON value with nested arrays and objects."
+                    },
+                    "platform": {
+                      "type": "string",
+                      "enum": [
+                        "meta"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Unprocessable entity - semantic validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -15958,7 +16092,9 @@
                           "last_request",
                           "expires_at",
                           "created_at",
-                          "updated_at"
+                          "updated_at",
+                          "team_id",
+                          "team_name"
                         ],
                         "properties": {
                           "id": {
@@ -16032,6 +16168,26 @@
                           },
                           "updated_at": {
                             "type": "string"
+                          },
+                          "team_id": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "team_name": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
                           }
                         }
                       }
@@ -16088,7 +16244,7 @@
         "tags": [
           "api-keys"
         ],
-        "description": "Generates a new M2M API key. The plain-text key is returned exactly ONCE.",
+        "description": "Generates a new M2M API key. The plain-text key is returned exactly ONCE. Send `x-team-id` (or an `x-active-scope: team:<id>`) to bind the key to a specific workspace. That binding is what an MCP session started with this key runs in, and it is echoed back as `team_id`. Without a declared scope the key is bound only when the caller has exactly one accessible workspace; otherwise `team_id` is null and no workspace is guessed.",
         "requestBody": {
           "required": true,
           "content": {
@@ -16145,7 +16301,8 @@
                     "prefix",
                     "permissions",
                     "expires_at",
-                    "created_at"
+                    "created_at",
+                    "team_id"
                   ],
                   "properties": {
                     "id": {
@@ -16206,6 +16363,16 @@
                     },
                     "created_at": {
                       "type": "string"
+                    },
+                    "team_id": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
                     }
                   }
                 }
@@ -16462,7 +16629,9 @@
                     "last_request",
                     "expires_at",
                     "created_at",
-                    "updated_at"
+                    "updated_at",
+                    "team_id",
+                    "team_name"
                   ],
                   "properties": {
                     "id": {
@@ -16536,6 +16705,26 @@
                     },
                     "updated_at": {
                       "type": "string"
+                    },
+                    "team_id": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "team_name": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
                     }
                   }
                 }
@@ -19418,6 +19607,31 @@
               }
             }
           },
+          "422": {
+            "description": "Unprocessable entity - semantic validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": true,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error",
             "content": {
@@ -47291,7 +47505,7 @@
         "tags": [
           "campaigns"
         ],
-        "description": "Creates a new campaign draft with the given name, ad account, and canonical campaign structure.",
+        "description": "Creates a new campaign draft with the given name, ad account, and canonical campaign structure. `adSets[].commentModerationFilter` is accepted only while the runtime flag `ad_comments_control_enabled` is on for the caller: with the flag off the field is DROPPED from the body and the draft is saved without it (no error — a save must not fail on a flag).",
         "requestBody": {
           "required": true,
           "content": {
@@ -49303,6 +49517,78 @@
                                     }
                                   ]
                                 },
+                                "commentModerationFilter": {
+                                  "anyOf": [
+                                    {
+                                      "description": "Meta ad-set comment moderation — who may comment on the ads of this ad set. One of: AD_DISABLED, AD_FOLLOWER, DEFAULT, FOLLOWED, FOLLOWER, FRIENDS, FRIENDS_AND_FOLLOWERS, FRIENDS_OF_FRIENDS, SUBSCRIBED, TAGGED. AD_DISABLED turns comments off (and hides the comments already there); DEFAULT lets everyone comment. Omit the field to leave the ad set as it is. Meta refuses to turn comments off on social issues, elections or politics ads.",
+                                      "anyOf": [
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "AD_DISABLED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "AD_FOLLOWER"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "DEFAULT"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FOLLOWED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FOLLOWER"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS_AND_FOLLOWERS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS_OF_FRIENDS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "SUBSCRIBED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "TAGGED"
+                                          ]
+                                        }
+                                      ]
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
                                 "customAudiences": {
                                   "anyOf": [
                                     {
@@ -49934,6 +50220,19 @@
                                             }
                                           ]
                                         },
+                                        "browsers": {
+                                          "anyOf": [
+                                            {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
                                         "countries": {
                                           "anyOf": [
                                             {
@@ -49947,6 +50246,19 @@
                                             }
                                           ]
                                         },
+                                        "desktopOs": {
+                                          "anyOf": [
+                                            {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
                                         "devicePlatforms": {
                                           "anyOf": [
                                             {
@@ -51708,7 +52020,7 @@
         "tags": [
           "campaigns"
         ],
-        "description": "Partially updates a campaign draft using deep merge, enabling auto-save of individual fields.",
+        "description": "Partially updates a campaign draft using deep merge, enabling auto-save of individual fields. `adSets[].commentModerationFilter` is accepted only while the runtime flag `ad_comments_control_enabled` is on for the caller: with the flag off the field is DROPPED from the body and the rest of the save goes through, so an auto-save never fails on a flag.",
         "requestBody": {
           "required": true,
           "content": {
@@ -53717,6 +54029,78 @@
                                     }
                                   ]
                                 },
+                                "commentModerationFilter": {
+                                  "anyOf": [
+                                    {
+                                      "description": "Meta ad-set comment moderation — who may comment on the ads of this ad set. One of: AD_DISABLED, AD_FOLLOWER, DEFAULT, FOLLOWED, FOLLOWER, FRIENDS, FRIENDS_AND_FOLLOWERS, FRIENDS_OF_FRIENDS, SUBSCRIBED, TAGGED. AD_DISABLED turns comments off (and hides the comments already there); DEFAULT lets everyone comment. Omit the field to leave the ad set as it is. Meta refuses to turn comments off on social issues, elections or politics ads.",
+                                      "anyOf": [
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "AD_DISABLED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "AD_FOLLOWER"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "DEFAULT"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FOLLOWED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FOLLOWER"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS_AND_FOLLOWERS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS_OF_FRIENDS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "SUBSCRIBED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "TAGGED"
+                                          ]
+                                        }
+                                      ]
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
                                 "customAudiences": {
                                   "anyOf": [
                                     {
@@ -54348,6 +54732,19 @@
                                             }
                                           ]
                                         },
+                                        "browsers": {
+                                          "anyOf": [
+                                            {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
                                         "countries": {
                                           "anyOf": [
                                             {
@@ -54361,6 +54758,19 @@
                                             }
                                           ]
                                         },
+                                        "desktopOs": {
+                                          "anyOf": [
+                                            {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
                                         "devicePlatforms": {
                                           "anyOf": [
                                             {
@@ -58032,6 +58442,78 @@
                                     }
                                   ]
                                 },
+                                "commentModerationFilter": {
+                                  "anyOf": [
+                                    {
+                                      "description": "Meta ad-set comment moderation — who may comment on the ads of this ad set. One of: AD_DISABLED, AD_FOLLOWER, DEFAULT, FOLLOWED, FOLLOWER, FRIENDS, FRIENDS_AND_FOLLOWERS, FRIENDS_OF_FRIENDS, SUBSCRIBED, TAGGED. AD_DISABLED turns comments off (and hides the comments already there); DEFAULT lets everyone comment. Omit the field to leave the ad set as it is. Meta refuses to turn comments off on social issues, elections or politics ads.",
+                                      "anyOf": [
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "AD_DISABLED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "AD_FOLLOWER"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "DEFAULT"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FOLLOWED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FOLLOWER"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS_AND_FOLLOWERS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS_OF_FRIENDS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "SUBSCRIBED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "TAGGED"
+                                          ]
+                                        }
+                                      ]
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
                                 "customAudiences": {
                                   "anyOf": [
                                     {
@@ -58663,6 +59145,19 @@
                                             }
                                           ]
                                         },
+                                        "browsers": {
+                                          "anyOf": [
+                                            {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
                                         "countries": {
                                           "anyOf": [
                                             {
@@ -58676,6 +59171,19 @@
                                             }
                                           ]
                                         },
+                                        "desktopOs": {
+                                          "anyOf": [
+                                            {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
                                         "devicePlatforms": {
                                           "anyOf": [
                                             {
@@ -66032,6 +66540,78 @@
                                     }
                                   ]
                                 },
+                                "commentModerationFilter": {
+                                  "anyOf": [
+                                    {
+                                      "description": "Meta ad-set comment moderation — who may comment on the ads of this ad set. One of: AD_DISABLED, AD_FOLLOWER, DEFAULT, FOLLOWED, FOLLOWER, FRIENDS, FRIENDS_AND_FOLLOWERS, FRIENDS_OF_FRIENDS, SUBSCRIBED, TAGGED. AD_DISABLED turns comments off (and hides the comments already there); DEFAULT lets everyone comment. Omit the field to leave the ad set as it is. Meta refuses to turn comments off on social issues, elections or politics ads.",
+                                      "anyOf": [
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "AD_DISABLED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "AD_FOLLOWER"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "DEFAULT"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FOLLOWED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FOLLOWER"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS_AND_FOLLOWERS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "FRIENDS_OF_FRIENDS"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "SUBSCRIBED"
+                                          ]
+                                        },
+                                        {
+                                          "type": "string",
+                                          "enum": [
+                                            "TAGGED"
+                                          ]
+                                        }
+                                      ]
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
                                 "customAudiences": {
                                   "anyOf": [
                                     {
@@ -66663,6 +67243,19 @@
                                             }
                                           ]
                                         },
+                                        "browsers": {
+                                          "anyOf": [
+                                            {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
                                         "countries": {
                                           "anyOf": [
                                             {
@@ -66676,6 +67269,19 @@
                                             }
                                           ]
                                         },
+                                        "desktopOs": {
+                                          "anyOf": [
+                                            {
+                                              "type": "array",
+                                              "items": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            {
+                                              "type": "null"
+                                            }
+                                          ]
+                                        },
                                         "devicePlatforms": {
                                           "anyOf": [
                                             {
@@ -90692,6 +91298,7 @@
                 "schema": {
                   "type": "object",
                   "required": [
+                    "currency",
                     "enabled",
                     "threshold",
                     "dropToThreshold",
@@ -90702,6 +91309,10 @@
                     "lastStatus"
                   ],
                   "properties": {
+                    "currency": {
+                      "maxLength": 3,
+                      "type": "string"
+                    },
                     "enabled": {
                       "type": "boolean"
                     },
@@ -90791,7 +91402,7 @@
         "tags": [
           "ai-chat"
         ],
-        "description": "Updates auto-recharge settings used to top up AI credits when balance drops below the threshold.",
+        "description": "Updates auto-recharge settings used to top up AI credits when balance drops below the threshold. Send the optional `currency` to declare which currency the monthly cap was entered in: the server answers 409 when it no longer matches the currency in force, instead of storing a figure that means a different amount. Omitting it keeps older clients working.",
         "requestBody": {
           "required": true,
           "content": {
@@ -90849,6 +91460,10 @@
                         "type": "null"
                       }
                     ]
+                  },
+                  "currency": {
+                    "maxLength": 3,
+                    "type": "string"
                   }
                 }
               }
@@ -90868,6 +91483,7 @@
                 "schema": {
                   "type": "object",
                   "required": [
+                    "currency",
                     "enabled",
                     "threshold",
                     "dropToThreshold",
@@ -90878,6 +91494,10 @@
                     "lastStatus"
                   ],
                   "properties": {
+                    "currency": {
+                      "maxLength": 3,
+                      "type": "string"
+                    },
                     "enabled": {
                       "type": "boolean"
                     },
@@ -91007,6 +91627,35 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Conflict - resource state prevents the operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "declared_currency",
+                    "current_currency"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "declared_currency": {
+                      "maxLength": 3,
+                      "type": "string"
+                    },
+                    "current_currency": {
+                      "maxLength": 3,
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -97257,10 +97906,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful response",
+            "description": "CSV file, one row per order. `X-Export-Truncated: true` when the filtered set exceeded the row cap.",
             "content": {
-              "application/json": {
+              "text/csv": {
                 "schema": {
+                  "description": "CSV file content.",
                   "type": "string"
                 }
               }
@@ -103933,6 +104583,176 @@
         }
       }
     },
+    "/api/v1/country-search": {
+      "get": {
+        "operationId": "getApiV1CountrySearch",
+        "summary": "List or search the countries Meta accepts for geo targeting",
+        "tags": [
+          "targeting"
+        ],
+        "description": "Proxies Meta Marketing API `search?type=adgeolocation&location_types=[\"country\"]`, returning the ISO alpha-2 codes accepted by `targeting.geo_locations.countries`. Meta owns the list, so it is queried live rather than mirrored in code — the hand-written list this replaces had drifted to 61 of the 247 codes Meta accepts, which is how a customer discovered Kazakhstan was missing. With `q` omitted Meta returns its COMPLETE list (247 countries as of 2026-09-12), small enough for the client to hold and filter locally; `q` is still accepted for narrower lookups. With `account_id` omitted the token is borrowed from any accessible ad account, so the surfaces that have no Meta account selected still get the list. `name` is a fallback: Meta answers in the language of the client's ad account and documents the field as subject to change, so the UI renders the label from `key`. `tiktok_geo_id` is present only for the codes TikTok has a GeoNames id for. Returns `degraded: true` with an empty list when no usable token exists or Meta is unreachable, so the caller can tell an outage from a query that matched nothing.",
+        "parameters": [
+          {
+            "schema": {
+              "maxLength": 100,
+              "type": "string"
+            },
+            "in": "query",
+            "name": "q",
+            "required": false,
+            "description": "Search query (e.g. \"kaz\"). Omit or leave empty to get Meta's complete country list."
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "query",
+            "name": "account_id",
+            "required": false,
+            "description": "Ad account whose Graph token is borrowed for the call. OPTIONAL, unlike the sibling locale-search route: the list Meta returns is its global one, identical for every account, and the callers that need it (the TikTok/Taboola launch surfaces) have no Meta account selected. Omit it and any accessible ad account with a usable token is used."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "degraded",
+                    "countries"
+                  ],
+                  "properties": {
+                    "degraded": {
+                      "description": "True when a Meta token existed but Meta could not be reached, so the list is the local snapshot rather than Meta's live answer. NOT true when `q` matched nothing, and NOT true when the workspace has no Meta token at all (a normal state for the TikTok/Google/Taboola surfaces, which get the snapshot without a warning). Lets the caller say \"showing the standard list\" instead of \"no results\".",
+                      "type": "boolean"
+                    },
+                    "countries": {
+                      "description": "Country list as Meta returns it (247 rows as of 2026-09-12). When Meta cannot be asked this is the local snapshot of that same list, whose `name` is the code itself — the UI renders labels from `key` with Intl.DisplayNames, so `name` is never read.",
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "key",
+                          "name"
+                        ],
+                        "properties": {
+                          "key": {
+                            "description": "ISO 3166-1 alpha-2 code, sent verbatim in targeting.geo_locations.countries",
+                            "type": "string"
+                          },
+                          "name": {
+                            "description": "Label as Meta returns it, a FALLBACK only. Measured 2026-09-12: with no `locale` parameter Meta answers in the language of the ad account belonging to the CLIENT (an Italian ad account returned Kazakistan, not Kazakhstan), and Meta documents `name` as subject to change. The UI renders the label from `key` with Intl.DisplayNames in the language of the user, and falls back to this value only when ICU has no name for the code.",
+                            "type": "string"
+                          },
+                          "tiktok_geo_id": {
+                            "description": "GeoNames id TikTok wants for this country, present only for the codes we have mapped. ABSENT (not null, not empty) when TikTok has no id: absence is the signal the TikTok surfaces read to know the country is not publishable there.",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "description": "HTTP status code",
+                      "type": "integer"
+                    },
+                    "error": {
+                      "description": "HTTP status text",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Human-readable reason",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "description": "HTTP status code",
+                      "type": "integer"
+                    },
+                    "error": {
+                      "description": "HTTP status text",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Human-readable reason",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "description": "HTTP status code",
+                      "type": "integer"
+                    },
+                    "error": {
+                      "description": "HTTP status text",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Human-readable reason",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/creative-ai-register": {
       "get": {
         "operationId": "creativeAiRegisterList",
@@ -104390,11 +105210,11 @@
         ],
         "responses": {
           "200": {
-            "description": "CSV file content",
+            "description": "CSV file with the register rows, newest first.",
             "content": {
-              "application/json": {
+              "text/csv": {
                 "schema": {
-                  "description": "CSV file content",
+                  "description": "CSV file content.",
                   "type": "string"
                 }
               }
@@ -114475,12 +115295,12 @@
     "/api/v1/creative-hub/image-creatives/generate": {
       "post": {
         "operationId": "creativeHubGenerateImageCreative",
-        "summary": "Generate static ad image creatives (async)",
+        "summary": "Generate ad image creatives",
         "tags": [
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Starts an asynchronous static ad creative generation. When brand_kit_id or product_id is provided, the selected team brand or product context is folded into the provider prompt. Up to 4 reference images can be supplied via reference_image_urls; product_image_url stays accepted as the first reference for back-compat. Supplying any reference switches the model from text-to-image (Seedream 4.5) to the reference-preserving Nano Banana Pro and is priced at that higher rate. brand_colors fold into the prompt as colour art direction.",
+        "description": "Generate 1 to 4 static ad images for a paid social campaign. The request carries a campaign objective (sales, awareness, traffic, leads) and at least one of: a product from the team's catalogue, a product description, or up to 4 reference images (reference_image_urls, with product_image_url accepted as the first one) that keep the real product in the scene. A Brand Kit and brand_colors are optional and add colour and tone. The server wraps that input in the ad brief it sends to a third-party image model. The credit cost per variant is held before the job starts (creativeHubEstimateImageCreative returns the exact amount). Returns a generation id to poll with creativeHubGetImageCreativeGeneration. Finished images are saved to the team's Asset Library and can be filed into a Files folder with creativeHubMoveAssets.",
         "requestBody": {
           "required": true,
           "content": {
@@ -114874,7 +115694,7 @@
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Returns the deterministic credit hold estimate for an image creative generation. Supplying any reference image (reference_image_urls or product_image_url) raises the estimate to the reference-preserving model rate.",
+        "description": "Returns the deterministic credit hold estimate for an image creative generation: the exact amount creativeHubGenerateImageCreative holds before the job starts, for the given number of variants and reference images, at the price list in force. Performs no I/O and charges nothing.",
         "requestBody": {
           "required": true,
           "content": {
@@ -115193,12 +116013,6 @@
                                   "ai_chat_credits_estimated": {
                                     "type": "number"
                                   },
-                                  "higgsfield_credits_actual": {
-                                    "type": "number"
-                                  },
-                                  "higgsfield_credits_estimated": {
-                                    "type": "number"
-                                  },
                                   "items": {
                                     "type": "array",
                                     "items": {
@@ -115207,8 +116021,6 @@
                                       "required": [
                                         "model_id",
                                         "provider",
-                                        "provider_cents_per_unit",
-                                        "provider_cost_cents_estimated",
                                         "retail_credits",
                                         "retail_credits_per_unit",
                                         "unit",
@@ -115221,12 +116033,6 @@
                                         "provider": {
                                           "type": "string"
                                         },
-                                        "provider_cents_per_unit": {
-                                          "type": "number"
-                                        },
-                                        "provider_cost_cents_estimated": {
-                                          "type": "number"
-                                        },
                                         "retail_credits": {
                                           "type": "number"
                                         },
@@ -115254,30 +116060,9 @@
                                   "model_units_estimated": {
                                     "type": "number"
                                   },
-                                  "pricing_version": {
-                                    "type": "string"
-                                  },
                                   "provider": {
                                     "type": "string"
                                   },
-                                  "provider_cents_per_unit": {
-                                    "type": "number"
-                                  },
-                                  "provider_cost_cents_actual": {
-                                    "type": "number"
-                                  },
-                                  "provider_cost_cents_estimated": {
-                                    "type": "number"
-                                  },
-                                  "provider_credits_actual": {
-                                    "type": "number"
-                                  },
-                                  "provider_credits_estimated": {
-                                    "type": "number"
-                                  },
-                                  "retail_credits_per_higgsfield_credit": {
-                                    "type": "number"
-                                  },
                                   "retail_credits_per_unit": {
                                     "type": "number"
                                   },
@@ -115312,9 +116097,6 @@
                                   }
                                 ]
                               },
-                              "estimated_cost_cents": {
-                                "type": "number"
-                              },
                               "format": {
                                 "anyOf": [
                                   {
@@ -115349,9 +116131,6 @@
                                   }
                                 ]
                               },
-                              "frame_prompt": {
-                                "type": "string"
-                              },
                               "language": {
                                 "type": "string"
                               },
@@ -115655,12 +116434,6 @@
                             "ai_chat_credits_estimated": {
                               "type": "number"
                             },
-                            "higgsfield_credits_actual": {
-                              "type": "number"
-                            },
-                            "higgsfield_credits_estimated": {
-                              "type": "number"
-                            },
                             "items": {
                               "type": "array",
                               "items": {
@@ -115669,8 +116442,6 @@
                                 "required": [
                                   "model_id",
                                   "provider",
-                                  "provider_cents_per_unit",
-                                  "provider_cost_cents_estimated",
                                   "retail_credits",
                                   "retail_credits_per_unit",
                                   "unit",
@@ -115683,12 +116454,6 @@
                                   "provider": {
                                     "type": "string"
                                   },
-                                  "provider_cents_per_unit": {
-                                    "type": "number"
-                                  },
-                                  "provider_cost_cents_estimated": {
-                                    "type": "number"
-                                  },
                                   "retail_credits": {
                                     "type": "number"
                                   },
@@ -115716,30 +116481,9 @@
                             "model_units_estimated": {
                               "type": "number"
                             },
-                            "pricing_version": {
-                              "type": "string"
-                            },
                             "provider": {
                               "type": "string"
                             },
-                            "provider_cents_per_unit": {
-                              "type": "number"
-                            },
-                            "provider_cost_cents_actual": {
-                              "type": "number"
-                            },
-                            "provider_cost_cents_estimated": {
-                              "type": "number"
-                            },
-                            "provider_credits_actual": {
-                              "type": "number"
-                            },
-                            "provider_credits_estimated": {
-                              "type": "number"
-                            },
-                            "retail_credits_per_higgsfield_credit": {
-                              "type": "number"
-                            },
                             "retail_credits_per_unit": {
                               "type": "number"
                             },
@@ -115774,9 +116518,6 @@
                             }
                           ]
                         },
-                        "estimated_cost_cents": {
-                          "type": "number"
-                        },
                         "format": {
                           "anyOf": [
                             {
@@ -115811,9 +116552,6 @@
                             }
                           ]
                         },
-                        "frame_prompt": {
-                          "type": "string"
-                        },
                         "language": {
                           "type": "string"
                         },
@@ -115943,7 +116681,7 @@
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Soft-deletes one terminal image creative generation and its generated assets. Queued or processing generations cannot be deleted from the UI until they finish.",
+        "description": "Soft-deletes one terminal image creative generation and its generated assets. Queued or processing generations cannot be deleted until they finish.",
         "parameters": [
           {
             "schema": {
@@ -116141,12 +116879,12 @@
     "/api/v1/creative-hub/image-studio/generate": {
       "post": {
         "operationId": "creativeHubGenerateCinematicImage",
-        "summary": "Generate a cinematic image (async)",
+        "summary": "Generate cinematic images (async)",
         "tags": [
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Starts an asynchronous cinematic image generation and returns the queued generation metadata for polling. When one or more reference images are supplied (reference_image_url and/or reference_image_urls, capped at 4) the generation runs in image-to-image mode and is priced accordingly.",
+        "description": "Generate 1 to 4 cinematic images from a free-text prompt (up to 4,000 characters) with an optional style preset (photorealistic, cinematic, product), aspect ratio, resolution (720p or 1080p) and up to 4 reference images for image-to-image (reference_image_url and/or reference_image_urls). A Brand Kit or brand_colors add colour art direction to the prompt. Without a reference image the style selects the third-party image model the job runs on, so the price per variant changes per style. With any reference image the job runs on the reference-preserving model whatever the style, at that model's own price per variant. The amount is held before the job starts (creativeHubEstimateCinematicImage returns the exact amount for a style, resolution and reference set). Returns a generation id to poll with creativeHubGetCinematicImageGeneration; finished images are saved to the team's Asset Library.",
         "requestBody": {
           "required": true,
           "content": {
@@ -116274,7 +117012,6 @@
                   "required": [
                     "created_at",
                     "credits_estimated",
-                    "estimated_cost_cents",
                     "generation_id",
                     "polling_interval_ms",
                     "status"
@@ -116286,9 +117023,6 @@
                     "credits_estimated": {
                       "type": "integer"
                     },
-                    "estimated_cost_cents": {
-                      "type": "number"
-                    },
                     "generation_id": {
                       "type": "string"
                     },
@@ -116848,16 +117582,6 @@
                             "additionalProperties": false,
                             "type": "object",
                             "properties": {
-                              "prompt": {
-                                "anyOf": [
-                                  {
-                                    "type": "string"
-                                  },
-                                  {
-                                    "type": "null"
-                                  }
-                                ]
-                              },
                               "style": {
                                 "anyOf": [
                                   {
@@ -116921,9 +117645,6 @@
                                   }
                                 ]
                               },
-                              "estimated_cost_cents": {
-                                "type": "number"
-                              },
                               "num_variants": {
                                 "type": "integer"
                               },
@@ -117268,16 +117989,6 @@
                       "additionalProperties": false,
                       "type": "object",
                       "properties": {
-                        "prompt": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
                         "style": {
                           "anyOf": [
                             {
@@ -117341,9 +118052,6 @@
                             }
                           ]
                         },
-                        "estimated_cost_cents": {
-                          "type": "number"
-                        },
                         "num_variants": {
                           "type": "integer"
                         },
@@ -122026,7 +122734,7 @@
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Returns the credit estimate for burning subtitles into a video (transcription is billed per second). Pass asset_id to price an uploaded team video asset: when that asset carries a recorded duration the estimate reads it, which is the same value the generation hold uses. Otherwise the estimate echoes the declared duration_seconds — asset_id never turns a successful estimate into an error.",
+        "description": "Returns the credit estimate for burning subtitles into a video (transcription is billed per second). With asset_id the estimate uses the duration recorded on that team video asset when there is one, which is the same value the generation hold uses; otherwise it uses the duration_seconds you declare. Charges nothing and holds nothing.",
         "parameters": [
           {
             "schema": {
@@ -122121,12 +122829,12 @@
     "/api/v1/creative-hub/subtitles/generate": {
       "post": {
         "operationId": "creativeHubGenerateSubtitles",
-        "summary": "Burn subtitles into an uploaded video",
+        "summary": "Add burned-in subtitles to a library video",
         "tags": [
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Starts an asynchronous subtitle generation for a team video asset: the audio track is transcribed with Whisper, optionally translated to the requested language, and burned into the video. Returns a polling handle for GET /creative-hub/generations/{id}.",
+        "description": "Transcribe the audio of a video already in the team's Asset Library (asset_id, up to 10 minutes) with a speech-to-text model, optionally translate the captions to the requested language, and burn them into a new copy of the video with the chosen text colour and position. No new footage is generated: the copy keeps the source video's AI classification. Charges per second of video, with a minimum charge per job, at the current price list. The amount is held on the duration recorded on the asset when it has one and on the duration_seconds you declare otherwise, and settled on the duration measured during transcription, which can be more than the amount held; creativeHubEstimateSubtitles returns the exact amount. Poll with creativeHubGetGenerationStatus; the subtitled video is saved as a new asset next to the original.",
         "requestBody": {
           "required": true,
           "content": {
@@ -122397,7 +123105,7 @@
         "tags": [
           "creative-hub"
         ],
-        "description": "Returns spendable AI credits for Creative Hub generation, including purchased credits and weekly grant credits.",
+        "description": "Returns the AI credits available for Creative Hub generation: the purchased balance, the grant balance, the spendable total of the two, the credits already used and the monthly cap when one is set.",
         "security": [
           {
             "bearerAuth": []
@@ -122419,7 +123127,6 @@
                     "monthly_cap",
                     "monthly_used",
                     "spendable",
-                    "total_purchased",
                     "total_used"
                   ],
                   "properties": {
@@ -122445,9 +123152,6 @@
                     "spendable": {
                       "type": "number"
                     },
-                    "total_purchased": {
-                      "type": "number"
-                    },
                     "total_used": {
                       "type": "number"
                     }
@@ -122867,12 +123571,12 @@
     "/api/v1/creative-hub/ugc/models": {
       "get": {
         "operationId": "creativeHubListUgcModels",
-        "summary": "List available UGC avatar/lip-sync models and Marketing Studio generation modes",
+        "summary": "List available UGC avatar/lip-sync models and generation modes",
         "tags": [
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Returns the curated UGC avatar/lip-sync model choices and the hardcoded Higgsfield Marketing Studio `mode` catalog (talking head, product review, how-to, unboxing, showcase) available to the composer.",
+        "description": "Returns the curated UGC avatar/lip-sync model choices and the generation `mode` catalog (talking head, product review, how-to, unboxing, showcase) available to the composer.",
         "security": [
           {
             "bearerAuth": []
@@ -122973,12 +123677,12 @@
     "/api/v1/creative-hub/ugc/generate": {
       "post": {
         "operationId": "creativeHubGenerateUgc",
-        "summary": "Generate a UGC video (async)",
+        "summary": "Generate a UGC ad video",
         "tags": [
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Starts an asynchronous UGC video generation. When brand_kit_id is provided, the selected team Brand Kit is folded into the script, frame and motion prompt context.",
+        "description": "Generate a 3 to 15 second creator-style ad video for Meta, TikTok, Instagram or YouTube. Input: your own script (mode your_script), a script the server writes from a catalog product, a hook and the Brand Kit (mode ai_script), or a product photo held in frame (mode product_hand), plus a synthetic presenter avatar (avatar_id) from the Wevion library or the team's own avatars. The job renders on a third-party video model with lip-sync. Charges a start-frame fee plus a per-billable-second rate (8 to 15 s; the per-second rate is multiplied by 0.7 at 480p and by 2 at 1080p), plus small fees for the AI script, the product photo and captions, all at the current price list and held before the job starts (creativeHubEstimateUgc returns the exact amount and its ceiling). Returns a generation id to poll with creativeHubGetUgcGeneration; the video is saved to the team's Asset Library.",
         "requestBody": {
           "required": true,
           "content": {
@@ -123211,7 +123915,6 @@
                   "required": [
                     "created_at",
                     "credits_estimated",
-                    "estimated_cost_cents",
                     "generation_id",
                     "polling_interval_ms",
                     "status"
@@ -123223,9 +123926,6 @@
                     "credits_estimated": {
                       "type": "integer"
                     },
-                    "estimated_cost_cents": {
-                      "type": "integer"
-                    },
                     "generation_id": {
                       "type": "string"
                     },
@@ -123419,7 +124119,7 @@
           "creative-hub",
           "creative-generation"
         ],
-        "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 — and in that case credits_max is the ceiling the charge can never exceed for this request, so the guaranteed invariant is credits <= charged <= credits_max. script_word_count_declared says which of the two you are looking at.",
+        "description": "Returns the deterministic credit estimate for a UGC generation, from the same billing input the generate endpoint charges from. With script_word_count and has_product_image supplied, credits is the exact charge; otherwise it is a floor and credits_max the ceiling the charge never exceeds. No I/O.",
         "requestBody": {
           "required": true,
           "content": {
@@ -123527,8 +124227,7 @@
                     "breakdown",
                     "billable_seconds",
                     "duration_source",
-                    "resolution_multiplier",
-                    "pricing_version"
+                    "resolution_multiplier"
                   ],
                   "properties": {
                     "credits": {
@@ -123594,9 +124293,6 @@
                     },
                     "resolution_multiplier": {
                       "type": "number"
-                    },
-                    "pricing_version": {
-                      "type": "string"
                     }
                   }
                 }
@@ -124667,12 +125363,12 @@
     "/api/v1/creative-hub/video-studio/generate": {
       "post": {
         "operationId": "creativeHubGenerateCinematicVideo",
-        "summary": "Generate a cinematic video clip (async)",
+        "summary": "Animate an image into a campaign video clip",
         "tags": [
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Starts an asynchronous cinematic image-to-video generation. BREAKING: a start-frame image_url is now REQUIRED for every provider and text-to-video is no longer supported. An optional end_image_url closes the clip on a second frame (accepted by the provider for kling3_0; how faithfully each model honours it is DA CONFERMARE). Returns queued generation metadata for polling. The resolution field was removed: provider output resolution is fixed and not configurable via the Higgsfield CLI (DA CONFERMARE in staging).",
+        "description": "Turn a start-frame image (image_url, required) into a 4 to 10 second campaign video clip from a scene description (prompt), an aspect ratio and an optional end-frame image (end_image_url) the clip closes on. Text-to-video is not supported. The provider field selects one of three third-party video models, each with its own durations and its own per-second price, in the order the enum lists them: 5 or 10 s (default), then 4, 6 or 8 s, then 5 or 10 s. The price comes from the current price list and is held before the job starts (creativeHubEstimateCinematicVideo returns the exact amount for a provider and duration). Both frames are confirmed end to end only on the first provider in the enum; on the other two they are sent to the model but their handling is not verified yet. Output resolution is fixed by the model. Returns a generation id to poll with creativeHubGetCinematicVideoGeneration; the clip is saved to the team's Asset Library.",
         "requestBody": {
           "required": true,
           "content": {
@@ -124818,7 +125514,6 @@
                   "required": [
                     "created_at",
                     "credits_estimated",
-                    "estimated_cost_cents",
                     "generation_id",
                     "polling_interval_ms",
                     "status"
@@ -124830,9 +125525,6 @@
                     "credits_estimated": {
                       "type": "integer"
                     },
-                    "estimated_cost_cents": {
-                      "type": "number"
-                    },
                     "generation_id": {
                       "type": "string"
                     },
@@ -126876,12 +127568,12 @@
     "/api/v1/creative-hub/generations/{id}": {
       "get": {
         "operationId": "creativeHubGetGenerationStatus",
-        "summary": "Get Creative Hub generation status",
+        "summary": "Get voiceover, avatar or subtitle generation status",
         "tags": [
           "creative-hub",
           "creative-generation"
         ],
-        "description": "Returns polling status for a Creative Hub voiceover or avatar generation and includes generated asset URLs once completed.",
+        "description": "Return the status of a voiceover, avatar or subtitle generation started by the team (queued, processing, completed, failed), the credits charged and, once completed, the URLs of the resulting assets in the team's Asset Library. Read only, and limited to those three: image creatives, cinematic images, cinematic videos and UGC videos are not served here, each has its own detail operation.",
         "parameters": [
           {
             "schema": {
@@ -131785,6 +132477,172 @@
         }
       }
     },
+    "/api/v1/device-behavior-search": {
+      "get": {
+        "operationId": "getApiV1DeviceBehaviorSearch",
+        "summary": "List the Meta behaviors for desktop OS and browser targeting",
+        "tags": [
+          "targeting"
+        ],
+        "description": "Proxies Meta Marketing API `search?type=adTargetingCategory&class=behaviors` and keeps only the two \"Digital activities\" folders Ads Manager uses for device targeting: \"Operating System Used\" (Windows 10, Mac OS X, …) and \"Internet Browser Used\" (Chrome, Safari, Microsoft Edge, …). Meta has no first-class targeting field for desktop OS or browser (`user_os` is mobile-only), so these go into `targeting.flexible_spec` as behaviors; the IDs returned here are what the ad-set `desktop_os` / `browsers` fields accept. Meta owns the list, so it is queried live rather than mirrored in code. With `account_id` omitted the token is borrowed from any accessible ad account. Returns `degraded: true` with empty lists when no usable token exists or Meta is unreachable, so the caller can tell an outage from an empty folder.",
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "query",
+            "name": "account_id",
+            "required": false,
+            "description": "Ad account whose Graph token is borrowed for the call. Optional: the list Meta returns is its global one, identical for every account. Omit it and any accessible ad account with a usable token is used (the bulk grid has an account per row, not per page)."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "degraded",
+                    "browsers",
+                    "operating_systems"
+                  ],
+                  "properties": {
+                    "degraded": {
+                      "type": "boolean"
+                    },
+                    "browsers": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "id",
+                          "name"
+                        ],
+                        "properties": {
+                          "id": {
+                            "description": "Meta behavior ID, sent verbatim in targeting.flexible_spec[].behaviors[].id",
+                            "type": "string"
+                          },
+                          "name": {
+                            "description": "Display name as Meta returns it, e.g. \"Facebook access (OS): Windows 10\"",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    },
+                    "operating_systems": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "id",
+                          "name"
+                        ],
+                        "properties": {
+                          "id": {
+                            "description": "Meta behavior ID, sent verbatim in targeting.flexible_spec[].behaviors[].id",
+                            "type": "string"
+                          },
+                          "name": {
+                            "description": "Display name as Meta returns it, e.g. \"Facebook access (OS): Windows 10\"",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/device-push/register": {
       "post": {
         "operationId": "registerDevicePushToken",
@@ -150648,11 +151506,39 @@
               }
             }
           },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "404": {
-            "description": "Resource not found",
+            "description": "The selected Meta token could not be resolved in the active workspace. `code` says which of the three: TOKEN_UNKNOWN (the row no longer exists - reselect the connection), TOKEN_OUT_OF_SCOPE (it belongs to another workspace), SCOPE_UNRESOLVED (the caller workspace could not be determined). Absent when the 404 is a rejected `x-team-id` scope instead.",
             "content": {
               "application/json": {
                 "schema": {
+                  "additionalProperties": false,
+                  "description": "The selected Meta token could not be resolved in the active workspace. `code` says which of the three: TOKEN_UNKNOWN (the row no longer exists - reselect the connection), TOKEN_OUT_OF_SCOPE (it belongs to another workspace), SCOPE_UNRESOLVED (the caller workspace could not be determined). Absent when the 404 is a rejected `x-team-id` scope instead.",
                   "type": "object",
                   "required": [
                     "statusCode",
@@ -150668,6 +151554,28 @@
                     },
                     "message": {
                       "type": "string"
+                    },
+                    "code": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "TOKEN_UNKNOWN"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "TOKEN_OUT_OF_SCOPE"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "SCOPE_UNRESOLVED"
+                          ]
+                        }
+                      ]
                     }
                   }
                 }
@@ -156358,6 +157266,256 @@
         ]
       }
     },
+    "/api/v1/meta/lead-forms/{form_id}/leads": {
+      "get": {
+        "operationId": "getApiV1MetaLeadFormsByFormIdLeads",
+        "summary": "List the leads collected by a Meta Instant Form",
+        "tags": [
+          "meta"
+        ],
+        "description": "Reads the answers a form has collected (`GET /{form_id}/leads`) so they can be seen in Wevion instead of only in the Meta Lead Center. The Page access token is resolved server-side from the connected Page; the caller never handles Meta tokens. Paging is by cursor: pass the `after` returned by the previous call. Requires the `leads_retrieval` permission on the Page token — without it Meta refuses and the refusal is returned as 422, never as an empty list.",
+        "parameters": [
+          {
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "in": "query",
+            "name": "page_id",
+            "required": true,
+            "description": "Page that owns the form; resolves the Page token."
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "query",
+            "name": "after",
+            "required": false,
+            "description": "Cursor from the previous page."
+          },
+          {
+            "schema": {
+              "minimum": 1,
+              "maximum": 500,
+              "default": 100,
+              "type": "integer"
+            },
+            "in": "query",
+            "name": "limit",
+            "required": false
+          },
+          {
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "in": "path",
+            "name": "form_id",
+            "required": true,
+            "description": "Meta leadgen form id."
+          },
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Explicit team (workspace) scope: a team.id the caller belongs to."
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-active-scope",
+            "required": false,
+            "description": "Active scope selector in `<scopeType>:<uuid>` form, e.g. `organization:<organization_id>` or `team:<team_id>`. Omit the header for the all-workspaces view."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "One page of leads collected by the form.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "One page of leads collected by the form.",
+                  "type": "object",
+                  "required": [
+                    "leads",
+                    "after"
+                  ],
+                  "properties": {
+                    "leads": {
+                      "type": "array",
+                      "items": {
+                        "additionalProperties": false,
+                        "type": "object",
+                        "required": [
+                          "id",
+                          "created_time",
+                          "fields"
+                        ],
+                        "properties": {
+                          "id": {
+                            "description": "Meta lead id.",
+                            "type": "string"
+                          },
+                          "created_time": {
+                            "description": "When the person submitted the form.",
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "fields": {
+                            "description": "Answers in the order the form asks them; the key is the question key on Meta.",
+                            "type": "array",
+                            "items": {
+                              "additionalProperties": false,
+                              "type": "object",
+                              "required": [
+                                "name",
+                                "value"
+                              ],
+                              "properties": {
+                                "name": {
+                                  "type": "string"
+                                },
+                                "value": {
+                                  "type": "string"
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "after": {
+                      "description": "Cursor for the next page, null when this is the last one.",
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "The Page is not connected to the caller team.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The Page is not connected to the caller team.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Meta refused the read: missing leads_retrieval permission, unknown form, and similar.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Meta refused the read: missing leads_retrieval permission, unknown form, and similar.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Unexpected server error.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Unexpected server error.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/v1/meta/users/deactivate": {
       "post": {
         "operationId": "postApiV1MetaUsersDeactivate",
@@ -159194,6 +160352,12 @@
                                 "enum": [
                                   "adset"
                                 ]
+                              },
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "ad"
+                                ]
                               }
                             ]
                           },
@@ -159350,6 +160514,12 @@
                   "enum": [
                     "adset"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "ad"
+                  ]
                 }
               ]
             },
@@ -159488,6 +160658,12 @@
                   "enum": [
                     "adset"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "ad"
+                  ]
                 }
               ]
             },
@@ -159606,6 +160782,12 @@
                         "enum": [
                           "adset"
                         ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "ad"
+                        ]
                       }
                     ]
                   }
@@ -173631,7 +174813,7 @@
         "tags": [
           "partner"
         ],
-        "description": "Assegna uno slug vanity nuovo e ritira il precedente. Gli alias sono STORICIZZATI e mai riassegnati: i link già pubblicati continuano a funzionare e la loro attribuzione non cambia. 409 quando lo slug non è assegnabile o quando le rinomine concesse nella finestra di 12 mesi sono esaurite.",
+        "description": "Assegna uno slug vanity nuovo; il precedente smette di essere il primario e continua a risolvere. Gli alias sono STORICIZZATI e mai riassegnati: i link già pubblicati continuano a funzionare e la loro attribuzione non cambia. 409 quando lo slug non è assegnabile — anche quando a prenderlo è stata una richiesta concorrente — o quando le rinomine concesse nella finestra di 12 mesi sono esaurite.",
         "requestBody": {
           "required": true,
           "content": {
@@ -245716,7 +246898,7 @@
         "tags": [
           "smm"
         ],
-        "description": "Publishes the given content to the selected connected accounts and returns a per-account outcome. When postId is provided, persists the outcomes and final status on that existing team post.",
+        "description": "Publishes the given content to the selected connected accounts and returns a per-account outcome. When postId is provided, persists the outcomes and final status on that existing team post. A post whose approval workflow blocks it (approval_status pending or rejected) is refused with 409 and is never sent to the platforms; a post with no approval_status (the teams that do not use the approval workflow) publishes normally.",
         "requestBody": {
           "required": true,
           "content": {
@@ -245855,6 +247037,25 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Conflict - resource state prevents the operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -259082,10 +260283,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful response",
+            "description": "CSV file with the active blacklist entries.",
             "content": {
-              "application/json": {
+              "text/csv": {
                 "schema": {
+                  "description": "CSV file content.",
                   "type": "string"
                 }
               }
@@ -264479,10 +265681,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful response",
+            "description": "CSV file with the matching click rows.",
             "content": {
-              "application/json": {
+              "text/csv": {
                 "schema": {
+                  "description": "CSV file content.",
                   "type": "string"
                 }
               }
@@ -265692,10 +266895,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful response",
+            "description": "CSV file with the matching conversions.",
             "content": {
-              "application/json": {
+              "text/csv": {
                 "schema": {
+                  "description": "CSV file content.",
                   "type": "string"
                 }
               }
@@ -274195,10 +275399,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful response",
+            "description": "CSV file with the form leads; columns are dynamic.",
             "content": {
-              "application/json": {
+              "text/csv": {
                 "schema": {
+                  "description": "CSV file content.",
                   "type": "string"
                 }
               }
@@ -279837,10 +281042,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Successful response",
+            "description": "CSV file with the matching leads; columns are dynamic.",
             "content": {
-              "application/json": {
+              "text/csv": {
                 "schema": {
+                  "description": "CSV file content.",
                   "type": "string"
                 }
               }
@@ -317848,7 +319054,7 @@
         "tags": [
           "bulk-launch"
         ],
-        "description": "Accepts a full campaign payload built by the frontend campaign creator and dispatches the launch as an asynchronous job processed by the bulk-launch SQS workers, stamped with the ACTIVE workspace team (`x-team-id` / team scope required — 400 `SCOPE_TEAM_REQUIRED` otherwise). Every referenced resource (ad account, fan page, pixel) must belong to the active workspace or the dispatch is rejected with 403 `RESOURCE_NOT_IN_ACTIVE_WORKSPACE`. Returns the worker_run_id that must be used to poll for progress via /api/v1/bulk-launch/status/:workerRunId.",
+        "description": "Accepts a full campaign payload built by the frontend campaign creator and dispatches the launch as an asynchronous job processed by the bulk-launch SQS workers, stamped with the ACTIVE workspace team (`x-team-id` / team scope required — 400 `SCOPE_TEAM_REQUIRED` otherwise). Every referenced resource (ad account, fan page, pixel) must belong to the active workspace or the dispatch is rejected with 403 `RESOURCE_NOT_IN_ACTIVE_WORKSPACE`. Returns the worker_run_id that must be used to poll for progress via /api/v1/bulk-launch/status/:workerRunId. The payload may carry `comment_moderation_filter` (Meta `brand_safety_config`, written at AD-SET level on every ad set this launch creates) to disable or restrict comments; the field is behind the runtime flag `ad_comments_control_enabled` and a payload that carries it is rejected with 503 `FEATURE_DISABLED`, naming the offending paths, when the flag is off for the caller. A payload without the field is unaffected.",
         "requestBody": {
           "required": true,
           "content": {
@@ -318717,6 +319923,71 @@
                     "items": {
                       "type": "string"
                     }
+                  },
+                  "comment_moderation_filter": {
+                    "description": "Meta ad-set comment moderation — who may comment on the ads of this ad set. One of: AD_DISABLED, AD_FOLLOWER, DEFAULT, FOLLOWED, FOLLOWER, FRIENDS, FRIENDS_AND_FOLLOWERS, FRIENDS_OF_FRIENDS, SUBSCRIBED, TAGGED. AD_DISABLED turns comments off (and hides the comments already there); DEFAULT lets everyone comment. Omit the field to leave the ad set as it is. Meta refuses to turn comments off on social issues, elections or politics ads.",
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "AD_DISABLED"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "AD_FOLLOWER"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "DEFAULT"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "FOLLOWED"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "FOLLOWER"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "FRIENDS"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "FRIENDS_AND_FOLLOWERS"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "FRIENDS_OF_FRIENDS"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "SUBSCRIBED"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "TAGGED"
+                        ]
+                      }
+                    ]
                   }
                 }
               }
@@ -318960,6 +320231,54 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "error",
+                        "code"
+                      ],
+                      "properties": {
+                        "error": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "description": "FEATURE_DISABLED",
+                          "type": "string"
+                        }
+                      }
+                    },
+                    {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -319297,7 +320616,7 @@
         "tags": [
           "bulk-launch"
         ],
-        "description": "Accepts a nested campaign payload where each ad set contains its own specific ads. Creates 1 campaign -> N ad sets -> M ads per ad set (no cartesian product) and dispatches the work to the bulk-launch SQS workers, stamped with the ACTIVE workspace team (`x-team-id` / team scope required — 400 `SCOPE_TEAM_REQUIRED` otherwise). The referenced ad account (and, for Meta, fan page / pixel / token) must belong to the active workspace or the dispatch is rejected with 403 `RESOURCE_NOT_IN_ACTIVE_WORKSPACE`. Returns the worker_run_id used to poll progress.",
+        "description": "Accepts a nested campaign payload where each ad set contains its own specific ads. Creates 1 campaign -> N ad sets -> M ads per ad set (no cartesian product) and dispatches the work to the bulk-launch SQS workers, stamped with the ACTIVE workspace team (`x-team-id` / team scope required — 400 `SCOPE_TEAM_REQUIRED` otherwise). The referenced ad account (and, for Meta, fan page / pixel / token) must belong to the active workspace or the dispatch is rejected with 403 `RESOURCE_NOT_IN_ACTIVE_WORKSPACE`. Returns the worker_run_id used to poll progress. Each ad set may carry `comment_moderation_filter` (Meta `brand_safety_config`, an ad-set level field) to disable or restrict comments; the field is behind the runtime flag `ad_comments_control_enabled` and a payload that carries it is rejected with 503 `FEATURE_DISABLED`, naming the offending paths, when the flag is off for the caller. A payload without the field is unaffected.",
         "requestBody": {
           "required": true,
           "content": {
@@ -320275,6 +321594,20 @@
                             "type": "integer"
                           }
                         },
+                        "desktop_os": {
+                          "description": "Meta behavior IDs under \"Digital activities > Operating System Used\" (e.g. \"Facebook access (OS): Windows 10\"). Published as a targeting.flexible_spec group; AND-ed with `browsers` when both are set. Discoverable via GET /api/v1/device-behavior-search. Not the mobile `os` field.",
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "browsers": {
+                          "description": "Meta behavior IDs under \"Digital activities > Internet Browser Used\" (e.g. \"Facebook access (browser): Chrome\"). Published as a targeting.flexible_spec group; AND-ed with `desktop_os` when both are set. Discoverable via GET /api/v1/device-behavior-search.",
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
                         "included_audiences": {
                           "description": "Custom audience IDs to include",
                           "type": "array",
@@ -320289,6 +321622,71 @@
                             "type": "string"
                           }
                         },
+                        "comment_moderation_filter": {
+                          "description": "Meta ad-set comment moderation — who may comment on the ads of this ad set. One of: AD_DISABLED, AD_FOLLOWER, DEFAULT, FOLLOWED, FOLLOWER, FRIENDS, FRIENDS_AND_FOLLOWERS, FRIENDS_OF_FRIENDS, SUBSCRIBED, TAGGED. AD_DISABLED turns comments off (and hides the comments already there); DEFAULT lets everyone comment. Omit the field to leave the ad set as it is. Meta refuses to turn comments off on social issues, elections or politics ads.",
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "enum": [
+                                "AD_DISABLED"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "AD_FOLLOWER"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "DEFAULT"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "FOLLOWED"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "FOLLOWER"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "FRIENDS"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "FRIENDS_AND_FOLLOWERS"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "FRIENDS_OF_FRIENDS"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "SUBSCRIBED"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "TAGGED"
+                              ]
+                            }
+                          ]
+                        },
                         "ads": {
                           "description": "Ads within this ad set",
                           "minItems": 1,
@@ -320305,7 +321703,8 @@
                             ],
                             "properties": {
                               "name": {
-                                "description": "Ad name",
+                                "description": "Ad name. Measured against Meta v25.0 on 2026-09-12: 400 characters are accepted and stored, 401 is rejected — so the schema refuses 401 here instead of letting the whole ad creation fail at Meta. Same number as the ad set name; it is the one limit in the product (AD_NAME_MAX_LENGTH).",
+                                "maxLength": 400,
                                 "type": "string"
                               },
                               "cta": {
@@ -320763,6 +322162,54 @@
                 }
               }
             }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "error",
+                        "code"
+                      ],
+                      "properties": {
+                        "error": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "description": "FEATURE_DISABLED",
+                          "type": "string"
+                        }
+                      }
+                    },
+                    {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -330283,6 +331730,9 @@
         "security": [
           {
             "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
           }
         ],
         "responses": {
@@ -330383,6 +331833,9 @@
         "security": [
           {
             "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
           }
         ],
         "responses": {
@@ -330527,6 +331980,9 @@
         "security": [
           {
             "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
           }
         ],
         "responses": {
@@ -330673,6 +332129,9 @@
         "security": [
           {
             "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
           }
         ],
         "responses": {