@opusdns/api 0.139.0 → 0.141.0

package/src/openapi.yaml

@@ -206,6 +206,23 @@ components:
       - canceled
       title: BillingTransactionStatus
       type: string
+    BrowserStatsBucket:
+      properties:
+        key:
+          title: Key
+          type: string
+        total:
+          title: Total
+          type: integer
+        unique:
+          title: Unique
+          type: integer
+      required:
+      - key
+      - total
+      - unique
+      title: BrowserStatsBucket
+      type: object
     ContactAttributeDefinition:
       description: Definition of a possible attribute for a TLD.
       properties:
@@ -1571,17 +1588,24 @@ components:
           format: date-time
           title: Updated On
           type: string
-        wildcard:
-          title: Wildcard
-          type: boolean
       required:
       - hostname
-      - wildcard
       - enabled
       - updated_on
       - created_on
       title: DomainForward
       type: object
+    DomainForwardBrowserStatsResponse:
+      properties:
+        results:
+          items:
+            $ref: '#/components/schemas/BrowserStatsBucket'
+          title: Results
+          type: array
+      required:
+      - results
+      title: DomainForwardBrowserStatsResponse
+      type: object
     DomainForwardCreateRequest:
       properties:
         enabled:
@@ -1603,6 +1627,49 @@ components:
       - hostname
       title: DomainForwardCreateRequest
       type: object
+    DomainForwardGeoStatsResponse:
+      properties:
+        results:
+          items:
+            $ref: '#/components/schemas/GeoStatsBucket'
+          title: Results
+          type: array
+      required:
+      - results
+      title: DomainForwardGeoStatsResponse
+      type: object
+    DomainForwardMetricsResponse:
+      properties:
+        configured_forwards:
+          title: Configured Forwards
+          type: integer
+        invoked_forwards:
+          title: Invoked Forwards
+          type: integer
+        total_visits:
+          title: Total Visits
+          type: integer
+        unique_visits:
+          title: Unique Visits
+          type: integer
+      required:
+      - invoked_forwards
+      - configured_forwards
+      - total_visits
+      - unique_visits
+      title: DomainForwardMetricsResponse
+      type: object
+    DomainForwardMetricsTimeSeriesResponse:
+      properties:
+        results:
+          items:
+            $ref: '#/components/schemas/TimeSeriesBucket'
+          title: Results
+          type: array
+      required:
+      - results
+      title: DomainForwardMetricsTimeSeriesResponse
+      type: object
     DomainForwardPatchOp:
       properties:
         op:
@@ -1628,6 +1695,17 @@ components:
       - ops
       title: DomainForwardPatchOps
       type: object
+    DomainForwardPlatformStatsResponse:
+      properties:
+        results:
+          items:
+            $ref: '#/components/schemas/PlatformStatsBucket'
+          title: Results
+          type: array
+      required:
+      - results
+      title: DomainForwardPlatformStatsResponse
+      type: object
     DomainForwardProtocolSetRequest:
       properties:
         redirects:
@@ -1637,11 +1715,6 @@ components:
             - $ref: '#/components/schemas/WildcardHttpRedirectRequest'
           title: Redirects
           type: array
-        wildcard:
-          anyOf:
-          - type: boolean
-          - type: 'null'
-          title: Wildcard
       required:
       - redirects
       title: DomainForwardProtocolSetRequest
@@ -1661,36 +1734,38 @@ components:
           format: date-time
           title: Updated On
           type: string
-        wildcard:
-          title: Wildcard
-          type: boolean
       required:
-      - wildcard
       - redirects
       - updated_on
       - created_on
       title: DomainForwardProtocolSetResponse
       type: object
-    DomainForwardRequest:
+    DomainForwardReferrerStatsResponse:
       properties:
