@wevion/cli 1.0.3920 → 1.0.3923

package/openapi.json

@@ -323884,6 +323884,7 @@
                     "type": "string"
                   },
                   "white_page_id": {
+                    "description": "Shield landing page shown to bots and to the suspect cohort. Must be a landing page with page_kind \"safe\"; a flow (money) page is rejected with 400.",
                     "anyOf": [
                       {
                         "format": "uuid",
@@ -325077,6 +325078,7 @@
                     "type": "string"
                   },
                   "white_page_id": {
+                    "description": "Shield landing page shown to bots and to the suspect cohort. Must be a landing page with page_kind \"safe\"; a flow (money) page is rejected with 400.",
                     "anyOf": [
                       {
                         "format": "uuid",
@@ -326521,6 +326523,7 @@
                           "type": "boolean"
                         },
                         "black_page_id": {
+                          "description": "Flow primary (money) page served to a HUMAN visitor. Must be a landing page with page_kind \"money\"; a shield page is rejected with 400.",
                           "anyOf": [
                             {
                               "format": "uuid",
@@ -326753,6 +326756,7 @@
                     }
                   },
                   "white_page_id": {
+                    "description": "Shield landing page shown to bots and to the suspect cohort. Must be a landing page with page_kind \"safe\"; a flow (money) page is rejected with 400.",
                     "anyOf": [
                       {
                         "format": "uuid",
@@ -327918,7 +327922,7 @@
         "tags": [
           "traffic-filter"
         ],
-        "description": "Returns a paginated, team-scoped list of click rows. All filters are optional: campaign_id, verdict, country, device_type, dateFrom, dateTo, limit (default 50), offset.",
+        "description": "Returns a paginated, team-scoped list of click rows. All filters are optional: campaign_id, verdict, served_page_kind ('safe' | 'money' | 'offer'), country, device_type, dateFrom, dateTo, limit (default 50), offset.",
         "parameters": [
           {
             "schema": {
@@ -327938,6 +327942,16 @@
             "name": "verdict",
             "required": false
           },
+          {
+            "schema": {
+              "maxLength": 40,
+              "type": "string"
+            },
+            "in": "query",
+            "name": "served_page_kind",
+            "required": false,
+            "description": "Keep only clicks served that page: 'safe', 'money' or 'offer'."
+          },
           {
             "schema": {
               "maxLength": 10,
@@ -328090,6 +328104,7 @@
                           "os",
                           "browser",
                           "referrer",
+                          "servedPageKind",
                           "isUnique",
                           "subId1",
                           "subId2",
@@ -328261,6 +328276,17 @@
                               }
                             ]
                           },
+                          "servedPageKind": {
+                            "description": "Page actually served to the visitor: 'safe', 'money' or 'offer'. Null on legacy clicks.",
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
                           "isUnique": {
                             "type": "boolean"
                           },
@@ -328453,7 +328479,7 @@
         "tags": [
           "traffic-filter"
         ],
-        "description": "Returns matching click rows as a CSV download. Accepts the same filters as /clicks (campaign_id, verdict, country, device_type, dateFrom, dateTo). Capped at 50k rows.",
+        "description": "Returns matching click rows as a CSV download. Accepts the same filters as /clicks (campaign_id, verdict, served_page_kind, country, device_type, dateFrom, dateTo). Capped at 50k rows.",
         "parameters": [
           {
             "schema": {
@@ -328473,6 +328499,16 @@
             "name": "verdict",
             "required": false
           },
+          {
+            "schema": {
+              "maxLength": 40,
+              "type": "string"
+            },
+            "in": "query",
+            "name": "served_page_kind",
+            "required": false,
+            "description": "Keep only clicks served that page: 'safe', 'money' or 'offer'."
+          },
           {
             "schema": {
               "maxLength": 10,
@@ -328675,6 +328711,7 @@
                         "subId10",
                         "currency",
                         "cost",
+                        "servedPageKind",
                         "isUnique",
                         "createdAt"
                       ],
@@ -328994,6 +329031,17 @@
                             }
                           ]
                         },
+                        "servedPageKind": {
+                          "description": "Page actually served to the visitor: 'safe', 'money' or 'offer'. Null on legacy clicks.",
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
                         "isUnique": {
                           "type": "boolean"
                         },
@@ -330423,7 +330471,8 @@
                           "verificationRecordName",
                           "verificationRecordValue",
                           "ownershipVerifiedAt",
-                          "createdAt"
+                          "createdAt",
+                          "isTestDomain"
                         ],
                         "properties": {
                           "id": {
@@ -330528,6 +330577,10 @@
                           },
                           "campaignCount": {
                             "type": "number"
+                          },
+                          "isTestDomain": {
+                            "description": "True for a throwaway platform host issued for testing. It sits on shared infrastructure and must not carry real traffic.",
+                            "type": "boolean"
                           }
                         }
                       }
@@ -330752,7 +330805,8 @@
                     "verificationRecordName",
                     "verificationRecordValue",
                     "ownershipVerifiedAt",
-                    "createdAt"
+                    "createdAt",
+                    "isTestDomain"
                   ],
                   "properties": {
                     "id": {
@@ -330857,6 +330911,10 @@
                     },
                     "campaignCount": {
                       "type": "number"
+                    },
+                    "isTestDomain": {
+                      "description": "True for a throwaway platform host issued for testing. It sits on shared infrastructure and must not carry real traffic.",
+                      "type": "boolean"
                     }
                   }
                 }
@@ -331140,7 +331198,8 @@
                     "verificationRecordName",
                     "verificationRecordValue",
                     "ownershipVerifiedAt",
-                    "createdAt"
+                    "createdAt",
+                    "isTestDomain"
                   ],
                   "properties": {
                     "id": {
@@ -331245,6 +331304,10 @@
                     },
                     "campaignCount": {
                       "type": "number"
+                    },
+                    "isTestDomain": {
+                      "description": "True for a throwaway platform host issued for testing. It sits on shared infrastructure and must not carry real traffic.",
+                      "type": "boolean"
                     }
                   }
                 }
@@ -331487,7 +331550,8 @@
                     "verificationRecordName",
                     "verificationRecordValue",
                     "ownershipVerifiedAt",
-                    "createdAt"
+                    "createdAt",
+                    "isTestDomain"
                   ],
                   "properties": {
                     "id": {
@@ -331592,6 +331656,10 @@
                     },
                     "campaignCount": {
                       "type": "number"
+                    },
+                    "isTestDomain": {
+                      "description": "True for a throwaway platform host issued for testing. It sits on shared infrastructure and must not carry real traffic.",
+                      "type": "boolean"
                     }
                   }
                 }
@@ -332271,7 +332339,8 @@
                     "verificationRecordName",
                     "verificationRecordValue",
                     "ownershipVerifiedAt",
-                    "createdAt"
+                    "createdAt",
+                    "isTestDomain"
                   ],
                   "properties": {
                     "id": {
@@ -332376,6 +332445,10 @@
                     },
                     "campaignCount": {
                       "type": "number"
+                    },
+                    "isTestDomain": {
+                      "description": "True for a throwaway platform host issued for testing. It sits on shared infrastructure and must not carry real traffic.",
+                      "type": "boolean"
                     }
                   }
                 }
@@ -332558,24 +332631,49 @@
         }
       }
     },
