@wevion/cli 1.0.3604 → 1.0.3682

package/openapi.json

@@ -2356,7 +2356,7 @@
         "tags": [
           "ad-accounts"
         ],
-        "description": "Persists the default conversion event and optional default pixel id for the requested Meta ad account so campaign creation can preselect the team-approved conversion settings.",
+        "description": "Persists the default conversion event for the requested Meta ad account so campaign creation can preselect the team-approved conversion settings. `default_conversion_pixel_id` has patch semantics: omitted leaves the stored pixel untouched, a string sets it, an explicit null clears it. The response always returns the resulting stored settings.",
         "requestBody": {
           "required": true,
           "content": {
@@ -2379,6 +2379,7 @@
                     ]
                   },
                   "default_conversion_pixel_id": {
+                    "description": "Omitted: the stored pixel id is left untouched. String: sets the default pixel. Explicit null: clears it.",
                     "anyOf": [
                       {
                         "type": "string"
@@ -13212,6 +13213,12 @@
                                 "enum": [
                                   "outbrain"
                                 ]
+                              },
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "exoclick"
+                                ]
                               }
                             ]
                           },
@@ -13505,6 +13512,12 @@
                                 "enum": [
                                   "outbrain"
                                 ]
+                              },
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "exoclick"
+                                ]
                               }
                             ]
                           },
@@ -14790,6 +14803,12 @@
                                     "enum": [
                                       "outbrain"
                                     ]
+                                  },
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "exoclick"
+                                    ]
                                   }
                                 ]
                               }
@@ -15093,6 +15112,12 @@
                                 "enum": [
                                   "outbrain"
                                 ]
+                              },
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "exoclick"
+                                ]
                               }
                             ]
                           },
@@ -15375,6 +15400,12 @@
                                 "enum": [
                                   "outbrain"
                                 ]
+                              },
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "exoclick"
+                                ]
                               }
                             ]
                           },
@@ -15581,6 +15612,12 @@
                                 "enum": [
                                   "outbrain"
                                 ]
+                              },
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "exoclick"
+                                ]
                               }
                             ]
                           },
@@ -104545,6 +104582,12 @@
                   "enum": [
                     "outbrain"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
                 }
               ]
             },
@@ -123988,7 +124031,7 @@
           "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. 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": "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).",
         "requestBody": {
           "required": true,
           "content": {
@@ -124011,6 +124054,11 @@
                     "maxLength": 2000,
                     "type": "string"
                   },
+                  "end_image_url": {
+                    "minLength": 1,
+                    "maxLength": 2000,
+                    "type": "string"
+                  },
                   "provider": {
                     "anyOf": [
                       {
@@ -130141,6 +130189,12 @@
                   "enum": [
                     "outbrain"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
                 }
               ]
             },
@@ -130487,6 +130541,12 @@
                   "enum": [
                     "outbrain"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
                 }
               ]
             },
@@ -130877,6 +130937,12 @@
                   "enum": [
                     "outbrain"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
                 }
               ]
             },
@@ -140728,6 +140794,12 @@
                   "enum": [
                     "outbrain"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
                 }
               ]
             },
@@ -141803,6 +141875,12 @@
                   "enum": [
                     "outbrain"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
                 }
               ]
             },
@@ -143184,6 +143262,12 @@
                   "enum": [
                     "outbrain"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
                 }
               ]
             },
@@ -162069,7 +162153,7 @@
         "tags": [
           "partner"
         ],
-        "description": "Registra una candidatura al Programma Partner. ⚠️ Risponde 403 finché il commutatore `partner_track_b_enroll` è spento: la coda candidature è chiusa e NESSUNA pratica viene creata — il corpo del 403 è una costante che non dipende dai dati inviati. Rotta PUBBLICA e senza account: non crea alcuna user_session, alcuna organizzazione e alcuna email di verifica — l’account nasce solo all’approvazione. ★ Risponde SEMPRE 202 con lo stesso corpo, anche se l’email è già candidata o appartiene a un partner già approvato: nessun endpoint di questo programma conferma mai l’esistenza di un’email. Il link con cui seguire la pratica arriva per email, non nella risposta. Due limiti, due comportamenti diversi: 5/h per IP risponde 429; 3/h per identità email è applicato in silenzio, perché un 429 sull’email sarebbe esso stesso l’oracolo che questa rotta evita. ★ Dal 27/08/2026 servono TRE campi: `full_name`, `email`, `tos_accepted` alla `tos_version` corrente. La spunta accetta le **regole di promozione**, non il contratto: quello si firma al primo prelievo (POST /api/v1/partner/consent). Tutto il resto — paese, corsia, dati fiscali, risposte di ramo — resta accettato ma non è più preteso: serve a essere PAGATI, e lo chiedono il profilo di incasso e lo sportello del prelievo. Un partner che non ha firmato promuove e matura commissioni; non le incassa.",
+        "description": "Registra una candidatura al Programma Partner. ⚠️ Risponde 403 finché il commutatore `partner_track_b_enroll` è spento: la coda candidature è chiusa e NESSUNA pratica viene creata — il corpo del 403 è una costante che non dipende dai dati inviati. Rotta PUBBLICA: non richiede alcun login e non apre alcuna sessione nella risposta. L’account nasce all’APPROVAZIONE, e il commutatore `partner_track_b_auto_approve` decide quando arriva. Acceso: la candidatura viene approvata in questa stessa richiesta e l’account nasce qui, insieme a partner, codice e link referral, e l’email di conferma dice come entrare. Spento: l’account nasce quando un revisore approva, e intanto l’email porta il link con cui seguire la pratica. In ENTRAMBI gli stati, se l’indirizzo è già di un partner attivo NESSUNA pratica nasce e l’email porta al suo pannello. ★ Risponde SEMPRE 202 con lo stesso corpo, in tutti questi casi e anche se l’email è già candidata: nessun endpoint di questo programma conferma mai l’esistenza di un’email, e la risposta non dice quale percorso è avvenuto — link e istruzioni arrivano per email, non nella risposta. Due limiti, due comportamenti diversi: 5/h per IP risponde 429; 3/h per identità email è applicato in silenzio, perché un 429 sull’email sarebbe esso stesso l’oracolo che questa rotta evita. ★ Dal 27/08/2026 servono QUATTRO campi: `full_name`, `email`, `phone` (cellulare in forma internazionale) e `tos_accepted` alla `tos_version` corrente. La spunta accetta le **regole di promozione**, non il contratto: quello si firma al primo prelievo (POST /api/v1/partner/consent). Tutto il resto — paese, corsia, dati fiscali, risposte di ramo — resta accettato ma non è più preteso: serve a essere PAGATI, e lo chiedono il profilo di incasso e lo sportello del prelievo. Un partner che non ha firmato promuove e matura commissioni; non le incassa.",
         "requestBody": {
           "required": true,
           "content": {
@@ -163368,162 +163452,14 @@
         }
       }
     },