-        enabled:
-          default: false
-          title: Enabled
-          type: boolean
-        http:
-          anyOf:
-          - $ref: '#/components/schemas/DomainForwardProtocolSetRequest'
-          - type: 'null'
-        https:
-          anyOf:
-          - $ref: '#/components/schemas/DomainForwardProtocolSetRequest'
-          - type: 'null'
-        wildcard:
-          anyOf:
-          - type: boolean
-          - type: 'null'
-          title: Wildcard
-      title: DomainForwardRequest
+        results:
+          items:
+            $ref: '#/components/schemas/ReferrerStatsBucket'
+          title: Results
+          type: array
+      required:
+      - results
+      title: DomainForwardReferrerStatsResponse
+      type: object
+    DomainForwardSetCreateRequest:
+      properties:
+        protocol:
+          $ref: '#/components/schemas/HttpProtocol'
+        redirects:
+          items:
+            anyOf:
+            - $ref: '#/components/schemas/HttpRedirectRequest'
+            - $ref: '#/components/schemas/WildcardHttpRedirectRequest'
+          title: Redirects
+          type: array
+      required:
+      - protocol
+      - redirects
+      title: DomainForwardSetCreateRequest
       type: object
     DomainForwardSetRequest:
       properties:
@@ -1725,13 +1800,9 @@ components:
           format: date-time
           title: Updated On
           type: string
-        wildcard:
-          title: Wildcard
-          type: boolean
       required:
       - hostname
       - protocol
-      - wildcard
       - redirects
       - updated_on
       - created_on
@@ -1745,6 +1816,39 @@ components:
       - updated_on
       title: DomainForwardSortField
       type: string
+    DomainForwardStatusCodeStatsResponse:
+      properties:
+        results:
+          items:
+            $ref: '#/components/schemas/StatusCodeStatsBucket'
+          title: Results
+          type: array
+      required:
+      - results
+      title: DomainForwardStatusCodeStatsResponse
+      type: object
+    DomainForwardUserAgentStatsResponse:
+      properties:
+        results:
+          items:
+            $ref: '#/components/schemas/UserAgentStatsBucket'
+          title: Results
+          type: array
+      required:
+      - results
+      title: DomainForwardUserAgentStatsResponse
+      type: object
+    DomainForwardVisitsByKeyResponse:
+      properties:
+        results:
+          items:
+            $ref: '#/components/schemas/VisitsByKeyBucket'
+          title: Results
+          type: array
+      required:
+      - results
+      title: DomainForwardVisitsByKeyResponse
+      type: object
     DomainForwardZone:
       properties:
         domain_forwards:
@@ -3016,6 +3120,19 @@ components:
       - start_date
       title: GeneralAvailabilityBase
       type: object
+    GeoStatsBucket:
+      properties:
+        key:
+          title: Key
+          type: string
+        total:
+          title: Total
+          type: integer
+      required:
+      - key
+      - total
+      title: GeoStatsBucket
+      type: object
     GetPricesResponse:
       properties:
         prices:
@@ -3562,6 +3679,14 @@ components:
       - business_entity
       title: LocalPresenceRequirementType
       type: string
+    MetricsGrouping:
+      enum:
+      - url
+      - fqdn
+      - domain
+      - forward
+      title: MetricsGrouping
+      type: string
     Nameserver:
       properties:
         hostname:
@@ -4681,6 +4806,23 @@ components:
           type: array
       title: PermissionSet
       type: object
+    PlatformStatsBucket:
+      properties:
+        key:
+          title: Key
+          type: string
+        total:
+          title: Total
+          type: integer
+        unique:
+          title: Unique
+          type: integer
+      required:
+      - key
+      - total
+      - unique
+      title: PlatformStatsBucket
+      type: object
     PostTransferRequirements:
       enum:
       - update_contacts
@@ -4799,6 +4941,12 @@ components:
       - status
       title: Problem
       type: object
+    Protocol:
+      enum:
+      - http
+      - https
+      title: Protocol
+      type: string
     PublicAuthRequestForm:
       properties:
         client_id:
@@ -4846,6 +4994,23 @@ components:
       - 308
       title: RedirectCode
       type: integer
+    ReferrerStatsBucket:
+      properties:
+        key:
+          title: Key
+          type: string
+        total:
+          title: Total
+          type: integer
+        unique:
+          title: Unique
+          type: integer
+      required:
+      - key
+      - total
+      - unique
+      title: ReferrerStatsBucket
+      type: object
     RegistrantChangeType:
       enum:
       - update
@@ -5132,6 +5297,19 @@ components:
           title: Remove
       title: SpiceDbRelationshipUpdate
       type: object