-    "/api/v1/traffic-filter/domains/{id}/verify": {
+    "/api/v1/traffic-filter/domains/platform-subdomain/test": {
       "post": {
-        "operationId": "postApiV1TrafficFilterDomainsByIdVerify",
-        "summary": "Verify a Traffic Filter domain",
+        "operationId": "postApiV1TrafficFilterDomainsPlatformSubdomainTest",
+        "summary": "Issue a test-only subdomain",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Activates a direct A-record only after its TXT ownership challenge is proven. An exact team-owned Cloudflare zone or an in-app NameSilo purchase is accepted as server-side ownership proof.",
+        "description": "Issues a ready-to-use throwaway subdomain under the platform base suffix, with a server-generated label and no DNS setup, so a campaign can be assembled without owning a domain. The host sits on shared platform infrastructure: it is flagged isTestDomain and must never carry production traffic. Requires acknowledge_testing_only:true.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "acknowledge_testing_only"
+                ],
+                "properties": {
+                  "acknowledge_testing_only": {
+                    "description": "Must be true: the caller states the host will only be used for testing.",
+                    "type": "boolean",
+                    "enum": [
+                      true
+                    ]
+                  },
+                  "team_id": {
+                    "anyOf": [
+                      {
+                        "format": "uuid",
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
         "parameters": [
-          {
-            "schema": {
-              "format": "uuid",
-              "type": "string"
-            },
-            "in": "path",
-            "name": "id",
-            "required": true
-          },
           {
             "schema": {
               "format": "uuid",
@@ -332596,37 +332694,56 @@
           }
         ],
         "responses": {
-          "200": {
-            "description": "Successful response",
+          "201": {
+            "description": "Resource created",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "object",
                   "required": [
                     "id",
+                    "teamId",
                     "domain",
+                    "importMethod",
                     "status",
-                    "verified",
-                    "message"
+                    "zoneId",
+                    "nameservers",
+                    "serverIp",
+                    "expiresAt",
+                    "errorMessage",
+                    "verificationToken",
+                    "verificationRecordName",
+                    "verificationRecordValue",
+                    "ownershipVerifiedAt",
+                    "createdAt",
+                    "isTestDomain"
                   ],
                   "properties": {
                     "id": {
                       "format": "uuid",
                       "type": "string"
                     },
-                    "domain": {
+                    "teamId": {
+                      "format": "uuid",
                       "type": "string"
                     },
-                    "status": {
+                    "domain": {
                       "type": "string"
                     },
-                    "verified": {
-                      "type": "boolean"
+                    "importMethod": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
                     },
-                    "message": {
+                    "status": {
                       "type": "string"
                     },
-                    "resolvedIp": {
+                    "zoneId": {
                       "anyOf": [
                         {
                           "type": "string"
@@ -332636,11 +332753,16 @@
                         }
                       ]
                     },
-                    "resolvedIps": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
+                    "nameservers": {
+                      "anyOf": [
+                        {
+                          "$comment": "json-value",
+                          "description": "Arbitrary JSON value with nested arrays and objects."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
                     },
                     "serverIp": {
                       "anyOf": [
@@ -332652,87 +332774,57 @@
                         }
                       ]
                     },
-                    "viaCloudflare": {
-                      "type": "boolean"
-                    },
-                    "txtVerified": {
-                      "type": "boolean"
-                    },
-                    "verificationRecordName": {
-                      "type": "string"
-                    },
-                    "verificationRecordValue": {
-                      "type": "string"
+                    "expiresAt": {
+                      "anyOf": [
+                        {
+                          "format": "date-time",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
                     },
-                    "dnsRecords": {
+                    "errorMessage": {
                       "anyOf": [
                         {
-                          "type": "array",
-                          "items": {
-                            "type": "object",
-                            "required": [
-                              "recordId",
-                              "type",
-                              "host",
-                              "value",
-                              "ttl",
-                              "distance"
-                            ],
-                            "properties": {
-                              "recordId": {
-                                "type": "string"
-                              },
-                              "type": {
-                                "type": "string"
-                              },
-                              "host": {
-                                "type": "string"
-                              },
-                              "value": {
-                                "type": "string"
-                              },
-                              "ttl": {
-                                "type": "number"
-                              },
-                              "distance": {
-                                "type": "number"
-                              }
-                            }
-                          }
+                          "type": "string"
                         },
                         {
                           "type": "null"
                         }
                       ]
                     },
-                    "availability": {
+                    "verificationToken": {
+                      "type": "string"
+                    },
+                    "verificationRecordName": {
+                      "type": "string"
+                    },
+                    "verificationRecordValue": {
+                      "type": "string"
+                    },
+                    "ownershipVerifiedAt": {
                       "anyOf": [
                         {
-                          "type": "object",
-                          "required": [
-                            "available",
-                            "price"
-                          ],
-                          "properties": {
-                            "available": {
-                              "type": "boolean"
-                            },
-                            "price": {
-                              "anyOf": [
-                                {
-                                  "type": "number"
-                                },
-                                {
-                                  "type": "null"
-                                }
-                              ]
-                            }
-                          }
+                          "format": "date-time",
+                          "type": "string"
                         },
                         {
                           "type": "null"
                         }
                       ]
+                    },
+                    "createdAt": {
+                      "format": "date-time",
+                      "type": "string"
+                    },
+                    "campaignCount": {
+                      "type": "number"
+                    },
+                    "isTestDomain": {
+                      "description": "True for a throwaway platform host issued for testing. It sits on shared infrastructure and must not carry real traffic.",
+                      "type": "boolean"
                     }
                   }
                 }
@@ -332832,8 +332924,8 @@
               }
             }
           },
-          "404": {
-            "description": "Resource not found",
+          "409": {
+            "description": "Conflict - resource state prevents the operation",
             "content": {
               "application/json": {
                 "schema": {
@@ -332915,23 +333007,22 @@
         }
       }
     },
-    "/api/v1/traffic-filter/domains/check-availability": {
-      "get": {
-        "operationId": "getApiV1TrafficFilterDomainsCheckAvailability",
-        "summary": "Check domain availability",
+    "/api/v1/traffic-filter/domains/{id}/verify": {
+      "post": {
+        "operationId": "postApiV1TrafficFilterDomainsByIdVerify",
+        "summary": "Verify a Traffic Filter domain",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Checks whether a domain is available for registration via Namesilo.",
+        "description": "Activates a direct A-record only after its TXT ownership challenge is proven. An exact team-owned Cloudflare zone or an in-app NameSilo purchase is accepted as server-side ownership proof.",
         "parameters": [
           {
             "schema": {
-              "minLength": 1,
-              "maxLength": 255,
+              "format": "uuid",
               "type": "string"
             },
-            "in": "query",
-            "name": "domain",
+            "in": "path",
+            "name": "id",
             "required": true
           },
           {
@@ -332961,18 +333052,136 @@
                 "schema": {
                   "type": "object",
                   "required": [
+                    "id",
                     "domain",
-                    "available"
+                    "status",
+                    "verified",
+                    "message"
                   ],
                   "properties": {
+                    "id": {
+                      "format": "uuid",
+                      "type": "string"
+                    },
                     "domain": {
                       "type": "string"
                     },
-                    "available": {
+                    "status": {
+                      "type": "string"
+                    },
+                    "verified": {
                       "type": "boolean"
                     },
-                    "price": {
-                      "type": "number"
+                    "message": {
+                      "type": "string"
+                    },
+                    "resolvedIp": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "resolvedIps": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "serverIp": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "viaCloudflare": {
+                      "type": "boolean"
+                    },
+                    "txtVerified": {
+                      "type": "boolean"
+                    },
+                    "verificationRecordName": {
+                      "type": "string"
+                    },
+                    "verificationRecordValue": {
+                      "type": "string"
+                    },
+                    "dnsRecords": {
+                      "anyOf": [
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "required": [
+                              "recordId",
+                              "type",
+                              "host",
+                              "value",
+                              "ttl",
+                              "distance"
+                            ],
+                            "properties": {
+                              "recordId": {
+                                "type": "string"
+                              },
+                              "type": {
+                                "type": "string"
+                              },
+                              "host": {
+                                "type": "string"
+                              },
+                              "value": {
+                                "type": "string"
+                              },
+                              "ttl": {
+                                "type": "number"
+                              },
+                              "distance": {
+                                "type": "number"
+                              }
+                            }
+                          }
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "availability": {
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "required": [
+                            "available",
+                            "price"
+                          ],
+                          "properties": {
+                            "available": {
+                              "type": "boolean"
+                            },
+                            "price": {
+                              "anyOf": [
+                                {
+                                  "type": "number"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            }
+                          }
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
                     }
                   }
                 }
@@ -333072,18 +333281,8 @@
               }
             }
           },
-          "429": {
-            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/RateLimitedResponse"
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Internal server error",
+          "404": {
+            "description": "Resource not found",
             "content": {
               "application/json": {
                 "schema": {
@@ -333108,8 +333307,18 @@
               }
             }
           },
-          "502": {
-            "description": "Bad gateway - upstream provider failed",
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
             "content": {
               "application/json": {
                 "schema": {
@@ -333153,41 +333362,27 @@
             }
           }
         }
-      },
-      "post": {
-        "operationId": "postApiV1TrafficFilterDomainsCheckAvailability",
-        "summary": "Bulk check domain availability",
+      }
+    },
+    "/api/v1/traffic-filter/domains/check-availability": {
+      "get": {
+        "operationId": "getApiV1TrafficFilterDomainsCheckAvailability",
+        "summary": "Check domain availability",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Checks availability for multiple domains via Namesilo (max 20).",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "additionalProperties": false,
-                "type": "object",
-                "required": [
-                  "domains"
-                ],
-                "properties": {
-                  "domains": {
-                    "minItems": 1,
-                    "maxItems": 20,
-                    "type": "array",
-                    "items": {
-                      "minLength": 1,
-                      "maxLength": 255,
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          }
-        },
+        "description": "Checks whether a domain is available for registration via Namesilo.",
         "parameters": [
+          {
+            "schema": {
+              "minLength": 1,
+              "maxLength": 255,
+              "type": "string"
+            },
+            "in": "query",
+            "name": "domain",
+            "required": true
+          },
           {
             "schema": {
               "format": "uuid",
@@ -333215,46 +333410,24 @@
                 "schema": {
                   "type": "object",
                   "required": [
-                    "results"
+                    "domain",
+                    "available"
                   ],
                   "properties": {
-                    "results": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "required": [
-                          "domain",
-                          "available",
-                          "price"
-                        ],
-                        "properties": {
-                          "domain": {
-                            "type": "string"
-                          },
-                          "available": {
-                            "type": "boolean"
-                          },
-                          "price": {
-                            "anyOf": [
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "error": {
-                            "type": "string"
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          },
+                    "domain": {
+                      "type": "string"
+                    },
+                    "available": {
+                      "type": "boolean"
+                    },
+                    "price": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "400": {
             "description": "Invalid request - schema validation failed",
             "content": {
@@ -333384,6 +333557,32 @@
               }
             }
           },
+          "502": {
+            "description": "Bad gateway - upstream provider failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "503": {
             "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
             "headers": {
@@ -333403,16 +333602,14 @@
             }
           }
         }
-      }
-    },
-    "/api/v1/traffic-filter/domains/register": {
+      },
       "post": {
-        "operationId": "postApiV1TrafficFilterDomainsRegister",
-        "summary": "Register a domain via Namesilo",
+        "operationId": "postApiV1TrafficFilterDomainsCheckAvailability",
+        "summary": "Bulk check domain availability",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Registers a domain through Namesilo (paid). Requires confirm:true to proceed.",
+        "description": "Checks availability for multiple domains via Namesilo (max 20).",
         "requestBody": {
           "required": true,
           "content": {
@@ -333421,21 +333618,18 @@
                 "additionalProperties": false,
                 "type": "object",
                 "required": [
-                  "domain"
+                  "domains"
                 ],
                 "properties": {
-                  "domain": {
-                    "minLength": 1,
-                    "maxLength": 255,
-                    "type": "string"
-                  },
-                  "years": {
-                    "minimum": 1,
-                    "maximum": 10,
-                    "type": "integer"
-                  },
-                  "confirm": {
-                    "type": "boolean"
+                  "domains": {
+                    "minItems": 1,
+                    "maxItems": 20,
+                    "type": "array",
+                    "items": {
+                      "minLength": 1,
+                      "maxLength": 255,
+                      "type": "string"
+                    }
                   }
                 }
               }
@@ -333463,149 +333657,45 @@
           }
         ],
         "responses": {
-          "201": {
-            "description": "Resource created",
+          "200": {
+            "description": "Successful response",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "object",
                   "required": [
-                    "orderId",
-                    "domain"
+                    "results"
                   ],
                   "properties": {
-                    "orderId": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "domain": {
-                      "type": "object",
-                      "required": [
-                        "id",
-                        "teamId",
-                        "domain",
-                        "importMethod",
-                        "status",
-                        "zoneId",
-                        "nameservers",
-                        "serverIp",
-                        "expiresAt",
-                        "errorMessage",
-                        "verificationToken",
-                        "verificationRecordName",
-                        "verificationRecordValue",
-                        "ownershipVerifiedAt",
-                        "createdAt"
-                      ],
-                      "properties": {
-                        "id": {
-                          "format": "uuid",
-                          "type": "string"
-                        },
-                        "teamId": {
-                          "format": "uuid",
-                          "type": "string"
-                        },
-                        "domain": {
-                          "type": "string"
-                        },
-                        "importMethod": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "status": {
-                          "type": "string"
-                        },
-                        "zoneId": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "nameservers": {
-                          "anyOf": [
-                            {
-                              "$comment": "json-value",
-                              "description": "Arbitrary JSON value with nested arrays and objects."
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "serverIp": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "expiresAt": {
-                          "anyOf": [
-                            {
-                              "format": "date-time",
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "errorMessage": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "verificationToken": {
-                          "type": "string"
-                        },
-                        "verificationRecordName": {
-                          "type": "string"
-                        },
-                        "verificationRecordValue": {
-                          "type": "string"
-                        },
-                        "ownershipVerifiedAt": {
-                          "anyOf": [
-                            {
-                              "format": "date-time",
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ]
-                        },
-                        "createdAt": {
-                          "format": "date-time",
-                          "type": "string"
-                        },
-                        "campaignCount": {
-                          "type": "number"
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "domain",
+                          "available",
+                          "price"
+                        ],
+                        "properties": {
+                          "domain": {
+                            "type": "string"
+                          },
+                          "available": {
+                            "type": "boolean"
+                          },
+                          "price": {
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "error": {
+                            "type": "string"
+                          }
                         }
                       }
                     }
@@ -333707,70 +333797,18 @@
               }
             }
           },
-          "409": {
-            "description": "Conflict - resource state prevents the operation",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "statusCode",
-                    "error",
-                    "message"
-                  ],
-                  "properties": {
-                    "statusCode": {
-                      "type": "number"
-                    },
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "429": {
-            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/RateLimitedResponse"
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Internal server error",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "statusCode",
-                    "error",
-                    "message"
-                  ],
-                  "properties": {
-                    "statusCode": {
-                      "type": "number"
-                    },
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "502": {
-            "description": "Bad gateway - upstream provider failed",
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
             "content": {
               "application/json": {
                 "schema": {
@@ -333816,14 +333854,14 @@
         }
       }
     },
-    "/api/v1/traffic-filter/domains/import": {
+    "/api/v1/traffic-filter/domains/register": {
       "post": {
-        "operationId": "postApiV1TrafficFilterDomainsImport",
-        "summary": "Bulk import domains (A-record)",
+        "operationId": "postApiV1TrafficFilterDomainsRegister",
+        "summary": "Register a domain via Namesilo",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Inserts pending_dns rows for A-record domains (max 50). Each row must also pass its TXT ownership challenge before activation.",
+        "description": "Registers a domain through Namesilo (paid). Requires confirm:true to proceed.",
         "requestBody": {
           "required": true,
           "content": {
@@ -333832,18 +333870,21 @@
                 "additionalProperties": false,
                 "type": "object",
                 "required": [
-                  "domains"
+                  "domain"
                 ],
                 "properties": {
-                  "domains": {
-                    "minItems": 1,
-                    "maxItems": 50,
-                    "type": "array",
-                    "items": {
-                      "minLength": 1,
-                      "maxLength": 255,
-                      "type": "string"
-                    }
+                  "domain": {
+                    "minLength": 1,
+                    "maxLength": 255,
+                    "type": "string"
+                  },
+                  "years": {
+                    "minimum": 1,
+                    "maximum": 10,
+                    "type": "integer"
+                  },
+                  "confirm": {
+                    "type": "boolean"
                   }
                 }
               }
@@ -333871,27 +333912,155 @@
           }
         ],
         "responses": {
-          "200": {
-            "description": "Successful response",
+          "201": {
+            "description": "Resource created",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "object",
                   "required": [
-                    "inserted",
-                    "skipped"
+                    "orderId",
+                    "domain"
                   ],
                   "properties": {
-                    "inserted": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
+                    "orderId": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
                     },
-                    "skipped": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
+                    "domain": {
+                      "type": "object",
+                      "required": [
+                        "id",
+                        "teamId",
+                        "domain",
+                        "importMethod",
+                        "status",
+                        "zoneId",
+                        "nameservers",
+                        "serverIp",
+                        "expiresAt",
+                        "errorMessage",
+                        "verificationToken",
+                        "verificationRecordName",
+                        "verificationRecordValue",
+                        "ownershipVerifiedAt",
+                        "createdAt",
+                        "isTestDomain"
+                      ],
+                      "properties": {
+                        "id": {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        "teamId": {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        "domain": {
+                          "type": "string"
+                        },
+                        "importMethod": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "status": {
+                          "type": "string"
+                        },
+                        "zoneId": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "nameservers": {
+                          "anyOf": [
+                            {
+                              "$comment": "json-value",
+                              "description": "Arbitrary JSON value with nested arrays and objects."
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "serverIp": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "expiresAt": {
+                          "anyOf": [
+                            {
+                              "format": "date-time",
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "errorMessage": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "verificationToken": {
+                          "type": "string"
+                        },
+                        "verificationRecordName": {
+                          "type": "string"
+                        },
+                        "verificationRecordValue": {
+                          "type": "string"
+                        },
+                        "ownershipVerifiedAt": {
+                          "anyOf": [
+                            {
+                              "format": "date-time",
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "createdAt": {
+                          "format": "date-time",
+                          "type": "string"
+                        },
+                        "campaignCount": {
+                          "type": "number"
+                        },
+                        "isTestDomain": {
+                          "description": "True for a throwaway platform host issued for testing. It sits on shared infrastructure and must not carry real traffic.",
+                          "type": "boolean"
+                        }
                       }
                     }
                   }
@@ -333992,20 +334161,72 @@
               }
             }
           },
-          "429": {
-            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+          "409": {
+            "description": "Conflict - resource state prevents the operation",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/RateLimitedResponse"
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Internal server error",
-            "content": {
-              "application/json": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "502": {
+            "description": "Bad gateway - upstream provider failed",
+            "content": {
+              "application/json": {
                 "schema": {
                   "type": "object",
                   "required": [
@@ -334049,24 +334270,41 @@
         }
       }
     },
-    "/api/v1/traffic-filter/domains/{id}/auto-link-cf": {
+    "/api/v1/traffic-filter/domains/import": {
       "post": {
-        "operationId": "postApiV1TrafficFilterDomainsByIdAutoLinkCf",
-        "summary": "Auto-link a Cloudflare zone",
+        "operationId": "postApiV1TrafficFilterDomainsImport",
+        "summary": "Bulk import domains (A-record)",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Finds the Cloudflare zone for the domain and stores its zone id + nameservers.",
+        "description": "Inserts pending_dns rows for A-record domains (max 50). Each row must also pass its TXT ownership challenge before activation.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "domains"
+                ],
+                "properties": {
+                  "domains": {
+                    "minItems": 1,
+                    "maxItems": 50,
+                    "type": "array",
+                    "items": {
+                      "minLength": 1,
+                      "maxLength": 255,
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
         "parameters": [
-          {
-            "schema": {
-              "format": "uuid",
-              "type": "string"
-            },
-            "in": "path",
-            "name": "id",
-            "required": true
-          },
           {
             "schema": {
               "format": "uuid",
@@ -334094,29 +334332,21 @@
                 "schema": {
                   "type": "object",
                   "required": [
-                    "ok"
+                    "inserted",
+                    "skipped"
                   ],
                   "properties": {
-                    "ok": {
-                      "type": "boolean"
-                    },
-                    "zoneId": {
-                      "type": "string"
-                    },
-                    "nameservers": {
+                    "inserted": {
                       "type": "array",
                       "items": {
                         "type": "string"
                       }
                     },
-                    "zoneStatus": {
-                      "type": "string"
-                    },
-                    "alreadyLinked": {
-                      "type": "boolean"
-                    },
-                    "error": {
-                      "type": "string"
+                    "skipped": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
                     }
                   }
                 }
@@ -334216,32 +334446,6 @@
               }
             }
           },
-          "404": {
-            "description": "Resource not found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "statusCode",
-                    "error",
-                    "message"
-                  ],
-                  "properties": {
-                    "statusCode": {
-                      "type": "number"
-                    },
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
           "429": {
             "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
             "content": {
@@ -334299,14 +334503,14 @@
         }
       }
     },
-    "/api/v1/traffic-filter/domains/{id}/apply-cf-profile": {
+    "/api/v1/traffic-filter/domains/{id}/auto-link-cf": {
       "post": {
-        "operationId": "postApiV1TrafficFilterDomainsByIdApplyCfProfile",
-        "summary": "Apply Cloudflare hardening profile",
+        "operationId": "postApiV1TrafficFilterDomainsByIdAutoLinkCf",
+        "summary": "Auto-link a Cloudflare zone",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Applies the hardening zone settings (cache/minify/bot-fight/etc.) to the domain zone.",
+        "description": "Finds the Cloudflare zone for the domain and stores its zone id + nameservers.",
         "parameters": [
           {
             "schema": {
@@ -334350,49 +334554,21 @@
                     "ok": {
                       "type": "boolean"
                     },
-                    "domain": {
+                    "zoneId": {
                       "type": "string"
                     },
-                    "report": {
-                      "type": "object",
-                      "required": [
-                        "applied",
-                        "skipped",
-                        "errors"
-                      ],
-                      "properties": {
-                        "applied": {
-                          "type": "array",
-                          "items": {
-                            "type": "string"
-                          }
-                        },
-                        "skipped": {
-                          "type": "array",
-                          "items": {
-                            "type": "string"
-                          }
-                        },
-                        "errors": {
-                          "type": "array",
-                          "items": {
-                            "type": "object",
-                            "required": [
-                              "setting",
-                              "error"
-                            ],
-                            "properties": {
-                              "setting": {
-                                "type": "string"
-                              },
-                              "error": {
-                                "type": "string"
-                              }
-                            }
-                          }
-                        }
+                    "nameservers": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
                       }
                     },
+                    "zoneStatus": {
+                      "type": "string"
+                    },
+                    "alreadyLinked": {
+                      "type": "boolean"
+                    },
                     "error": {
                       "type": "string"
                     }
@@ -334577,15 +334753,24 @@
         }
       }
     },
-    "/api/v1/traffic-filter/domains/apply-cf-profile-all": {
+    "/api/v1/traffic-filter/domains/{id}/apply-cf-profile": {
       "post": {
-        "operationId": "postApiV1TrafficFilterDomainsApplyCfProfileAll",
-        "summary": "Apply Cloudflare hardening profile to all linked domains",
+        "operationId": "postApiV1TrafficFilterDomainsByIdApplyCfProfile",
+        "summary": "Apply Cloudflare hardening profile",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Applies the hardening profile to every domain that has a Cloudflare zone linked.",
+        "description": "Applies the hardening zone settings (cache/minify/bot-fight/etc.) to the domain zone.",
         "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "path",
+            "name": "id",
+            "required": true
+          },
           {
             "schema": {
               "format": "uuid",
@@ -334613,69 +334798,57 @@
                 "schema": {
                   "type": "object",
                   "required": [
-                    "results"
+                    "ok"
                   ],
                   "properties": {
-                    "results": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "required": [
-                          "domain",
-                          "ok"
-                        ],
-                        "properties": {
-                          "domain": {
-                            "type": "string"
-                          },
-                          "ok": {
-                            "type": "boolean"
-                          },
-                          "report": {
-                            "type": "object",
-                            "required": [
-                              "applied",
-                              "skipped",
-                              "errors"
-                            ],
-                            "properties": {
-                              "applied": {
-                                "type": "array",
-                                "items": {
-                                  "type": "string"
-                                }
-                              },
-                              "skipped": {
-                                "type": "array",
-                                "items": {
-                                  "type": "string"
-                                }
+                    "ok": {
+                      "type": "boolean"
+                    },
+                    "domain": {
+                      "type": "string"
+                    },
+                    "report": {
+                      "type": "object",
+                      "required": [
+                        "applied",
+                        "skipped",
+                        "errors"
+                      ],
+                      "properties": {
+                        "applied": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "skipped": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "errors": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "required": [
+                              "setting",
+                              "error"
+                            ],
+                            "properties": {
+                              "setting": {
+                                "type": "string"
                               },
-                              "errors": {
-                                "type": "array",
-                                "items": {
-                                  "type": "object",
-                                  "required": [
-                                    "setting",
-                                    "error"
-                                  ],
-                                  "properties": {
-                                    "setting": {
-                                      "type": "string"
-                                    },
-                                    "error": {
-                                      "type": "string"
-                                    }
-                                  }
-                                }
+                              "error": {
+                                "type": "string"
                               }
                             }
-                          },
-                          "error": {
-                            "type": "string"
                           }
                         }
                       }
+                    },
+                    "error": {
+                      "type": "string"
                     }
                   }
                 }
@@ -334775,6 +334948,32 @@
               }
             }
           },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "429": {
             "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
             "content": {
@@ -334832,61 +335031,15 @@
         }
       }
     },
-    "/api/v1/traffic-filter/domains/{id}/dns": {
+    "/api/v1/traffic-filter/domains/apply-cf-profile-all": {
       "post": {
-        "operationId": "postApiV1TrafficFilterDomainsByIdDns",
-        "summary": "Add a DNS record",
+        "operationId": "postApiV1TrafficFilterDomainsApplyCfProfileAll",
+        "summary": "Apply Cloudflare hardening profile to all linked domains",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Adds a DNS record to a Traffic Filter domain via Namesilo.",
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "additionalProperties": false,
-                "type": "object",
-                "required": [
-                  "rrtype",
-                  "rrhost",
-                  "rrvalue"
-                ],
-                "properties": {
-                  "rrtype": {
-                    "minLength": 1,
-                    "maxLength": 10,
-                    "type": "string"
-                  },
-                  "rrhost": {
-                    "maxLength": 255,
-                    "type": "string"
-                  },
-                  "rrvalue": {
-                    "minLength": 1,
-                    "maxLength": 500,
-                    "type": "string"
-                  },
-                  "rrttl": {
-                    "minimum": 60,
-                    "maximum": 2592000,
-                    "type": "integer"
-                  }
-                }
-              }
-            }
-          }
-        },
+        "description": "Applies the hardening profile to every domain that has a Cloudflare zone linked.",
         "parameters": [
-          {
-            "schema": {
-              "format": "uuid",
-              "type": "string"
-            },
-            "in": "path",
-            "name": "id",
-            "required": true
-          },
           {
             "schema": {
               "format": "uuid",
@@ -334914,18 +335067,69 @@
                 "schema": {
                   "type": "object",
                   "required": [
-                    "recordId"
+                    "results"
                   ],
                   "properties": {
-                    "recordId": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "domain",
+                          "ok"
+                        ],
+                        "properties": {
+                          "domain": {
+                            "type": "string"
+                          },
+                          "ok": {
+                            "type": "boolean"
+                          },
+                          "report": {
+                            "type": "object",
+                            "required": [
+                              "applied",
+                              "skipped",
+                              "errors"
+                            ],
+                            "properties": {
+                              "applied": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                }
+                              },
+                              "skipped": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                }
+                              },
+                              "errors": {
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "required": [
+                                    "setting",
+                                    "error"
+                                  ],
+                                  "properties": {
+                                    "setting": {
+                                      "type": "string"
+                                    },
+                                    "error": {
+                                      "type": "string"
+                                    }
+                                  }
+                                }
+                              }
+                            }
+                          },
+                          "error": {
+                            "type": "string"
+                          }
                         }
-                      ]
+                      }
                     }
                   }
                 }
@@ -335025,32 +335229,6 @@
               }
             }
           },
-          "404": {
-            "description": "Resource not found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "statusCode",
-                    "error",
-                    "message"
-                  ],
-                  "properties": {
-                    "statusCode": {
-                      "type": "number"
-                    },
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
           "429": {
             "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
             "content": {
@@ -335087,37 +335265,11 @@
               }
             }
           },
-          "502": {
-            "description": "Bad gateway - upstream provider failed",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "statusCode",
-                    "error",
-                    "message"
-                  ],
-                  "properties": {
-                    "statusCode": {
-                      "type": "number"
-                    },
-                    "error": {
-                      "type": "string"
-                    },
-                    "message": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "503": {
-            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
-            "headers": {
-              "Retry-After": {
-                "description": "Seconds to wait before retrying the identical request.",
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
                 "schema": {
                   "type": "integer"
                 }
@@ -335134,54 +335286,70 @@
         }
       }
     },
-    "/api/v1/traffic-filter/filter-lists": {
-      "get": {
-        "operationId": "getApiV1TrafficFilterFilterLists",
-        "summary": "List Traffic Filter filter lists",
+    "/api/v1/traffic-filter/domains/{id}/dns": {
+      "post": {
+        "operationId": "postApiV1TrafficFilterDomainsByIdDns",
+        "summary": "Add a DNS record",
         "tags": [
           "traffic-filter"
         ],
-        "description": "Returns all filter lists for the current team.",
-        "parameters": [
-          {
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "string",
-                  "enum": [
-                    "ua"
-                  ]
-                },
-                {
-                  "type": "string",
-                  "enum": [
-                    "ip"
-                  ]
+        "description": "Adds a DNS record to a Traffic Filter domain via Namesilo.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "rrtype",
+                  "rrhost",
+                  "rrvalue"
+                ],
+                "properties": {
+                  "rrtype": {
+                    "minLength": 1,
+                    "maxLength": 10,
+                    "type": "string"
+                  },
+                  "rrhost": {
+                    "maxLength": 255,
+                    "type": "string"
+                  },
+                  "rrvalue": {
+                    "minLength": 1,
+                    "maxLength": 500,
+                    "type": "string"
+                  },
+                  "rrttl": {
+                    "minimum": 60,
+                    "maximum": 2592000,
+                    "type": "integer"
+                  }
                 }
-              ]
-            },
-            "in": "query",
-            "name": "type",
-            "required": false
-          },
+              }
+            }
+          }
+        },
+        "parameters": [
           {
             "schema": {
-              "minimum": 1,
-              "maximum": 100,
-              "type": "integer"
+              "format": "uuid",
+              "type": "string"
             },
-            "in": "query",
-            "name": "limit",
-            "required": false
+            "in": "path",
+            "name": "id",
+            "required": true
           },
           {
             "schema": {
-              "minimum": 0,
-              "type": "integer"
+              "format": "uuid",
+              "type": "string"
             },
-            "in": "query",
-            "name": "offset",
-            "required": false
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Destination workspace team id."
           }
         ],
         "security": [
@@ -335200,54 +335368,77 @@
                 "schema": {
                   "type": "object",
                   "required": [
-                    "items",
-                    "total"
+                    "recordId"
                   ],
                   "properties": {
-                    "items": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "required": [
-                          "id",
-                          "teamId",
-                          "name",
-                          "type",
-                          "entries",
-                          "createdAt"
-                        ],
-                        "properties": {
-                          "id": {
-                            "format": "uuid",
-                            "type": "string"
-                          },
-                          "teamId": {
-                            "format": "uuid",
-                            "type": "string"
-                          },
-                          "name": {
-                            "type": "string"
-                          },
-                          "type": {
-                            "type": "string"
-                          },
-                          "entries": {
-                            "type": "array",
-                            "items": {
-                              "type": "string"
-                            }
-                          },
-                          "createdAt": {
-                            "format": "date-time",
-                            "type": "string"
-                          }
+                    "recordId": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "anyOf": [
+                    {
+                      "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"
+                          ]
                         }
                       }
                     },
-                    "total": {
-                      "type": "number"
+                    {
+                      "type": "object",
+                      "required": [
+                        "statusCode",
+                        "error",
+                        "message"
+                      ],
+                      "properties": {
+                        "statusCode": {
+                          "type": "number"
+                        },
+                        "error": {
+                          "type": "string"
+                        },
+                        "message": {
+                          "type": "string"
+                        }
+                      }
                     }
-                  }
+                  ]
                 }
               }
             }
@@ -335262,18 +335453,34 @@
               }
             }
           },
-          "429": {
-            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/RateLimitedResponse"
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
                 }
               }
             }
           },
-          "500": {
-            "description": "Internal server error",
+          "404": {
+            "description": "Resource not found",
             "content": {
               "application/json": {
                 "schema": {
@@ -335298,13 +335505,260 @@
               }
             }
           },
-          "503": {
-            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
-            "headers": {
-              "Retry-After": {
-                "description": "Seconds to wait before retrying the identical request.",
-                "schema": {
-                  "type": "integer"
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "502": {
+            "description": "Bad gateway - upstream provider failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
+                "schema": {
+                  "type": "integer"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/traffic-filter/filter-lists": {
+      "get": {
+        "operationId": "getApiV1TrafficFilterFilterLists",
+        "summary": "List Traffic Filter filter lists",
+        "tags": [
+          "traffic-filter"
+        ],
+        "description": "Returns all filter lists for the current team.",
+        "parameters": [
+          {
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "ua"
+                  ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "ip"
+                  ]
+                }
+              ]
+            },
+            "in": "query",
+            "name": "type",
+            "required": false
+          },
+          {
+            "schema": {
+              "minimum": 1,
+              "maximum": 100,
+              "type": "integer"
+            },
+            "in": "query",
+            "name": "limit",
+            "required": false
+          },
+          {
+            "schema": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "in": "query",
+            "name": "offset",
+            "required": false
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "items",
+                    "total"
+                  ],
+                  "properties": {
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "id",
+                          "teamId",
+                          "name",
+                          "type",
+                          "entries",
+                          "createdAt"
+                        ],
+                        "properties": {
+                          "id": {
+                            "format": "uuid",
+                            "type": "string"
+                          },
+                          "teamId": {
+                            "format": "uuid",
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "type": {
+                            "type": "string"
+                          },
+                          "entries": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "createdAt": {
+                            "format": "date-time",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    },
+                    "total": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
+                "schema": {
+                  "type": "integer"
                 }
               }
             },
@@ -342195,7 +342649,7 @@
         "tags": [
           "traffic-filter"
         ],
-        "description": "Returns landing pages for the current team. Archived pages are hidden by default; pass an explicit status filter to select a specific state.",
+        "description": "Returns landing pages for the current team. Archived pages are hidden by default; pass an explicit status filter to select a specific state. Pass page_kind to list only shield pages (\"safe\") or only flow pages (\"money\").",
         "parameters": [
           {
             "schema": {
@@ -342212,13 +342666,34 @@
                 {
                   "type": "string",
                   "enum": [
-                    "active"
+                    "safe"
                   ]
                 },
                 {
                   "type": "string",
                   "enum": [
-                    "paused"
+                    "money"
+                  ]
+                }
+              ]
+            },
+            "in": "query",
+            "name": "page_kind",
+            "required": false
+          },
+          {
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "active"
+                  ]
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    "paused"
                   ]
                 },
                 {
@@ -342290,6 +342765,7 @@
                           "id",
                           "name",
                           "type",
+                          "page_kind",
                           "html",
                           "bundle_version",
                           "bundle_entry_file",
@@ -342314,6 +342790,22 @@
                           "type": {
                             "type": "string"
                           },
+                          "page_kind": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "safe"
+                                ]
+                              },
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "money"
+                                ]
+                              }
+                            ]
+                          },
                           "html": {
                             "anyOf": [
                               {
@@ -342526,7 +343018,7 @@
         "tags": [
           "traffic-filter"
         ],
-        "description": "Creates a new landing page for the current team.",
+        "description": "Creates a new landing page for the current team. page_kind defaults to \"money\"; a page of a derived type (\"imported\" / \"cloned\") can only be a shield page and is rejected with 400 otherwise.",
         "requestBody": {
           "required": true,
           "content": {
@@ -342547,6 +343039,22 @@
                     "maxLength": 50,
                     "type": "string"
                   },
+                  "page_kind": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "safe"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "money"
+                        ]
+                      }
+                    ]
+                  },
                   "html": {
                     "anyOf": [
                       {
@@ -342671,6 +343179,7 @@
                     "id",
                     "name",
                     "type",
+                    "page_kind",
                     "html",
                     "bundle_version",
                     "bundle_entry_file",
@@ -342695,6 +343204,22 @@
                     "type": {
                       "type": "string"
                     },
+                    "page_kind": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "safe"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "money"
+                          ]
+                        }
+                      ]
+                    },
                     "html": {
                       "anyOf": [
                         {
@@ -342994,6 +343519,7 @@
                     "id",
                     "name",
                     "type",
+                    "page_kind",
                     "html",
                     "bundle_version",
                     "bundle_entry_file",
@@ -343018,6 +343544,22 @@
                     "type": {
                       "type": "string"
                     },
+                    "page_kind": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "safe"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "money"
+                          ]
+                        }
+                      ]
+                    },
                     "html": {
                       "anyOf": [
                         {
@@ -343250,7 +343792,7 @@
         "tags": [
           "traffic-filter"
         ],
-        "description": "Updates an existing landing page.",
+        "description": "Updates an existing landing page. Turning a page of a derived type (\"imported\" / \"cloned\") into a money page is rejected with 400.",
         "requestBody": {
           "required": true,
           "content": {
@@ -343268,6 +343810,22 @@
                     "maxLength": 50,
                     "type": "string"
                   },
+                  "page_kind": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "safe"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "money"
+                        ]
+                      }
+                    ]
+                  },
                   "html": {
                     "anyOf": [
                       {
@@ -343401,6 +343959,7 @@
                     "id",
                     "name",
                     "type",
+                    "page_kind",
                     "html",
                     "bundle_version",
                     "bundle_entry_file",
@@ -343425,6 +343984,22 @@
                     "type": {
                       "type": "string"
                     },
+                    "page_kind": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "safe"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "money"
+                          ]
+                        }
+                      ]
+                    },
                     "html": {
                       "anyOf": [
                         {
@@ -343926,7 +344501,7 @@
         "tags": [
           "traffic-filter"
         ],
-        "description": "Fetches the page HTML, rewrites it to stay self-contained, and saves it as an imported landing page.",
+        "description": "Fetches the page HTML, rewrites it to stay self-contained, and saves it as an imported landing page. An import always produces a shield page: page_kind may only be \"safe\", and any other value is rejected with 400.",
         "requestBody": {
           "required": true,
           "content": {
@@ -343948,6 +344523,22 @@
                     "maxLength": 200,
                     "type": "string"
                   },
+                  "page_kind": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "safe"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "money"
+                        ]
+                      }
+                    ]
+                  },
                   "host_assets": {
                     "type": "boolean"
                   }
@@ -343987,6 +344578,7 @@
                     "id",
                     "name",
                     "type",
+                    "page_kind",
                     "html",
                     "bundle_version",
                     "bundle_entry_file",
@@ -344011,6 +344603,22 @@
                     "type": {
                       "type": "string"
                     },
+                    "page_kind": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "safe"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "money"
+                          ]
+                        }
+                      ]
+                    },
                     "html": {
                       "anyOf": [
                         {
@@ -344305,7 +344913,7 @@
         "tags": [
           "traffic-filter"
         ],
-        "description": "Generates a complete standalone HTML landing page with Anthropic and saves it.",
+        "description": "Generates a complete standalone HTML landing page with Anthropic and saves it. page_kind decides which list the page lands in and defaults to \"money\".",
         "requestBody": {
           "required": true,
           "content": {
@@ -344334,6 +344942,22 @@
                     "minLength": 1,
                     "maxLength": 200,
                     "type": "string"
+                  },
+                  "page_kind": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "safe"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "money"
+                        ]
+                      }
+                    ]
                   }
                 }
               }
@@ -344371,6 +344995,7 @@
                     "id",
                     "name",
                     "type",
+                    "page_kind",
                     "html",
                     "bundle_version",
                     "bundle_entry_file",
@@ -344395,6 +345020,22 @@
                     "type": {
                       "type": "string"
                     },
+                    "page_kind": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "safe"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "money"
+                          ]
+                        }
+                      ]
+                    },
                     "html": {
                       "anyOf": [
                         {
@@ -344689,7 +345330,7 @@
         "tags": [
           "traffic-filter"
         ],
-        "description": "Builds an advertorial HTML page (hero, price, rating, testimonials, FAQ) with real Pexels imagery and saves it.",
+        "description": "Builds an advertorial HTML page (hero, price, rating, testimonials, FAQ) with real Pexels imagery and saves it. page_kind decides which list the page lands in and defaults to \"money\".",
         "requestBody": {
           "required": true,
           "content": {
@@ -344752,6 +345393,22 @@
                     "minLength": 1,
                     "maxLength": 200,
                     "type": "string"
+                  },
+                  "page_kind": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "safe"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "money"
+                        ]
+                      }
+                    ]
                   }
                 }
               }
@@ -344789,6 +345446,7 @@
                     "id",
                     "name",
                     "type",
+                    "page_kind",
                     "html",
                     "bundle_version",
                     "bundle_entry_file",
@@ -344813,6 +345471,22 @@
                     "type": {
                       "type": "string"
                     },
+                    "page_kind": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "safe"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "money"
+                          ]
+                        }
+                      ]
+                    },
                     "html": {
                       "anyOf": [
                         {
@@ -345074,6 +345748,512 @@
         }
       }
     },
+    "/api/v1/traffic-filter/landing-pages/{id}/preview-url": {
+      "get": {
+        "operationId": "getApiV1TrafficFilterLandingPagesByIdPreviewUrl",
+        "summary": "Build a signed preview URL for a Traffic Filter landing page",
+        "tags": [
+          "traffic-filter"
+        ],
+        "description": "Returns the public URL of the landing page with a short-lived signed preview token appended. Public landing pages are reachable only from inside a campaign funnel, so the dashboard needs this token to open a preview in a new tab. The token expires after 10 minutes and is bound to this landing page and this team.",
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "path",
+            "name": "id",
+            "required": true
+          },
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Explicit team (workspace) scope: a team.id the caller belongs to."
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-active-scope",
+            "required": false,
+            "description": "Active scope selector in `<scopeType>:<uuid>` form, e.g. `organization:<organization_id>` or `team:<team_id>`. Omit the header for the all-workspaces view."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "url"
+                  ],
+                  "properties": {
+                    "url": {
+                      "description": "Absolute public preview URL, token included.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
+                "schema": {
+                  "type": "integer"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/traffic-filter/forms/{id}/preview-url": {
+      "get": {
+        "operationId": "getApiV1TrafficFilterFormsByIdPreviewUrl",
+        "summary": "Build a signed preview URL for a Traffic Filter form",
+        "tags": [
+          "traffic-filter"
+        ],
+        "description": "Returns the public URL of the lead-capture form with a short-lived signed preview token appended. The public form page is reachable only from inside a campaign funnel, so this token is the only way to open it from the dashboard. The token expires after 10 minutes and is bound to this form and this team. It is a temporary preview link, not an address to hand out.",
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "path",
+            "name": "id",
+            "required": true
+          },
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Explicit team (workspace) scope: a team.id the caller belongs to."
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-active-scope",
+            "required": false,
+            "description": "Active scope selector in `<scopeType>:<uuid>` form, e.g. `organization:<organization_id>` or `team:<team_id>`. Omit the header for the all-workspaces view."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "url"
+                  ],
+                  "properties": {
+                    "url": {
+                      "description": "Absolute public preview URL, token included.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
+                "schema": {
+                  "type": "integer"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/traffic-filter/offers/{id}/preview-url": {
+      "get": {
+        "operationId": "getApiV1TrafficFilterOffersByIdPreviewUrl",
+        "summary": "Build a signed preview URL for a self-hosted Traffic Filter offer",
+        "tags": [
+          "traffic-filter"
+        ],
+        "description": "Returns the public URL of a `local` offer page with a short-lived signed preview token appended. Only self-hosted offers have a page served by this backend: an offer that points at an external network URL has nothing to preview here and answers 409. The token expires after 10 minutes and is bound to this offer and this team.",
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "path",
+            "name": "id",
+            "required": true
+          },
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Explicit team (workspace) scope: a team.id the caller belongs to."
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-active-scope",
+            "required": false,
+            "description": "Active scope selector in `<scopeType>:<uuid>` form, e.g. `organization:<organization_id>` or `team:<team_id>`. Omit the header for the all-workspaces view."
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "url"
+                  ],
+                  "properties": {
+                    "url": {
+                      "description": "Absolute public preview URL, token included.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Conflict - resource state prevents the operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
+                "schema": {
+                  "type": "integer"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/traffic-filter/leads": {
       "get": {
         "operationId": "getApiV1TrafficFilterLeads",