-    "/api/v1/referral/bridge-offer": {
-      "get": {
-        "operationId": "getPartnerBridgeOffer",
-        "summary": "L’offerta di passaggio al Binario B che mi aspetta",
-        "tags": [
-          "partner"
-        ],
-        "description": "L’offerta di passaggio al Programma Partner che aspetta chi chiama, se ce n’è una ancora da accettare. `204` quando non c’è nulla da accettare — indistintamente perché non esiste alcuna offerta o perché è già stata accettata: distinguere i due casi renderebbe questa rotta un oracolo sull’esistenza di un’offerta. La risposta porta il documento e la versione da accettare, mai il token della pratica.",
-        "security": [
-          {
-            "bearerAuth": []
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "L’offerta di passaggio al Binario B che aspetta chi chiama. ⚠️ Non porta il token della pratica: quello è la chiave di lettura del fascicolo e non ha ragione di uscire da qui.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "L’offerta di passaggio al Binario B che aspetta chi chiama. ⚠️ Non porta il token della pratica: quello è la chiave di lettura del fascicolo e non ha ragione di uscire da qui.",
-                  "type": "object",
-                  "required": [
-                    "country_code",
-                    "offered_at",
-                    "reason",
-                    "tc_document_id",
-                    "tc_version"
-                  ],
-                  "properties": {
-                    "country_code": {
-                      "description": "Il paese già dichiarato sulla pratica, o `null` se va ancora chiesto. ★ Oggi è sempre `null`: l’offerta la genera un cron del Binario A e nessuno ha compilato niente. Esce comunque perché è ciò che dice al modulo che quel campo è **da chiedere** — il giorno in cui un percorso saprà il paese in anticipo, lo stesso campo lo pre-compila senza toccare né la pagina né il contratto.",
-                      "anyOf": [
-                        {
-                          "maxLength": 2,
-                          "minLength": 2,
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "offered_at": {
-                      "description": "Quando l’offerta è nata. È l’unica data che esiste finché non la si accetta.",
-                      "format": "date-time",
-                      "type": "string"
-                    },
-                    "reason": {
-                      "description": "Perché è nata: `cap_reached` (tetto del Binario A) o `third_matured_conversion`.",
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "tc_document_id": {
-                      "description": "Il documento da accettare. Oggi sempre `partnerTerms`.",
-                      "type": "string"
-                    },
-                    "tc_version": {
-                      "description": "La versione proposta: è quella che va rimandata all’accettazione.",
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "204": {
-            "description": "Nessuna offerta da accettare."
-          },
-          "401": {
-            "description": "Errore standard del backend.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "Errore standard del backend.",
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "code": {
-                      "description": "Codice macchina dell’errore, quando disponibile.",
-                      "type": "string"
-                    },
-                    "error": {
-                      "description": "Etichetta breve dell’errore.",
-                      "type": "string"
-                    },
-                    "message": {
-                      "description": "Messaggio leggibile.",
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "description": "Codice di stato HTTP ripetuto nel corpo.",
-                      "type": "integer"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "429": {
-            "description": "Errore standard del backend.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "Errore standard del backend.",
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "code": {
-                      "description": "Codice macchina dell’errore, quando disponibile.",
-                      "type": "string"
-                    },
-                    "error": {
-                      "description": "Etichetta breve dell’errore.",
-                      "type": "string"
-                    },
-                    "message": {
-                      "description": "Messaggio leggibile.",
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "description": "Codice di stato HTTP ripetuto nel corpo.",
-                      "type": "integer"
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/api/v1/referral/bridge-offer/accept": {
+    "/api/v1/partner/become-customer": {
       "post": {
-        "operationId": "acceptPartnerBridgeOffer",
-        "summary": "Accetto i termini e passo al Binario B",
+        "operationId": "partnerBecomeCustomer",
+        "summary": "Da partner-only a cliente: attivo il prodotto sul mio account",
         "tags": [
           "partner"
         ],
-        "description": "Completa e accetta l’offerta di passaggio al Binario B. ★ È l’ATTO che il ponte non aveva: porta il **paese** dichiarato (`country_code`, obbligatorio — l’offerta nasce senza, perché a generarla è un cron) e la prova di consenso. registra `tc_accepted_at`, l’IP, lo user-agent, l’impronta del testo e la versione — gli stessi cinque campi che la candidatura pubblica raccoglie, perché una prova di consenso non può avere due forme a seconda di dove entra — e porta la pratica in `received`, cioè nella coda normale. Finché questo atto non avviene l’approvazione risponde `409 tc_not_accepted` e il vincolo `ck_papp_approved_needs_consent` rifiuta comunque la transizione: nessuno può essere approvato senza aver accettato. `404` quando non c’è nulla da accettare (nessuna offerta, o già accettata: i due casi rispondono identico). `409 stale_version` quando la versione inviata non è quella corrente; `409 open_application_exists` quando per la stessa email esiste già una candidatura aperta — l’offerta non può portarne una seconda, e dirlo non è un oracolo perché quella pratica è di chi chiede. `400 invalid_country` quando `country_code` non è due lettere: è l’unico rifiuto non anti-oracolo di questa rotta, deciso prima di cercare l’offerta — un `404` al suo posto direbbe «non c’è niente per te» mentre manca solo un campo. `403` quando il programma è chiuso: accettare a porta chiusa scriverebbe un consenso write-once su un percorso che non può proseguire.",
+        "description": "Trasforma la sessione partner-only che chiama in un account cliente: in una sola transazione il ruolo passa da `partner` a `owner` e nascono organizzazione, team e permesso di titolarità — lo stesso provisioning del signup self-service. La riga `partner` resta com’è: l’account diventa un partner ibrido, con il pannello ancora raggiungibile da `/partner` e `partner_only: false` su `/auth/me` dalla chiamata successiva. Agisce SOLO sull’utente autenticato: nessun input nomina un utente, e sotto impersonificazione (`x-impersonate-user`) risponde `403 PARTNER_IMPERSONATION_DENIED` prima di ogni scrittura, perché lì `request.user` sarebbe il bersaglio. `409 PARTNER_ALREADY_CUSTOMER` quando il ruolo non è `partner` — cioè il prodotto è già di chi chiama, anche per la seconda di due richieste concorrenti. `409 PARTNER_NOT_ACTIVE` se la posizione partner non è `approved` (sospesa o chiusa): il prodotto non si apre da lì. `404 PARTNER_USER_NOT_FOUND` se l’account non esiste più. Il cambio di ruolo è registrato in `audit_log` (`partner.became_customer`).",
         "requestBody": {
           "required": true,
           "content": {
@@ -163532,22 +163468,25 @@
                 "additionalProperties": false,
                 "type": "object",
                 "required": [
-                  "country_code",
-                  "tos_version"
+                  "plan"
                 ],
                 "properties": {
-                  "country_code": {
-                    "description": "Il paese ISO-3166-1 alpha-2 in cui il partner è stabilito. ★ **Obbligatorio, e senza ripiego**: l’offerta di ponte nasce con `country_code` vuoto perché a generarla è un cron, e questa è l’unica porta da cui può arrivarne uno dichiarato. Non è un’etichetta: all’approvazione viene copiato in `partner.country_code`, e da lì `requiredChecksForLevel` decide se VIES è un controllo KYC dovuto o va sostituito da `company_registry`. Un valore indovinato sceglierebbe una verifica antiriciclaggio al posto di chi la deve subire.",
-                    "maxLength": 2,
-                    "minLength": 2,
-                    "pattern": "^[A-Za-z]{2}$",
-                    "type": "string"
-                  },
-                  "tos_version": {
-                    "description": "La versione dei T&C partner che si sta accettando. Deve essere quella CORRENTE: accettare una versione vecchia scriverebbe una prova di consenso su un testo diverso da quello mostrato.",
-                    "maxLength": 20,
-                    "minLength": 1,
-                    "type": "string"
+                  "plan": {
+                    "description": "Come si vuole iniziare: `free` (nessuna carta) o `trial` (prova gratuita su un piano a pagamento, carta richiesta). Non cambia ciò che questa rotta scrive — ruolo e organizzazione sono gli stessi — ma finisce nell’audit e decide dove `next` porta: la pagina di onboarding onora la scelta senza richiederla.",
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "free"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "trial"
+                        ]
+                      }
+                    ]
                   }
                 }
               }
@@ -163568,14 +163507,447 @@
                   "additionalProperties": false,
                   "type": "object",
                   "required": [
-                    "status"
+                    "next",
+                    "role"
                   ],
                   "properties": {
-                    "status": {
-                      "description": "La pratica è entrata nella coda normale: da qui in poi è una candidatura come le altre.",
+                    "next": {
+                      "description": "Dove la SPA porta l’utente subito dopo: la pagina di onboarding del prodotto, con il piano scelto nella query. Lì si raccolgono i dati aziendali e l’accettazione dei termini di prodotto — chi arriva da qui ha accettato solo quelli del Programma Partner.",
+                      "type": "string"
+                    },
+                    "role": {
+                      "description": "Il ruolo di prodotto appena scritto sulla sessione. Da qui in poi `/auth/me` lo riporta.",
                       "type": "string",
                       "enum": [
-                        "received"
+                        "owner"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/referral/bridge-offer": {
+      "get": {
+        "operationId": "getPartnerBridgeOffer",
+        "summary": "L’offerta di passaggio al Binario B che mi aspetta",
+        "tags": [
+          "partner"
+        ],
+        "description": "L’offerta di passaggio al Programma Partner che aspetta chi chiama, se ce n’è una ancora da accettare. `204` quando non c’è nulla da accettare — indistintamente perché non esiste alcuna offerta o perché è già stata accettata: distinguere i due casi renderebbe questa rotta un oracolo sull’esistenza di un’offerta. La risposta porta il documento e la versione da accettare, mai il token della pratica.",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "L’offerta di passaggio al Binario B che aspetta chi chiama. ⚠️ Non porta il token della pratica: quello è la chiave di lettura del fascicolo e non ha ragione di uscire da qui.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "L’offerta di passaggio al Binario B che aspetta chi chiama. ⚠️ Non porta il token della pratica: quello è la chiave di lettura del fascicolo e non ha ragione di uscire da qui.",
+                  "type": "object",
+                  "required": [
+                    "country_code",
+                    "offered_at",
+                    "reason",
+                    "tc_document_id",
+                    "tc_version"
+                  ],
+                  "properties": {
+                    "country_code": {
+                      "description": "Il paese già dichiarato sulla pratica, o `null` se va ancora chiesto. ★ Oggi è sempre `null`: l’offerta la genera un cron del Binario A e nessuno ha compilato niente. Esce comunque perché è ciò che dice al modulo che quel campo è **da chiedere** — il giorno in cui un percorso saprà il paese in anticipo, lo stesso campo lo pre-compila senza toccare né la pagina né il contratto.",
+                      "anyOf": [
+                        {
+                          "maxLength": 2,
+                          "minLength": 2,
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "offered_at": {
+                      "description": "Quando l’offerta è nata. È l’unica data che esiste finché non la si accetta.",
+                      "format": "date-time",
+                      "type": "string"
+                    },
+                    "reason": {
+                      "description": "Perché è nata: `cap_reached` (tetto del Binario A) o `third_matured_conversion`.",
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "tc_document_id": {
+                      "description": "Il documento da accettare. Oggi sempre `partnerTerms`.",
+                      "type": "string"
+                    },
+                    "tc_version": {
+                      "description": "La versione proposta: è quella che va rimandata all’accettazione.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Nessuna offerta da accettare."
+          },
+          "401": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/referral/bridge-offer/accept": {
+      "post": {
+        "operationId": "acceptPartnerBridgeOffer",
+        "summary": "Accetto i termini e passo al Binario B",
+        "tags": [
+          "partner"
+        ],
+        "description": "Completa e accetta l’offerta di passaggio al Binario B. ★ È l’ATTO che il ponte non aveva: porta il **paese** dichiarato (`country_code`, obbligatorio — l’offerta nasce senza, perché a generarla è un cron) e la prova di consenso. registra `tc_accepted_at`, l’IP, lo user-agent, l’impronta del testo e la versione — gli stessi cinque campi che la candidatura pubblica raccoglie, perché una prova di consenso non può avere due forme a seconda di dove entra — e porta la pratica in `received`, cioè nella coda normale. Finché questo atto non avviene l’approvazione risponde `409 tc_not_accepted` e il vincolo `ck_papp_approved_needs_consent` rifiuta comunque la transizione: nessuno può essere approvato senza aver accettato. `404` quando non c’è nulla da accettare (nessuna offerta, o già accettata: i due casi rispondono identico). `409 stale_version` quando la versione inviata non è quella corrente; `409 open_application_exists` quando per la stessa email esiste già una candidatura aperta — l’offerta non può portarne una seconda, e dirlo non è un oracolo perché quella pratica è di chi chiede. `400 invalid_country` quando `country_code` non è due lettere: è l’unico rifiuto non anti-oracolo di questa rotta, deciso prima di cercare l’offerta — un `404` al suo posto direbbe «non c’è niente per te» mentre manca solo un campo. `403` quando il programma è chiuso: accettare a porta chiusa scriverebbe un consenso write-once su un percorso che non può proseguire.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "country_code",
+                  "tos_version"
+                ],
+                "properties": {
+                  "country_code": {
+                    "description": "Il paese ISO-3166-1 alpha-2 in cui il partner è stabilito. ★ **Obbligatorio, e senza ripiego**: l’offerta di ponte nasce con `country_code` vuoto perché a generarla è un cron, e questa è l’unica porta da cui può arrivarne uno dichiarato. Non è un’etichetta: all’approvazione viene copiato in `partner.country_code`, e da lì `requiredChecksForLevel` decide se VIES è un controllo KYC dovuto o va sostituito da `company_registry`. Un valore indovinato sceglierebbe una verifica antiriciclaggio al posto di chi la deve subire.",
+                    "maxLength": 2,
+                    "minLength": 2,
+                    "pattern": "^[A-Za-z]{2}$",
+                    "type": "string"
+                  },
+                  "tos_version": {
+                    "description": "La versione dei T&C partner che si sta accettando. Deve essere quella CORRENTE: accettare una versione vecchia scriverebbe una prova di consenso su un testo diverso da quello mostrato.",
+                    "maxLength": 20,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "status"
+                  ],
+                  "properties": {
+                    "status": {
+                      "description": "La pratica è entrata nella coda normale: da qui in poi è una candidatura come le altre.",
+                      "type": "string",
+                      "enum": [
+                        "received"
                       ]
                     }
                   }
@@ -166444,15 +166816,18 @@
                     "code",
                     "collection_mode",
                     "country_code",
+                    "country_locked",
                     "coupon",
                     "credit",
                     "frozen",
+                    "grace_days",
                     "kyc_level",
                     "lane",
                     "next_payout",
                     "partner_id",
                     "partner_profile",
                     "payout_request",
+                    "payout_profile_saved",
                     "payout_ready",
                     "primary_link",
                     "public_profile",
@@ -166539,7 +166914,7 @@
                       "type": "string"
                     },
                     "country_code": {
-                      "description": "Paese di stabilimento dichiarato, `null` finché non lo è. Decide la lingua che fa fede sul contratto (art. 19) e i controlli KYC dovuti. Lo scrive il profilo di incasso.",
+                      "description": "Paese di stabilimento dichiarato, `null` finché non lo è. Decide la lingua che fa fede sul contratto (art. 19) e i controlli KYC dovuti. Lo scrivono `PATCH /me/country` (una volta sola, dalla card della firma) e il profilo di incasso — che dopo una firma registrata non lo cambia più (`409 PARTNER_COUNTRY_LOCKED`): da lì in poi è il paese del contratto firmato.",
                       "anyOf": [
                         {
                           "type": "string"
@@ -166549,6 +166924,10 @@
                         }
                       ]
                     },
+                    "country_locked": {
+                      "description": "`true` = `country_code` è quello del contratto firmato (esiste una riga `partner_kyc_event` con `check_kind=signed_contract` ed esito `passed`, e un paese in tabella): il profilo di incasso lo mostra in sola lettura e `POST /payout-profile` rifiuta un valore diverso con `409 PARTNER_COUNTRY_LOCKED`. È la STESSA misura del server, non una deduzione dai blocchi di `next_payout`: chi ha firmato un contratto fuori piattaforma, o deve ri-firmare un testo nuovo, la vede uguale su entrambi i lati.",
+                      "type": "boolean"
+                    },
                     "coupon": {
                       "description": "Coupon del partner, `null` se non ne ha uno attivo.",
                       "anyOf": [
@@ -166674,6 +167053,11 @@
                       "description": "Kill-switch armato: il denaro è congelato, il tracking no.",
                       "type": "boolean"
                     },
+                    "grace_days": {
+                      "description": "Giorni dal signup entro cui il referito può ancora inserire il codice invito e risultare attribuito al partner (PRD §5.2, «grazia»). È il valore EFFETTIVO del motore — `PARTNER_GRACE_DAYS` o il suo default — non una costante di presentazione.",
+                      "minimum": 1,
+                      "type": "integer"
+                    },
                     "kyc_level": {
                       "description": "Livello KYC 0-3 (§6.5).",
                       "maximum": 3,
@@ -166891,6 +167275,10 @@
                         }
                       ]
                     },
+                    "payout_profile_saved": {
+                      "description": "`true` se il profilo di incasso (`POST /api/v1/partner/payout-profile`) è stato salvato almeno una volta: il fatto è l’impronta dell’IBAN in tabella. Ortogonale a `payout_ready`: un profilo salvato resta non pagabile finché una verifica (intestatario, VIES, registro imprese) è in corso. Il pannello lo usa per NON mandare a ricompilare un modulo già salvato — ogni salvataggio riapre 72 ore di raffreddamento sui pagamenti.",
+                      "type": "boolean"
+                    },
                     "payout_ready": {
                       "description": "Documenti fiscali a posto. Ortogonale allo stato delle commissioni (§6.2).",
                       "type": "boolean"
@@ -168007,7 +168395,7 @@
         "tags": [
           "partner"
         ],
-        "description": "★ **È la firma del contratto, e dal 27/08/2026 è la porta del primo prelievo.** Decisione 1 di Salvatore: si entra prima, si firma dopo. La candidatura fa accettare le sole regole di promozione (`partnerContentAddendum`); il contratto (`partnerTerms`) — aliquote, finestra, fatturazione — si accetta qui, e finché non lo si fa il pannello espone il blocco `contract_not_signed` e lo sportello del prelievo resta chiuso. ⚠️ Non blocca la maturazione: chi non ha firmato promuove e accumula commissioni, non le incassa. È anche la sola porta che scrive `partner_program_enrollment`: l’approvazione ha smesso di iscrivere, perché iscriveva sulla base di un consenso a un ALTRO documento. Resta esposta anche per un’accettazione DELIBERATA fuori dal percorso del prelievo. Registra l’accettazione dei documenti di programma da parte del partner autenticato: una riga `legal_consent` per documento e, quando esiste una versione di programma pubblicata per il suo binario, una riga `partner_program_enrollment`. L’adesione è APPEND-ONLY (`trg_ppe_append_only`) e unica per versione (`uq_ppe_partner_version`): riaccettare la stessa versione è idempotente e restituisce `enrolled: false`. Ogni riga di `legal_consent` porta nei metadata la lingua che fa fede, l’impronta `sha256` e l’URL del testo firmato: senza, la riga proverebbe che qualcuno ha accettato ma non QUALE testo, e lo stesso documento esiste in due lingue con due impronte. Quando il corpo porta il documento che governa il binario, la firma scrive anche la prova KYC `partner_kyc_event(check_kind='signed_contract')`, richiesta dal livello 3: prima la scrivevano solo la creazione manuale e il backoffice, e chi firmava qui restava murato su un controllo che la sua firma soddisfa. Due cause di `409`, distinte dal campo `code`. `PARTNER_STALE_DOCUMENT_VERSION`: una versione diversa da quella corrente — un client fermo su un testo vecchio si dichiarerebbe in pari senza aver mai visto quello nuovo. `PARTNER_COUNTRY_NOT_DECLARED`: `partner.country_code` è ancora nullo e almeno uno dei documenti cambia testo con il paese (art. 19: fa fede l’inglese, salvo per chi è stabilito in Italia) — si registrerebbe l’impronta dell’inglese per ripiego, e il partner che poi dichiara `IT` avrebbe una prova write-once di un testo mai mostrato. Il paese si dichiara nel profilo di incasso (`PUT /api/v1/partner/payout-profile`). ⚠️ Non riguarda il Binario A: `referralTerms` è l’art. 23 dei ToS, un testo solo per entrambe le lingue.",
+        "description": "★ **È la firma del contratto, e dal 27/08/2026 è la porta del primo prelievo.** Decisione 1 di Salvatore: si entra prima, si firma dopo. La candidatura fa accettare le sole regole di promozione (`partnerContentAddendum`); il contratto (`partnerTerms`) — aliquote, finestra, fatturazione — si accetta qui, e finché non lo si fa il pannello espone il blocco `contract_not_signed` e lo sportello del prelievo resta chiuso. ⚠️ Non blocca la maturazione: chi non ha firmato promuove e accumula commissioni, non le incassa. È anche la sola porta che scrive `partner_program_enrollment`: l’approvazione ha smesso di iscrivere, perché iscriveva sulla base di un consenso a un ALTRO documento. Resta esposta anche per un’accettazione DELIBERATA fuori dal percorso del prelievo. Registra l’accettazione dei documenti di programma da parte del partner autenticato: una riga `legal_consent` per documento e, quando esiste una versione di programma pubblicata per il suo binario, una riga `partner_program_enrollment`. L’adesione è APPEND-ONLY (`trg_ppe_append_only`) e unica per versione (`uq_ppe_partner_version`): riaccettare la stessa versione è idempotente e restituisce `enrolled: false`. Ogni riga di `legal_consent` porta nei metadata la lingua che fa fede, l’impronta `sha256` e l’URL del testo firmato: senza, la riga proverebbe che qualcuno ha accettato ma non QUALE testo, e lo stesso documento esiste in due lingue con due impronte. Quando il corpo porta il documento che governa il binario, la firma scrive anche la prova KYC `partner_kyc_event(check_kind='signed_contract')`, richiesta dal livello 3: prima la scrivevano solo la creazione manuale e il backoffice, e chi firmava qui restava murato su un controllo che la sua firma soddisfa. Due cause di `409`, distinte dal campo `code`. `PARTNER_STALE_DOCUMENT_VERSION`: una versione diversa da quella corrente — un client fermo su un testo vecchio si dichiarerebbe in pari senza aver mai visto quello nuovo. `PARTNER_COUNTRY_NOT_DECLARED`: `partner.country_code` è ancora nullo e almeno uno dei documenti cambia testo con il paese (art. 19: fa fede l’inglese, salvo per chi è stabilito in Italia) — si registrerebbe l’impronta dell’inglese per ripiego, e il partner che poi dichiara `IT` avrebbe una prova write-once di un testo mai mostrato. Il paese si dichiara da solo con `PATCH /api/v1/partner/me/country` (è ciò che la card della firma fa prima di chiamare questa rotta) o nel profilo di incasso (`POST /api/v1/partner/payout-profile`). ⚠️ Non riguarda il Binario A: `referralTerms` è l’art. 23 dei ToS, un testo solo per entrambe le lingue.",
         "requestBody": {
           "required": true,
           "content": {
@@ -168347,70 +168735,36 @@
         }
       }
     },
-    "/api/v1/partner/profile": {
+    "/api/v1/partner/me/country": {
       "patch": {
-        "operationId": "updatePartnerPublicProfile",
-        "summary": "Aggiorna il profilo pubblico del partner",
+        "operationId": "declarePartnerCountry",
+        "summary": "Dichiara il paese di stabilimento (una volta sola)",
         "tags": [
           "partner"
         ],
-        "description": "Aggiorna il profilo PUBBLICO del partner. Ogni modifica riporta il profilo in `pending`: senza ri-approvazione un profilo già approvato potrebbe cambiare nome e aggirare il gate umano dell’identità reciproca (§4.5). Finché è `pending` le celle identità restano coperte.",
+        "description": "Dichiara il paese di stabilimento del partner autenticato, scrivendo `partner.country_code` **solo se è ancora nullo**. È la precondizione della firma del contratto (`POST /api/v1/partner/consent`): il paese decide quale lingua del testo fa fede (art. 19: l’inglese, salvo per chi è stabilito in Italia), quindi di quale testo si registra l’impronta — e va dichiarato PRIMA di leggere e firmare. ⚠️ **Write-once**: una volta scritto, il paese non si cambia da qui — dopo la firma è la prova di quale testo fa fede, e la riga di consenso è append-only. `409 PARTNER_COUNTRY_ALREADY_DECLARED` = il paese era già in tabella (il messaggio dice quale); il client rilegge `GET /me` e usa quello. `422 PARTNER_COUNTRY_INVALID` = non sono due lettere (rete sotto lo schema: lo stesso controllo delle altre porte che raccolgono un paese). Il profilo di incasso (`POST /api/v1/partner/payout-profile`) segue la stessa regola dalla stessa sorgente: scrive il paese se è nullo, lo sostituisce solo finché nessuna firma è registrata, e dopo risponde `409 PARTNER_COUNTRY_LOCKED`.",
         "requestBody": {
           "required": true,
           "content": {
             "application/json": {
               "schema": {
                 "additionalProperties": false,
-                "description": "Profilo PUBBLICO. Non è `partner_profile`, che è la configurazione a 4 valori della dashboard ed è in sola lettura per il partner (§12.5).",
                 "type": "object",
+                "required": [
+                  "country_code"
+                ],
                 "properties": {
-                  "avatar_url": {
-                    "description": "URL dell’avatar pubblico.",
-                    "anyOf": [
-                      {
-                        "maxLength": 500,
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "display_name": {
-                    "description": "Nome mostrato al referito.",
-                    "maxLength": 120,
+                  "country_code": {
+                    "description": "Paese di stabilimento, ISO 3166-1 alpha-2 (due lettere, in qualunque caso: si salva in maiuscolo). Decide quale lingua del contratto fa fede (art. 19: l’inglese, salvo per chi è stabilito in Italia) e quali controlli KYC sono dovuti.",
+                    "maxLength": 2,
                     "minLength": 2,
+                    "pattern": "^[A-Za-z]{2}$",
                     "type": "string"
-                  },
-                  "handle": {
-                    "description": "Handle social pubblico.",
-                    "anyOf": [
-                      {
-                        "maxLength": 80,
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "tagline": {
-                    "description": "Una riga di presentazione.",
-                    "anyOf": [
-                      {
-                        "maxLength": 160,
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
                   }
                 }
               }
             }
-          },
-          "description": "Profilo PUBBLICO. Non è `partner_profile`, che è la configurazione a 4 valori della dashboard ed è in sola lettura per il partner (§12.5)."
+          }
         },
         "security": [
           {
@@ -168419,124 +168773,429 @@
         ],
         "responses": {
           "200": {
-            "description": "Profilo pubblico del partner: è il gate dell’identità reciproca, e da qui il partner scopre a che punto è la sua revisione.",
+            "description": "Il paese di stabilimento appena dichiarato.",
             "content": {
               "application/json": {
                 "schema": {
                   "additionalProperties": false,
-                  "description": "Profilo pubblico del partner: è il gate dell’identità reciproca, e da qui il partner scopre a che punto è la sua revisione.",
+                  "description": "Il paese di stabilimento appena dichiarato.",
                   "type": "object",
                   "required": [
-                    "approved",
-                    "avatar_url",
-                    "display_name",
-                    "handle",
-                    "rejected_at",
-                    "rejection_code",
-                    "review_state",
-                    "tagline"
+                    "country_code"
                   ],
                   "properties": {
-                    "approved": {
-                      "description": "true solo dopo l’approvazione del backoffice (§4.5).",
-                      "type": "boolean"
+                    "country_code": {
+                      "description": "Il paese scritto in `partner.country_code`, in maiuscolo.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
                     },
-                    "avatar_url": {
-                      "description": "Avatar pubblico.",
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
                     },
-                    "display_name": {
-                      "description": "Nome mostrato al referito.",
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
                     },
-                    "handle": {
-                      "description": "Handle social pubblico.",
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
                     },
-                    "rejected_at": {
-                      "description": "Quando il profilo è stato rimandato indietro. Valorizzato solo insieme a `rejection_code`, cioè solo con `review_state: rejected`.",
-                      "anyOf": [
-                        {
-                          "format": "date-time",
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
                     },
-                    "rejection_code": {
-                      "description": "Il CODICE del motivo per cui il profilo è stato rimandato indietro (enum chiuso, `lib/partner-reason-codes.ts`), oppure `null`. ★ È un codice e non una frase perché la lingua la sceglie il client: il pannello lo traduce in due frasi — cosa non va, e cosa cambiare. La nota interna scritta dall’operatore NON esiste su questa superficie e non è ottenibile da qui. Non è mai valorizzato fuori da `review_state: rejected`, nemmeno su un profilo tornato in attesa dopo una modifica del partner.",
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
                     },
-                    "review_state": {
-                      "description": "Il verdetto della revisione del profilo pubblico. ★ Esiste perché `approved: false` collassava tre situazioni in una — «non l’ho mai mandato», «lo stanno guardando», «me l’hanno rimandato indietro» — e chi era stato rifiutato si trovava davanti un interruttore fermo, senza sapere se ci fosse qualcosa da correggere.",
-                      "anyOf": [
-                        {
-                          "type": "string",
-                          "enum": [
-                            "approved"
-                          ]
-                        },
-                        {
-                          "type": "string",
-                          "enum": [
-                            "pending"
-                          ]
-                        },
-                        {
-                          "type": "string",
-                          "enum": [
-                            "rejected"
-                          ]
-                        }
-                      ]
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
                     },
-                    "tagline": {
-                      "description": "Una riga di presentazione.",
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
                     }
                   }
                 }
               }
             }
           },
-          "400": {
+          "409": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/partner/profile": {
+      "patch": {
+        "operationId": "updatePartnerPublicProfile",
+        "summary": "Aggiorna il profilo pubblico del partner",
+        "tags": [
+          "partner"
+        ],
+        "description": "Aggiorna il profilo PUBBLICO del partner. Ogni modifica riporta il profilo in `pending`: senza ri-approvazione un profilo già approvato potrebbe cambiare nome e aggirare il gate umano dell’identità reciproca (§4.5). Finché è `pending` le celle identità restano coperte.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "description": "Profilo PUBBLICO. Non è `partner_profile`, che è la configurazione a 4 valori della dashboard ed è in sola lettura per il partner (§12.5).",
+                "type": "object",
+                "properties": {
+                  "avatar_url": {
+                    "description": "URL dell’avatar pubblico.",
+                    "anyOf": [
+                      {
+                        "maxLength": 500,
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "display_name": {
+                    "description": "Nome mostrato al referito.",
+                    "maxLength": 120,
+                    "minLength": 2,
+                    "type": "string"
+                  },
+                  "handle": {
+                    "description": "Handle social pubblico.",
+                    "anyOf": [
+                      {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "tagline": {
+                    "description": "Una riga di presentazione.",
+                    "anyOf": [
+                      {
+                        "maxLength": 160,
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          },
+          "description": "Profilo PUBBLICO. Non è `partner_profile`, che è la configurazione a 4 valori della dashboard ed è in sola lettura per il partner (§12.5)."
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Profilo pubblico del partner: è il gate dell’identità reciproca, e da qui il partner scopre a che punto è la sua revisione.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Profilo pubblico del partner: è il gate dell’identità reciproca, e da qui il partner scopre a che punto è la sua revisione.",
+                  "type": "object",
+                  "required": [
+                    "approved",
+                    "avatar_url",
+                    "display_name",
+                    "handle",
+                    "rejected_at",
+                    "rejection_code",
+                    "review_state",
+                    "tagline"
+                  ],
+                  "properties": {
+                    "approved": {
+                      "description": "true solo dopo l’approvazione del backoffice (§4.5).",
+                      "type": "boolean"
+                    },
+                    "avatar_url": {
+                      "description": "Avatar pubblico.",
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "display_name": {
+                      "description": "Nome mostrato al referito.",
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "handle": {
+                      "description": "Handle social pubblico.",
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "rejected_at": {
+                      "description": "Quando il profilo è stato rimandato indietro. Valorizzato solo insieme a `rejection_code`, cioè solo con `review_state: rejected`.",
+                      "anyOf": [
+                        {
+                          "format": "date-time",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "rejection_code": {
+                      "description": "Il CODICE del motivo per cui il profilo è stato rimandato indietro (enum chiuso, `lib/partner-reason-codes.ts`), oppure `null`. ★ È un codice e non una frase perché la lingua la sceglie il client: il pannello lo traduce in due frasi — cosa non va, e cosa cambiare. La nota interna scritta dall’operatore NON esiste su questa superficie e non è ottenibile da qui. Non è mai valorizzato fuori da `review_state: rejected`, nemmeno su un profilo tornato in attesa dopo una modifica del partner.",
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "review_state": {
+                      "description": "Il verdetto della revisione del profilo pubblico. ★ Esiste perché `approved: false` collassava tre situazioni in una — «non l’ho mai mandato», «lo stanno guardando», «me l’hanno rimandato indietro» — e chi era stato rifiutato si trovava davanti un interruttore fermo, senza sapere se ci fosse qualcosa da correggere.",
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "approved"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "pending"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "rejected"
+                          ]
+                        }
+                      ]
+                    },
+                    "tagline": {
+                      "description": "Una riga di presentazione.",
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
             "description": "Errore standard del backend.",
             "content": {
               "application/json": {
@@ -168651,7 +169310,7 @@
         "tags": [
           "partner"
         ],
-        "description": "Salva l’identità fiscale e le coordinate di incasso del partner autenticato, poi tenta di renderlo pagabile da solo (verifica europea della partita IVA). ⚠️ **L’IBAN non viene conservato**: se ne verifica la cifra di controllo e se ne scrive la sola impronta `sha256(pepper || IBAN)` (§6.7). Ogni salvataggio apre un raffreddamento di 72 ore sul pagamento — è la finestra in cui il titolare vero si accorge di un cambio di conto che non ha fatto. `403` = questo profilo non appartiene a chi è compensato in credito di fatturazione. `409` = quella partita IVA o quel conto sono già di un altro partner (lo dice il vincolo del database, non una SELECT che due schede supererebbero entrambe). `422` = IBAN con cifra di controllo sbagliata, o partita IVA implausibile.",
+        "description": "Salva l’identità fiscale e le coordinate di incasso del partner autenticato, poi tenta di renderlo pagabile da solo (verifica europea della partita IVA). ⚠️ **L’IBAN non viene conservato**: se ne verifica la cifra di controllo e se ne scrive la sola impronta `sha256(pepper || IBAN)` (§6.7). Ogni salvataggio apre un raffreddamento di 72 ore sul pagamento — è la finestra in cui il titolare vero si accorge di un cambio di conto che non ha fatto. `403` = questo profilo non appartiene a chi è compensato in credito di fatturazione. Due cause di `409`, distinte dal campo `code`. `PARTNER_DUPLICATE_IDENTITY`: quella partita IVA o quel conto sono già di un altro partner (lo dice il vincolo del database, non una SELECT che due schede supererebbero entrambe). `PARTNER_COUNTRY_LOCKED`: `country_code` è diverso da quello in tabella e una firma del contratto è già registrata (`partner_kyc_event` con `check_kind=signed_contract` ed esito `passed`) — il paese decide quale testo del contratto fa fede (art. 19) e la riga di consenso è append-only, quindi dopo la firma è il paese del contratto firmato e si cambia solo scrivendoci; il messaggio lo nomina e il profilo NON viene salvato. Finché nessuna firma è registrata, un paese diverso sostituisce quello in tabella; uguale, non lo tocca; nullo, lo scrive — la stessa regola di `PATCH /api/v1/partner/me/country`, dalla stessa sorgente. `422` = IBAN con cifra di controllo sbagliata, o partita IVA implausibile.",
         "requestBody": {
           "required": true,
           "content": {
@@ -170015,7 +170674,46 @@
         "tags": [
           "partner"
         ],
-        "description": "Mi iscrivo al programma referral come cliente (Binario A). ⚠️ Non crea un account, non cambia il mio ruolo, non manda email: fa nascere la mia anagrafica di referrer e il mio codice invito. È idempotente — chiamarla due volte restituisce lo stesso partner. Risponde `404` quando il programma non è acceso: a commutatore spento non esiste per il cliente, e un 403 direbbe che esiste ma non è per lui, che è falso.",
+        "description": "Mi iscrivo al programma referral come cliente (Binario A). ⚠️ Non crea un account, non cambia il mio ruolo, non manda email: fa nascere la mia anagrafica di referrer e il mio codice invito. È idempotente — chiamarla due volte restituisce lo stesso partner. Risponde `404` quando il programma non è acceso: a commutatore spento non esiste per il cliente, e un 403 direbbe che esiste ma non è per lui, che è falso. ★ **Il corpo è FACOLTATIVO e porta la spunta sull’art. 23 dei Termini di Servizio**, che è il contratto del Binario A. Quando c’è, la riga `legal_consent` — con impronta `sha256`, URL e lingua che fa fede nei metadata — nasce **nella stessa transazione** che crea il partner: o nascono insieme, o non nasce nessuno dei due, perché un referrer senza la sua firma è esattamente lo stato che nessuna schermata segnala. Quando non c’è, l’iscrizione è identica a prima e nessun consenso viene scritto: una firma non si fabbrica per conto di chi non l’ha data. Il campo resta facoltativo perché questa rotta è pubblicata nell’SDK — renderlo obbligatorio manderebbe in `400` ogni client non ancora aggiornato. Gli errori: `400` corpo malformato — un documento diverso da `referralTerms`, o la versione mancante o vuota. ⚠️ Un campo NON dichiarato non produce `400`: viene tolto dal corpo prima del gestore (l’ajv di Fastify gira con `removeAdditional: true`), quindi nessun client può dichiarare da dove sta firmando — la superficie la decide la rotta. `409` con `code: PARTNER_STALE_DOCUMENT_VERSION` quando la versione dichiarata non è quella corrente — stesso codice di `POST /api/v1/partner/consent`, così il client ha una sola grammatica da imparare, e nessun partner viene creato; `409` con il motivo del rifiuto (`already_enrolled`, `duplicate_identity`, `existing_partner_without_track`, `existing_track_b_partner`) quando un’anagrafica partner esiste già; `422 no_organization`; `401 user_not_found`; `503 tooling_catalog_empty`.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "description": "La spunta sull’art. 23 dei ToS, se il client la raccoglie. Assente ⇒ l’iscrizione avviene come prima e nessuna riga di consenso viene scritta: non si fabbrica una firma che nessuno ha dato.",
+                "anyOf": [
+                  {
+                    "additionalProperties": false,
+                    "type": "object",
+                    "required": [
+                      "accepted_document",
+                      "accepted_version"
+                    ],
+                    "properties": {
+                      "accepted_document": {
+                        "description": "Il documento che si dichiara di accettare. Sul Binario A può essere solo l’art. 23 dei ToS.",
+                        "type": "string",
+                        "enum": [
+                          "referralTerms"
+                        ]
+                      },
+                      "accepted_version": {
+                        "description": "La versione LETTA dal cliente. Diversa da quella corrente ⇒ `409 PARTNER_STALE_DOCUMENT_VERSION`.",
+                        "maxLength": 20,
+                        "minLength": 1,
+                        "type": "string"
+                      }
+                    }
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            }
+          },
+          "description": "La spunta sull’art. 23 dei ToS, se il client la raccoglie. Assente ⇒ l’iscrizione avviene come prima e nessuna riga di consenso viene scritta: non si fabbrica una firma che nessuno ha dato."
+        },
         "security": [
           {
             "bearerAuth": []
@@ -170043,6 +170741,41 @@
               }
             }
           },
+          "400": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "401": {
             "description": "Errore standard del backend.",
             "content": {
@@ -170528,6 +171261,8 @@
                         "required": [
                           "id",
                           "label",
+                          "label_en",
+                          "label_it",
                           "relative_path",
                           "slug"
                         ],
@@ -170538,221 +171273,23 @@
                             "type": "string"
                           },
                           "label": {
-                            "description": "Etichetta leggibile.",
+                            "description": "Etichetta leggibile in inglese (la lingua che fa fede). Il pannello preferisce `label_en`/`label_it` secondo la lingua dell’interfaccia.",
                             "type": "string"
                           },
-                          "relative_path": {
-                            "description": "Percorso relativo servito dal redirector.",
-                            "type": "string"
-                          },
-                          "slug": {
-                            "description": "Slug della destinazione nel catalogo.",
-                            "type": "string"
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "401": {
-            "description": "Errore standard del backend.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "Errore standard del backend.",
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "code": {
-                      "description": "Codice macchina dell’errore, quando disponibile.",
-                      "type": "string"
-                    },
-                    "error": {
-                      "description": "Etichetta breve dell’errore.",
-                      "type": "string"
-                    },
-                    "message": {
-                      "description": "Messaggio leggibile.",
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "description": "Codice di stato HTTP ripetuto nel corpo.",
-                      "type": "integer"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "403": {
-            "description": "Errore standard del backend.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "Errore standard del backend.",
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "code": {
-                      "description": "Codice macchina dell’errore, quando disponibile.",
-                      "type": "string"
-                    },
-                    "error": {
-                      "description": "Etichetta breve dell’errore.",
-                      "type": "string"
-                    },
-                    "message": {
-                      "description": "Messaggio leggibile.",
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "description": "Codice di stato HTTP ripetuto nel corpo.",
-                      "type": "integer"
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/api/v1/partner/links": {
-      "get": {
-        "operationId": "listPartnerLinks",
-        "summary": "Varianti di link del partner",
-        "tags": [
-          "partner"
-        ],
-        "description": "Varianti del partner. Le archiviate escono solo con `include_archived=true`.",
-        "parameters": [
-          {
-            "schema": {
-              "type": "boolean"
-            },
-            "in": "query",
-            "name": "include_archived",
-            "required": false,
-            "description": "Includi le varianti archiviate."
-          }
-        ],
-        "security": [
-          {
-            "bearerAuth": []
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Varianti del partner, massimo 25 attive.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "Varianti del partner, massimo 25 attive.",
-                  "type": "object",
-                  "required": [
-                    "rows"
-                  ],
-                  "properties": {
-                    "rows": {
-                      "description": "Varianti del partner.",
-                      "type": "array",
-                      "items": {
-                        "additionalProperties": false,
-                        "description": "Una variante di link del partner.",
-                        "type": "object",
-                        "required": [
-                          "archived",
-                          "destination_id",
-                          "id",
-                          "is_default",
-                          "name",
-                          "slug",
-                          "url",
-                          "utm_campaign",
-                          "utm_content",
-                          "utm_medium",
-                          "utm_source"
-                        ],
-                        "properties": {
-                          "archived": {
-                            "description": "Archiviata. Le varianti non si cancellano: orfanerebbero i click storici.",
-                            "type": "boolean"
-                          },
-                          "destination_id": {
-                            "description": "Destinazione del catalogo curato.",
-                            "format": "uuid",
+                          "label_en": {
+                            "description": "Etichetta in inglese.",
                             "type": "string"
                           },
-                          "id": {
-                            "description": "Id della variante.",
-                            "format": "uuid",
+                          "label_it": {
+                            "description": "Etichetta in italiano.",
                             "type": "string"
                           },
-                          "is_default": {
-                            "description": "Variante di default del partner.",
-                            "type": "boolean"
-                          },
-                          "name": {
-                            "description": "Nome scelto dal partner.",
+                          "relative_path": {
+                            "description": "Percorso relativo servito dal redirector.",
                             "type": "string"
                           },
                           "slug": {
-                            "description": "Slug pubblico della variante. `null` solo per le varianti create prima di D7.5, che non hanno un alias proprio.",
-                            "anyOf": [
-                              {
-                                "type": "string"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "url": {
-                            "description": "URL pubblico della variante, già risolto dal server. Il client non lo compone mai (§12.2).",
-                            "anyOf": [
-                              {
-                                "type": "string"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "utm_campaign": {
-                            "description": "UTM campagna della variante: quello chiesto in creazione, normalizzato, oppure quello derivato dal nome quando non è stato chiesto.",
-                            "type": "string"
-                          },
-                          "utm_content": {
-                            "description": "UTM content, quando presente.",
-                            "anyOf": [
-                              {
-                                "type": "string"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "utm_medium": {
-                            "description": "UTM medium generato da Wevion.",
-                            "type": "string"
-                          },
-                          "utm_source": {
-                            "description": "UTM source generato da Wevion.",
+                            "description": "Slug della destinazione nel catalogo.",
                             "type": "string"
                           }
                         }
@@ -170763,41 +171300,247 @@
               }
             }
           },
-          "400": {
-            "description": "Errore standard del backend.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "additionalProperties": false,
-                  "description": "Errore standard del backend.",
-                  "type": "object",
-                  "required": [
-                    "error",
-                    "message",
-                    "statusCode"
-                  ],
-                  "properties": {
-                    "code": {
-                      "description": "Codice macchina dell’errore, quando disponibile.",
-                      "type": "string"
-                    },
-                    "error": {
-                      "description": "Etichetta breve dell’errore.",
-                      "type": "string"
-                    },
-                    "message": {
-                      "description": "Messaggio leggibile.",
-                      "type": "string"
-                    },
-                    "statusCode": {
-                      "description": "Codice di stato HTTP ripetuto nel corpo.",
-                      "type": "integer"
-                    }
-                  }
-                }
-              }
-            }
-          },
+          "401": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/partner/links": {
+      "get": {
+        "operationId": "listPartnerLinks",
+        "summary": "Varianti di link del partner",
+        "tags": [
+          "partner"
+        ],
+        "description": "Varianti del partner. Le archiviate escono solo con `include_archived=true`.",
+        "parameters": [
+          {
+            "schema": {
+              "type": "boolean"
+            },
+            "in": "query",
+            "name": "include_archived",
+            "required": false,
+            "description": "Includi le varianti archiviate."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Varianti del partner, massimo 25 attive.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Varianti del partner, massimo 25 attive.",
+                  "type": "object",
+                  "required": [
+                    "rows"
+                  ],
+                  "properties": {
+                    "rows": {
+                      "description": "Varianti del partner.",
+                      "type": "array",
+                      "items": {
+                        "additionalProperties": false,
+                        "description": "Una variante di link del partner.",
+                        "type": "object",
+                        "required": [
+                          "archived",
+                          "destination_id",
+                          "id",
+                          "is_default",
+                          "name",
+                          "slug",
+                          "url",
+                          "utm_campaign",
+                          "utm_content",
+                          "utm_medium",
+                          "utm_source"
+                        ],
+                        "properties": {
+                          "archived": {
+                            "description": "Archiviata. Le varianti non si cancellano: orfanerebbero i click storici.",
+                            "type": "boolean"
+                          },
+                          "destination_id": {
+                            "description": "Destinazione del catalogo curato.",
+                            "format": "uuid",
+                            "type": "string"
+                          },
+                          "id": {
+                            "description": "Id della variante.",
+                            "format": "uuid",
+                            "type": "string"
+                          },
+                          "is_default": {
+                            "description": "Variante di default del partner.",
+                            "type": "boolean"
+                          },
+                          "name": {
+                            "description": "Nome scelto dal partner.",
+                            "type": "string"
+                          },
+                          "slug": {
+                            "description": "Slug pubblico della variante. `null` solo per le varianti create prima di D7.5, che non hanno un alias proprio.",
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "url": {
+                            "description": "URL pubblico della variante, già risolto dal server. Il client non lo compone mai (§12.2).",
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "utm_campaign": {
+                            "description": "UTM campagna della variante: quello chiesto in creazione, normalizzato, oppure quello derivato dal nome quando non è stato chiesto.",
+                            "type": "string"
+                          },
+                          "utm_content": {
+                            "description": "UTM content, quando presente.",
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "utm_medium": {
+                            "description": "UTM medium generato da Wevion.",
+                            "type": "string"
+                          },
+                          "utm_source": {
+                            "description": "UTM source generato da Wevion.",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "401": {
             "description": "Errore standard del backend.",
             "content": {
@@ -174390,6 +175133,12 @@
                     "tiktok"
                   ]
                 },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
+                },
                 {
                   "type": "string",
                   "enum": [
@@ -180688,6 +181437,119 @@
         }
       }
     },
+    "/api/v1/public/trial-offer": {
+      "get": {
+        "operationId": "getPublicTrialOffer",
+        "summary": "Offerta di prova gratuita di listino",
+        "tags": [
+          "public"
+        ],
+        "description": "Durata della prova gratuita e piani che la offrono. Rotta PUBBLICA: la legge la pagina di registrazione, dove una sessione non esiste ancora e `GET /billing/plans` non è raggiungibile. Risponde attraverso la stessa funzione che concede il trial al checkout, così la pagina di iscrizione non può promettere una prova che il backend non darebbe. Non dice nulla sull'eleggibilità di chi guarda: quella è `trial_eligible`, dentro l'app.",
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "days",
+                    "plans"
+                  ],
+                  "properties": {
+                    "days": {
+                      "description": "Durata della prova in giorni. 0 quando nessun piano di listino ne offre una.",
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    "plans": {
+                      "description": "Nomi visualizzati dei piani pubblicati che offrono la prova, in ordine di listino. Vuoto quando `days` è 0.",
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "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"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/rbac/access-groups": {
       "get": {
         "operationId": "getApiV1RbacAccessGroups",
@@ -186207,6 +187069,12 @@
                         "enum": [
                           "outbrain"
                         ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "exoclick"
+                        ]
                       }
                     ]
                   },
@@ -293460,6 +294328,12 @@
                   "enum": [
                     "outbrain"
                   ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "exoclick"
+                  ]
                 }
               ]
             },
@@ -318454,6 +319328,1690 @@
         }
       }
     },
+    "/api/v1/exoclick/connect-token": {
+      "post": {
+        "operationId": "exoclickConnectToken",
+        "summary": "Connect ExoClick via pasted API token (no OAuth)",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "Validates a manually-pasted ExoClick API token against GET /user, then persists it for the current session, stamping the destination workspace team (x-team-id header or active team scope — 400 SCOPE_TEAM_REQUIRED without it). ExoClick has no advertiser entity, so a single synthetic ad account is created from the token's user. An account already assigned to another workspace of the organization answers 409 ACCOUNT_ALREADY_ASSIGNED unless confirm_move=true. Goals (ExoClick's conversion primitive) are imported in the same call.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "api_token"
+                ],
+                "properties": {
+                  "api_token": {
+                    "minLength": 16,
+                    "description": "Durable ExoClick API token, created by the buyer under Profile → API tokens.",
+                    "type": "string"
+                  },
+                  "confirm_move": {
+                    "description": "Confirm moving an account already assigned to another workspace of the organization into the active one (409 ACCOUNT_ALREADY_ASSIGNED otherwise). The move reassigns every row of the account and re-stamps its historical analytics.",
+                    "type": "boolean"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "success",
+                    "account",
+                    "goals_synced"
+                  ],
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    },
+                    "account": {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "id",
+                        "name",
+                        "currency",
+                        "timezone"
+                      ],
+                      "properties": {
+                        "id": {
+                          "description": "ExoClick user id — the synthetic ad account identifier.",
+                          "type": "string"
+                        },
+                        "name": {
+                          "type": "string"
+                        },
+                        "currency": {
+                          "type": "string"
+                        },
+                        "timezone": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "goals_synced": {
+                      "description": "Number of ExoClick goals imported as conversion primitives.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Explicit destination workspace required: send the x-team-id header or activate a team scope for this operation.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "Explicit destination workspace required: send the x-team-id header or activate a team scope for this operation.",
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "SCOPE_TEAM_REQUIRED"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The external ad account is already assigned to another workspace of your organization. Retry with confirm_move=true to move it (and its historical analytics) into the active workspace.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The external ad account is already assigned to another workspace of your organization. Retry with confirm_move=true to move it (and its historical analytics) into the active workspace.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message",
+                    "code",
+                    "current_team_id",
+                    "current_workspace_name",
+                    "external_account_id",
+                    "platform"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string",
+                      "enum": [
+                        "ACCOUNT_ALREADY_ASSIGNED"
+                      ]
+                    },
+                    "current_team_id": {
+                      "format": "uuid",
+                      "type": "string"
+                    },
+                    "current_workspace_name": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "external_account_id": {
+                      "type": "string"
+                    },
+                    "platform": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/exoclick/ad-accounts": {
+      "get": {
+        "operationId": "exoclickListAdAccounts",
+        "summary": "List connected ExoClick ad accounts",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "Returns the ExoClick accounts stored for the active workspace. ExoClick has no advertiser entity, so this list holds at most one synthetic row per connected token; it exists so Asset Hub, plan quotas and the Ads Manager filters have an account to hang off.",
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "items",
+                    "total"
+                  ],
+                  "properties": {
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "additionalProperties": false,
+                        "type": "object",
+                        "required": [
+                          "id",
+                          "external_account_id",
+                          "name",
+                          "currency",
+                          "timezone",
+                          "account_status",
+                          "connected"
+                        ],
+                        "properties": {
+                          "id": {
+                            "description": "Internal row id.",
+                            "type": "string"
+                          },
+                          "external_account_id": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "currency": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "timezone": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "account_status": {
+                            "type": "string"
+                          },
+                          "connected": {
+                            "type": "boolean"
+                          }
+                        }
+                      }
+                    },
+                    "total": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/exoclick/ad-accounts/sync": {
+      "post": {
+        "operationId": "exoclickSyncAdAccounts",
+        "summary": "Re-validate the ExoClick token and refresh its goals",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "Re-probes GET /user with the stored token and refreshes the goal list. There is nothing else to enumerate: ExoClick exposes exactly one account per token. A token the API now rejects is marked invalid so the UI can ask for a re-paste instead of failing silently on the next sync.",
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "success",
+                    "goals_synced"
+                  ],
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    },
+                    "goals_synced": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/exoclick/goals": {
+      "get": {
+        "operationId": "exoclickListGoals",
+        "summary": "List ExoClick goals (the platform’s pixel equivalent)",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "Returns the goals stored for the active workspace. A goal is what an ExoClick conversion is counted against, so the launch wizard needs one before it can bid on conversions. A goal of type 0 (No Value) never carries revenue and must not be offered for ROAS bidding.",
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "items",
+                    "total"
+                  ],
+                  "properties": {
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "additionalProperties": false,
+                        "type": "object",
+                        "required": [
+                          "id",
+                          "goal_id",
+                          "name",
+                          "goal_type"
+                        ],
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "goal_id": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "goal_type": {
+                            "description": "0 = No Value (never carries revenue), 1 = Fixed, 2 = Dynamic.",
+                            "anyOf": [
+                              {
+                                "type": "integer"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    },
+                    "total": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/exoclick/toggle-account": {
+      "post": {
+        "operationId": "exoclickToggleAccount",
+        "summary": "Enable or disable an ExoClick ad account",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "Flips the Asset Hub `connected` flag for one ExoClick account. Disabling stops insight collection for it without revoking the token; use POST /api/v1/exoclick/disconnect to drop the credential entirely.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "account_id",
+                  "enabled"
+                ],
+                "properties": {
+                  "account_id": {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "enabled": {
+                    "type": "boolean"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "success"
+                  ],
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/exoclick/campaigns/{campaignId}/status": {
+      "post": {
+        "operationId": "exoclickUpdateCampaignStatus",
+        "summary": "Play or pause an ExoClick campaign",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "Routes to PUT /campaigns/play or /campaigns/pause. ExoClick exposes no per-campaign status endpoint: both are bulk routes taking an array of ids, and this operation sends an array of one.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "status"
+                ],
+                "properties": {
+                  "status": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "ACTIVE"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "PAUSED"
+                        ]
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "in": "path",
+            "name": "campaignId",
+            "required": true
+          },
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "success"
+                  ],
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/exoclick/campaigns/{campaignId}/variations/{variationId}/status": {
+      "post": {
+        "operationId": "exoclickUpdateVariationStatus",
+        "summary": "Play or pause an ExoClick variation (the ad)",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "A variation is ExoClick’s ad, and its status route is nested under the owning campaign — which is why the campaign id is part of the path rather than resolved server-side from the ad id alone.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "status"
+                ],
+                "properties": {
+                  "status": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "ACTIVE"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "PAUSED"
+                        ]
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "in": "path",
+            "name": "campaignId",
+            "required": true
+          },
+          {
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "in": "path",
+            "name": "variationId",
+            "required": true
+          },
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "success"
+                  ],
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/exoclick/campaigns/{campaignId}/budget": {
+      "post": {
+        "operationId": "exoclickUpdateCampaignBudget",
+        "summary": "Update an ExoClick campaign budget",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "Updates the daily cap and/or the lifetime cap via PUT /campaigns/{id}. A daily cap is always sent together with daily_limit_type=1: ExoClick does not enforce a budget whose limit type is unset, so sending the amount alone silently does nothing.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "minProperties": 1,
+                "type": "object",
+                "properties": {
+                  "max_daily_budget": {
+                    "exclusiveMinimum": 0,
+                    "description": "Daily cap in account currency. Sent with daily_limit_type=1, or ExoClick does not enforce it.",
+                    "type": "number"
+                  },
+                  "total_budget_limit": {
+                    "exclusiveMinimum": 0,
+                    "type": "number"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "in": "path",
+            "name": "campaignId",
+            "required": true
+          },
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "success"
+                  ],
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/exoclick/disconnect": {
+      "post": {
+        "operationId": "exoclickDisconnect",
+        "summary": "Disconnect ExoClick",
+        "tags": [
+          "exoclick"
+        ],
+        "description": "Revokes the stored token and soft-deletes the ExoClick account and its platform_connection mirror. Historical insight rows are kept: disconnecting a source must not erase the spend already reported for it.",
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "success"
+                  ],
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/google/insights/backfill": {
       "post": {
         "operationId": "googleSyncInsights",
@@ -320297,7 +322855,7 @@
         "tags": [
           "health"
         ],
-        "description": "Returns overall service status plus a live DB round-trip latency sample. `status` is `healthy` when the DB responds in <5s, `degraded` when slower, `unhealthy` when unreachable. Used by monitoring dashboards and alerting - NOT the K8s readiness probe (see `/ready`).",
+        "description": "Returns overall service status plus a live DB round-trip latency sample. `status` is `healthy` when the DB responds in <5s, `degraded` when slower, `unhealthy` when unreachable. `version` is the global app release this process was built from (`dev` outside the deploy pipeline). Used by monitoring dashboards and alerting - NOT the K8s readiness probe (see `/ready`).",
         "responses": {
           "200": {
             "description": "Successful response",
@@ -320307,6 +322865,7 @@
                   "type": "object",
                   "required": [
                     "status",
+                    "version",
                     "timestamp",
                     "uptimeMs",
                     "db"
@@ -320334,6 +322893,9 @@
                         }
                       ]
                     },
+                    "version": {
+                      "type": "string"
+                    },
                     "timestamp": {
                       "format": "date-time",
                       "type": "string"
@@ -320402,6 +322964,7 @@
                   "type": "object",
                   "required": [
                     "status",
+                    "version",
                     "timestamp",
                     "uptimeMs",
                     "db"
@@ -320429,6 +322992,9 @@
                         }
                       ]
                     },
+                    "version": {
+                      "type": "string"
+                    },
                     "timestamp": {
                       "format": "date-time",
                       "type": "string"