+    StatusCodeStatsBucket:
+      properties:
+        key:
+          title: Key
+          type: string
+        total:
+          title: Total
+          type: integer
+      required:
+      - key
+      - total
+      title: StatusCodeStatsBucket
+      type: object
     SyncOperationType:
       enum:
       - registration
@@ -5145,6 +5323,28 @@ components:
       - ccTLD
       title: TLDType
       type: string
+    TimeRange:
+      enum:
+      - 1h
+      - 1d
+      - 7d
+      - 30d
+      title: TimeRange
+      type: string
+    TimeSeriesBucket:
+      properties:
+        timestamp:
+          format: date-time
+          title: Timestamp
+          type: string
+        total:
+          title: Total
+          type: integer
+      required:
+      - timestamp
+      - total
+      title: TimeSeriesBucket
+      type: object
     TldBase:
       properties:
         name:
@@ -5539,6 +5739,23 @@ components:
       - status
       title: User
       type: object
+    UserAgentStatsBucket:
+      properties:
+        key:
+          title: Key
+          type: string
+        total:
+          title: Total
+          type: integer
+        unique:
+          title: Unique
+          type: integer
+      required:
+      - key
+      - total
+      - unique
+      title: UserAgentStatsBucket
+      type: object
     UserAttributeBase:
       properties:
         key:
@@ -6042,6 +6259,23 @@ components:
       - email
       title: VerificationType
       type: string
+    VisitsByKeyBucket:
+      properties:
+        key:
+          title: Key
+          type: string
+        total:
+          title: Total
+          type: integer
+        unique:
+          title: Unique
+          type: integer
+      required:
+      - key
+      - total
+      - unique
+      title: VisitsByKeyBucket
+      type: object
     WhoisBase:
       properties:
         whois_server:
@@ -6253,7 +6487,7 @@ info:
     '
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2025-12-30-205837
+  version: 2026-01-07-115447
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -8169,9 +8403,7 @@ paths:
                             target_path: /
                             target_protocol: https
                           updated_on: '2025-11-18T12:59:57Z'
-                          wildcard: false
                         updated_on: '2025-11-18T12:59:57Z'
-                        wildcard: false
                       zone_id: zone_01kabfvtysfqwv4dn89r3jepym
                       zone_name: example.com.
               schema:
@@ -8590,9 +8822,7 @@ paths:
                           target_path: /
                           target_protocol: https
                         updated_on: '2025-11-18T12:59:57Z'
-                        wildcard: false
                       updated_on: '2025-11-18T12:59:57Z'
-                      wildcard: false
                     zone_id: zone_01kabfvtysfqwv4dn89r3jepym
                     zone_name: example.com.
               schema:
@@ -9150,6 +9380,7 @@ paths:
                 summary: HTTP domain forward
                 value:
                   enabled: false
+                  hostname: example.com.
                   http:
                     redirects:
                     - redirect_code: 301
@@ -9157,7 +9388,6 @@ paths:
                       target_hostname: example.com
                       target_path: /
                       target_protocol: https
-                    wildcard: false
                   https:
                     redirects:
                     - redirect_code: 302
@@ -9165,14 +9395,13 @@ paths:
                       target_hostname: auth.example.com
                       target_path: /
                       target_protocol: https
-                    wildcard: false
-                  wildcard: false
               http_to_https:
                 description: Create a HTTP domain forward with redirect from HTTP
                   to HTTPS
                 summary: HTTP to HTTPS
                 value:
                   enabled: false
+                  hostname: example.com.
                   https:
                     redirects:
                     - redirect_code: 301
@@ -9180,8 +9409,6 @@ paths:
                       target_hostname: example.com
                       target_path: /
                       target_protocol: https
-                    wildcard: false
-                  wildcard: false
             schema:
               $ref: '#/components/schemas/DomainForwardCreateRequest'
         required: true
@@ -9209,7 +9436,6 @@ paths:
                         target_path: /
                         target_protocol: https
                       updated_on: '2025-11-14T09:01:38'
-                      wildcard: false
                     https:
                       created_on: '2025-11-14T09:01:38'
                       redirects:
@@ -9221,9 +9447,7 @@ paths:
                         target_path: /
                         target_protocol: https
                       updated_on: '2025-11-14T09:01:38'
-                      wildcard: false
                     updated_on: '2025-11-14T09:01:38'
-                    wildcard: false
                 http_to_https_response:
                   description: Response when creating a HTTP to HTTPS domain forward
                   summary: Response for HTTP to HTTPS
@@ -9242,9 +9466,7 @@ paths:
                         target_path: /
                         target_protocol: https
                       updated_on: '2025-11-14T09:01:38'
-                      wildcard: false
                     updated_on: '2025-11-14T09:01:38'
-                    wildcard: false
               schema:
                 $ref: '#/components/schemas/DomainForward'
           description: Domain forward created successfully
@@ -9308,48 +9530,488 @@ paths:
       summary: Create a domain forward
       tags:
       - domain_forward
-  /v1/domain-forwards/{hostname}:
-    delete:
-      description: Deletes the domain forward configuration for the specified hostname
-      operationId: delete_domain_forward_v1_domain_forwards__hostname__delete
+  /v1/domain-forwards/metrics:
+    get:
+      operationId: metrics_v1_domain_forwards_metrics_get
       parameters:
-      - description: Hostname
-        in: path
+      - in: query
         name: hostname
-        required: true
+        required: false
         schema:
-          description: Hostname
+          anyOf:
+          - type: string
+          - type: 'null'
           title: Hostname
-          type: string
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
       responses:
-        '204':
-          description: Successful Response
-        '401':
+        '200':
           content:
-            application/problem+json:
-              example:
-                code: ERROR_AUTHENTICATION
-                detail: Additional error context.
-                status: 401
-                title: Authentication Error
-                type: authentication
+            application/json:
               schema:
-                $ref: '#/components/schemas/Problem'
-          description: Unauthorized
-        '403':
+                $ref: '#/components/schemas/DomainForwardMetricsResponse'
+          description: Successful Response
+        '422':
           content:
             application/problem+json:
-              example:
-                code: ERROR_PERMISSION_DENIED
-                detail: Insufficient permissions to perform this action
-                status: 403
-                title: Permission Denied
-                type: permission-denied
               schema:
-                $ref: '#/components/schemas/Problem'
-          description: Forbidden
-        '404':
-          content:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Metrics
+      tags:
+      - domain_forward
+  /v1/domain-forwards/metrics/browser:
+    get:
+      operationId: browser_stats_v1_domain_forwards_metrics_browser_get
+      parameters:
+      - in: query
+        name: hostname
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Hostname
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainForwardBrowserStatsResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Browser Stats
+      tags:
+      - domain_forward
+  /v1/domain-forwards/metrics/geo:
+    get:
+      operationId: geo_stats_v1_domain_forwards_metrics_geo_get
+      parameters:
+      - in: query
+        name: hostname
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Hostname
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainForwardGeoStatsResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Geo Stats
+      tags:
+      - domain_forward
+  /v1/domain-forwards/metrics/platform:
+    get:
+      operationId: platform_stats_v1_domain_forwards_metrics_platform_get
+      parameters:
+      - in: query
+        name: hostname
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Hostname
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainForwardPlatformStatsResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Platform Stats
+      tags:
+      - domain_forward
+  /v1/domain-forwards/metrics/referrer:
+    get:
+      operationId: referrer_stats_v1_domain_forwards_metrics_referrer_get
+      parameters:
+      - in: query
+        name: hostname
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Hostname
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainForwardReferrerStatsResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Referrer Stats
+      tags:
+      - domain_forward
+  /v1/domain-forwards/metrics/status-code:
+    get:
+      operationId: status_code_stats_v1_domain_forwards_metrics_status_code_get
+      parameters:
+      - in: query
+        name: hostname
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Hostname
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainForwardStatusCodeStatsResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Status Code Stats
+      tags:
+      - domain_forward
+  /v1/domain-forwards/metrics/time-series:
+    get:
+      operationId: time_series_v1_domain_forwards_metrics_time_series_get
+      parameters:
+      - in: query
+        name: hostname
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Hostname
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainForwardMetricsTimeSeriesResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Time Series
+      tags:
+      - domain_forward
+  /v1/domain-forwards/metrics/user-agent:
+    get:
+      operationId: user_agent_stats_v1_domain_forwards_metrics_user_agent_get
+      parameters:
+      - in: query
+        name: hostname
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Hostname
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainForwardUserAgentStatsResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: User Agent Stats
+      tags:
+      - domain_forward
+  /v1/domain-forwards/metrics/visits-by-key:
+    get:
+      operationId: visits_by_key_v1_domain_forwards_metrics_visits_by_key_get
+      parameters:
+      - description: 'Grouping key: url, fqdn, domain, or forward'
+        in: query
+        name: grouping
+        required: false
+        schema:
+          $ref: '#/components/schemas/MetricsGrouping'
+          default: domain
+          description: 'Grouping key: url, fqdn, domain, or forward'
+      - in: query
+        name: hostname
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Hostname
+      - description: 'Filter by protocol: http or https'
+        in: query
+        name: protocol
+        required: false
+        schema:
+          anyOf:
+          - $ref: '#/components/schemas/Protocol'
+          - type: 'null'
+          description: 'Filter by protocol: http or https'
+          title: Protocol
+      - description: 'Time range: 1h, 1d, 7d, or 30d'
+        in: query
+        name: time_range
+        required: false
+        schema:
+          $ref: '#/components/schemas/TimeRange'
+          default: 1d
+          description: 'Time range: 1h, 1d, 7d, or 30d'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainForwardVisitsByKeyResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Visits By Key
+      tags:
+      - domain_forward
+  /v1/domain-forwards/{hostname}:
+    delete:
+      description: Deletes the domain forward configuration for the specified hostname
+      operationId: delete_domain_forward_v1_domain_forwards__hostname__delete
+      parameters:
+      - description: Hostname
+        in: path
+        name: hostname
+        required: true
+        schema:
+          description: Hostname
+          title: Hostname
+          type: string
+      responses:
+        '204':
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '403':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_PERMISSION_DENIED
+                detail: Insufficient permissions to perform this action
+                status: 403
+                title: Permission Denied
+                type: permission-denied
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Forbidden
+        '404':
+          content:
             application/problem+json:
               example:
                 code: ERROR_DOMAIN_FORWARD_NOT_EXISTS
@@ -9438,10 +10100,9 @@ paths:
       tags:
       - domain_forward
     post:
-      deprecated: true
-      description: '**DEPRECATED**: Use POST /v1/domain-forwards instead. Creates
-        a new domain forward configuration for the specified hostname.'
-      operationId: create_domain_forward_v1_domain_forwards__hostname__post
+      description: Creates a new domain forward set for a specific protocol (HTTP
+        or HTTPS). Raises an error if the set already exists.
+      operationId: create_domain_forward_set_v1_domain_forwards__hostname__post
       parameters:
       - description: Hostname
         in: path
@@ -9454,111 +10115,16 @@ paths:
       requestBody:
         content:
           application/json:
-            examples:
-              domain_forward:
-                description: Create a HTTP domain forward with redirect from HTTP
-                  to HTTPS and HTTPS to auth.example.com
-                summary: HTTP domain forward
-                value:
-                  enabled: false
-                  http:
-                    redirects:
-                    - redirect_code: 301
-                      request_path: /
-                      target_hostname: example.com
-                      target_path: /
-                      target_protocol: https
-                    wildcard: false
-                  https:
-                    redirects:
-                    - redirect_code: 302
-                      request_path: /
-                      target_hostname: auth.example.com
-                      target_path: /
-                      target_protocol: https
-                    wildcard: false
-                  wildcard: false
-              http_to_https:
-                description: Create a HTTP domain forward with redirect from HTTP
-                  to HTTPS
-                summary: HTTP to HTTPS
-                value:
-                  enabled: false
-                  https:
-                    redirects:
-                    - redirect_code: 301
-                      request_path: /
-                      target_hostname: example.com
-                      target_path: /
-                      target_protocol: https
-                    wildcard: false
-                  wildcard: false
             schema:
-              $ref: '#/components/schemas/DomainForwardRequest'
+              $ref: '#/components/schemas/DomainForwardSetCreateRequest'
         required: true
       responses:
         '201':
           content:
             application/json:
-              examples:
-                http_domain_forward_response:
-                  description: Response when creating a HTTP domain forward with redirect
-                    from HTTP to HTTPS and HTTPS to auth.example.com
-                  summary: Response for HTTP domain forward
-                  value:
-                    created_on: '2025-11-14T09:01:38'
-                    enabled: false
-                    hostname: example.com.
-                    http:
-                      created_on: '2025-11-14T09:01:38'
-                      redirects:
-                      - redirect_code: 301
-                        request_hostname: example.com.
-                        request_path: /
-                        request_protocol: http
-                        target_hostname: example.com
-                        target_path: /
-                        target_protocol: https
-                      updated_on: '2025-11-14T09:01:38'
-                      wildcard: false
-                    https:
-                      created_on: '2025-11-14T09:01:38'
-                      redirects:
-                      - redirect_code: 302
-                        request_hostname: example.com.
-                        request_path: /
-                        request_protocol: https
-                        target_hostname: auth.example.com
-                        target_path: /
-                        target_protocol: https
-                      updated_on: '2025-11-14T09:01:38'
-                      wildcard: false
-                    updated_on: '2025-11-14T09:01:38'
-                    wildcard: false
-                http_to_https_response:
-                  description: Response when creating a HTTP to HTTPS domain forward
-                  summary: Response for HTTP to HTTPS
-                  value:
-                    created_on: '2025-11-14T09:01:38'
-                    enabled: false
-                    hostname: example.com.
-                    http:
-                      created_on: '2025-11-14T09:01:38'
-                      redirects:
-                      - redirect_code: 301
-                        request_hostname: example.com.
-                        request_path: /
-                        request_protocol: http
-                        target_hostname: example.com
-                        target_path: /
-                        target_protocol: https
-                      updated_on: '2025-11-14T09:01:38'
-                      wildcard: false
-                    updated_on: '2025-11-14T09:01:38'
-                    wildcard: false
               schema:
-                $ref: '#/components/schemas/DomainForward'
-          description: Domain forward created successfully
+                $ref: '#/components/schemas/DomainForwardSetResponse'
+          description: Successful Response
         '401':
           content:
             application/problem+json:
@@ -9587,27 +10153,26 @@ paths:
           content:
             application/problem+json:
               example:
-                code: ERROR_ZONE_NOT_FOUND
-                detail: Zone not found
+                code: ERROR_DOMAIN_FORWARD_NOT_EXISTS
+                detail: Domain forward not found for Additional error context.
                 status: 404
-                title: DNS Error
-                type: dns-zone-not-found
-                zone_name: Zone example.com. not found
+                title: Domain Forward Error
+                type: domain-forward-not-found
               schema:
                 $ref: '#/components/schemas/Problem'
-          description: DNS zone was not found
+          description: Not Found
         '409':
           content:
             application/problem+json:
               example:
                 code: ERROR_DOMAIN_FORWARD_ALREADY_EXISTS
-                detail: Domain forward already exists for example.com.
+                detail: Domain forward already exists for Additional error context.
                 status: 409
                 title: Domain Forward Error
                 type: domain-forward-already-exists
               schema:
                 $ref: '#/components/schemas/Problem'
-          description: Domain forward already exists
+          description: Conflict
         '422':
           content:
             application/problem+json:
@@ -9616,7 +10181,7 @@ paths:
           description: Validation Error
       security:
       - OAuth2PasswordBearer: []
-      summary: Create a domain forward (deprecated)
+      summary: Create domain forward set
       tags:
       - domain_forward
   /v1/domain-forwards/{hostname}/disable:
@@ -9875,9 +10440,10 @@ paths:
       tags:
       - domain_forward
     post:
-      description: Creates a new domain forward set for a specific protocol (HTTP
-        or HTTPS). Raises an error if the set already exists.
-      operationId: create_domain_forward_set_v1_domain_forwards__hostname___protocol__post
+      deprecated: true
+      description: 'Deprecated: Use POST /{hostname} with protocol in body instead.
+        Creates a new domain forward set for a specific protocol (HTTP or HTTPS).'
+      operationId: create_domain_forward_set_deprecated_v1_domain_forwards__hostname___protocol__post
       parameters:
       - in: path
         name: protocol
@@ -9961,7 +10527,7 @@ paths:
           description: Validation Error
       security:
       - OAuth2PasswordBearer: []
-      summary: Create domain forward set
+      summary: Create domain forward set (deprecated)
       tags:
       - domain_forward
     put: