@opusdns/api 0.206.0 → 0.208.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4098,7 +4098,8 @@ export type PATCH_DomainForwardsByHostnameEnable_Response_422 = HTTPValidationEr
4098
4098
  /**
4099
4099
  * Response types for GET DomainForwardsMetrics endpoint
4100
4100
  *
4101
- * Metrics
4101
+ * Get domain forward metrics
4102
+ * Retrieves overall metrics for domain forwards including total and unique visit counts.
4102
4103
  *
4103
4104
  * @remarks
4104
4105
  * This type defines all possible response structures for the GET DomainForwardsMetrics endpoint.
@@ -4113,11 +4114,13 @@ export type PATCH_DomainForwardsByHostnameEnable_Response_422 = HTTPValidationEr
4113
4114
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4114
4115
  *
4115
4116
  * @see {@link GET_DomainForwardsMetrics_Response_200} - 200 response type
4117
+ * @see {@link GET_DomainForwardsMetrics_Response_401} - 401 response type
4118
+ * @see {@link GET_DomainForwardsMetrics_Response_403} - 403 response type
4116
4119
  * @see {@link GET_DomainForwardsMetrics_Response_422} - 422 response type
4117
4120
  *
4118
4121
 
4119
4122
  */
4120
- export type GET_DomainForwardsMetrics_Response = GET_DomainForwardsMetrics_Response_200 | GET_DomainForwardsMetrics_Response_422;
4123
+ export type GET_DomainForwardsMetrics_Response = GET_DomainForwardsMetrics_Response_200 | GET_DomainForwardsMetrics_Response_401 | GET_DomainForwardsMetrics_Response_403 | GET_DomainForwardsMetrics_Response_422;
4121
4124
 
4122
4125
  /**
4123
4126
  * 200 response for GET DomainForwardsMetrics endpoint
@@ -4139,6 +4142,46 @@ export type GET_DomainForwardsMetrics_Response = GET_DomainForwardsMetrics_Respo
4139
4142
  */
4140
4143
  export type GET_DomainForwardsMetrics_Response_200 = DomainForwardMetrics
4141
4144
 
4145
+ /**
4146
+ * 401 response for GET DomainForwardsMetrics endpoint
4147
+ *
4148
+ * @remarks
4149
+ * This type defines the response structure for the 401 status code
4150
+ * of the GET DomainForwardsMetrics endpoint.
4151
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4152
+ *
4153
+
4154
+ *
4155
+ * @path /v1/domain-forwards/metrics
4156
+ * @param protocol (query) - Filter by protocol: http or https
4157
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4158
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4159
+ *
4160
+ * @see {@link GET_DomainForwardsMetrics_Response} - The main response type definition
4161
+ * @see {@link Problem} - The actual schema type definition
4162
+ */
4163
+ export type GET_DomainForwardsMetrics_Response_401 = Problem
4164
+
4165
+ /**
4166
+ * 403 response for GET DomainForwardsMetrics endpoint
4167
+ *
4168
+ * @remarks
4169
+ * This type defines the response structure for the 403 status code
4170
+ * of the GET DomainForwardsMetrics endpoint.
4171
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4172
+ *
4173
+
4174
+ *
4175
+ * @path /v1/domain-forwards/metrics
4176
+ * @param protocol (query) - Filter by protocol: http or https
4177
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4178
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4179
+ *
4180
+ * @see {@link GET_DomainForwardsMetrics_Response} - The main response type definition
4181
+ * @see {@link Problem} - The actual schema type definition
4182
+ */
4183
+ export type GET_DomainForwardsMetrics_Response_403 = Problem
4184
+
4142
4185
  /**
4143
4186
  * 422 response for GET DomainForwardsMetrics endpoint
4144
4187
  *
@@ -4162,7 +4205,8 @@ export type GET_DomainForwardsMetrics_Response_422 = HTTPValidationError
4162
4205
  /**
4163
4206
  * Response types for GET DomainForwardsMetricsBrowser endpoint
4164
4207
  *
4165
- * Browser Stats
4208
+ * Get browser statistics
4209
+ * Retrieves visitor traffic broken down by browser type (Chrome, Safari, Firefox, etc.) with total and unique visit counts.
4166
4210
  *
4167
4211
  * @remarks
4168
4212
  * This type defines all possible response structures for the GET DomainForwardsMetricsBrowser endpoint.
@@ -4177,11 +4221,13 @@ export type GET_DomainForwardsMetrics_Response_422 = HTTPValidationError
4177
4221
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4178
4222
  *
4179
4223
  * @see {@link GET_DomainForwardsMetricsBrowser_Response_200} - 200 response type
4224
+ * @see {@link GET_DomainForwardsMetricsBrowser_Response_401} - 401 response type
4225
+ * @see {@link GET_DomainForwardsMetricsBrowser_Response_403} - 403 response type
4180
4226
  * @see {@link GET_DomainForwardsMetricsBrowser_Response_422} - 422 response type
4181
4227
  *
4182
4228
 
4183
4229
  */
4184
- export type GET_DomainForwardsMetricsBrowser_Response = GET_DomainForwardsMetricsBrowser_Response_200 | GET_DomainForwardsMetricsBrowser_Response_422;
4230
+ export type GET_DomainForwardsMetricsBrowser_Response = GET_DomainForwardsMetricsBrowser_Response_200 | GET_DomainForwardsMetricsBrowser_Response_401 | GET_DomainForwardsMetricsBrowser_Response_403 | GET_DomainForwardsMetricsBrowser_Response_422;
4185
4231
 
4186
4232
  /**
4187
4233
  * 200 response for GET DomainForwardsMetricsBrowser endpoint
@@ -4203,6 +4249,46 @@ export type GET_DomainForwardsMetricsBrowser_Response = GET_DomainForwardsMetric
4203
4249
  */
4204
4250
  export type GET_DomainForwardsMetricsBrowser_Response_200 = DomainForwardBrowserStats
4205
4251
 
4252
+ /**
4253
+ * 401 response for GET DomainForwardsMetricsBrowser endpoint
4254
+ *
4255
+ * @remarks
4256
+ * This type defines the response structure for the 401 status code
4257
+ * of the GET DomainForwardsMetricsBrowser endpoint.
4258
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4259
+ *
4260
+
4261
+ *
4262
+ * @path /v1/domain-forwards/metrics/browser
4263
+ * @param protocol (query) - Filter by protocol: http or https
4264
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4265
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4266
+ *
4267
+ * @see {@link GET_DomainForwardsMetricsBrowser_Response} - The main response type definition
4268
+ * @see {@link Problem} - The actual schema type definition
4269
+ */
4270
+ export type GET_DomainForwardsMetricsBrowser_Response_401 = Problem
4271
+
4272
+ /**
4273
+ * 403 response for GET DomainForwardsMetricsBrowser endpoint
4274
+ *
4275
+ * @remarks
4276
+ * This type defines the response structure for the 403 status code
4277
+ * of the GET DomainForwardsMetricsBrowser endpoint.
4278
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4279
+ *
4280
+
4281
+ *
4282
+ * @path /v1/domain-forwards/metrics/browser
4283
+ * @param protocol (query) - Filter by protocol: http or https
4284
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4285
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4286
+ *
4287
+ * @see {@link GET_DomainForwardsMetricsBrowser_Response} - The main response type definition
4288
+ * @see {@link Problem} - The actual schema type definition
4289
+ */
4290
+ export type GET_DomainForwardsMetricsBrowser_Response_403 = Problem
4291
+
4206
4292
  /**
4207
4293
  * 422 response for GET DomainForwardsMetricsBrowser endpoint
4208
4294
  *
@@ -4226,7 +4312,8 @@ export type GET_DomainForwardsMetricsBrowser_Response_422 = HTTPValidationError
4226
4312
  /**
4227
4313
  * Response types for GET DomainForwardsMetricsGeo endpoint
4228
4314
  *
4229
- * Geo Stats
4315
+ * Get geographic statistics
4316
+ * Retrieves visitor traffic broken down by geographic location (country code) with visit counts.
4230
4317
  *
4231
4318
  * @remarks
4232
4319
  * This type defines all possible response structures for the GET DomainForwardsMetricsGeo endpoint.
@@ -4241,11 +4328,13 @@ export type GET_DomainForwardsMetricsBrowser_Response_422 = HTTPValidationError
4241
4328
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4242
4329
  *
4243
4330
  * @see {@link GET_DomainForwardsMetricsGeo_Response_200} - 200 response type
4331
+ * @see {@link GET_DomainForwardsMetricsGeo_Response_401} - 401 response type
4332
+ * @see {@link GET_DomainForwardsMetricsGeo_Response_403} - 403 response type
4244
4333
  * @see {@link GET_DomainForwardsMetricsGeo_Response_422} - 422 response type
4245
4334
  *
4246
4335
 
4247
4336
  */
4248
- export type GET_DomainForwardsMetricsGeo_Response = GET_DomainForwardsMetricsGeo_Response_200 | GET_DomainForwardsMetricsGeo_Response_422;
4337
+ export type GET_DomainForwardsMetricsGeo_Response = GET_DomainForwardsMetricsGeo_Response_200 | GET_DomainForwardsMetricsGeo_Response_401 | GET_DomainForwardsMetricsGeo_Response_403 | GET_DomainForwardsMetricsGeo_Response_422;
4249
4338
 
4250
4339
  /**
4251
4340
  * 200 response for GET DomainForwardsMetricsGeo endpoint
@@ -4267,6 +4356,46 @@ export type GET_DomainForwardsMetricsGeo_Response = GET_DomainForwardsMetricsGeo
4267
4356
  */
4268
4357
  export type GET_DomainForwardsMetricsGeo_Response_200 = DomainForwardGeoStats
4269
4358
 
4359
+ /**
4360
+ * 401 response for GET DomainForwardsMetricsGeo endpoint
4361
+ *
4362
+ * @remarks
4363
+ * This type defines the response structure for the 401 status code
4364
+ * of the GET DomainForwardsMetricsGeo endpoint.
4365
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4366
+ *
4367
+
4368
+ *
4369
+ * @path /v1/domain-forwards/metrics/geo
4370
+ * @param protocol (query) - Filter by protocol: http or https
4371
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4372
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4373
+ *
4374
+ * @see {@link GET_DomainForwardsMetricsGeo_Response} - The main response type definition
4375
+ * @see {@link Problem} - The actual schema type definition
4376
+ */
4377
+ export type GET_DomainForwardsMetricsGeo_Response_401 = Problem
4378
+
4379
+ /**
4380
+ * 403 response for GET DomainForwardsMetricsGeo endpoint
4381
+ *
4382
+ * @remarks
4383
+ * This type defines the response structure for the 403 status code
4384
+ * of the GET DomainForwardsMetricsGeo endpoint.
4385
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4386
+ *
4387
+
4388
+ *
4389
+ * @path /v1/domain-forwards/metrics/geo
4390
+ * @param protocol (query) - Filter by protocol: http or https
4391
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4392
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4393
+ *
4394
+ * @see {@link GET_DomainForwardsMetricsGeo_Response} - The main response type definition
4395
+ * @see {@link Problem} - The actual schema type definition
4396
+ */
4397
+ export type GET_DomainForwardsMetricsGeo_Response_403 = Problem
4398
+
4270
4399
  /**
4271
4400
  * 422 response for GET DomainForwardsMetricsGeo endpoint
4272
4401
  *
@@ -4290,7 +4419,8 @@ export type GET_DomainForwardsMetricsGeo_Response_422 = HTTPValidationError
4290
4419
  /**
4291
4420
  * Response types for GET DomainForwardsMetricsPlatform endpoint
4292
4421
  *
4293
- * Platform Stats
4422
+ * Get platform statistics
4423
+ * Retrieves visitor traffic broken down by platform (Windows, Macintosh, iOS, Android, Linux) with total and unique visit counts.
4294
4424
  *
4295
4425
  * @remarks
4296
4426
  * This type defines all possible response structures for the GET DomainForwardsMetricsPlatform endpoint.
@@ -4305,11 +4435,13 @@ export type GET_DomainForwardsMetricsGeo_Response_422 = HTTPValidationError
4305
4435
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4306
4436
  *
4307
4437
  * @see {@link GET_DomainForwardsMetricsPlatform_Response_200} - 200 response type
4438
+ * @see {@link GET_DomainForwardsMetricsPlatform_Response_401} - 401 response type
4439
+ * @see {@link GET_DomainForwardsMetricsPlatform_Response_403} - 403 response type
4308
4440
  * @see {@link GET_DomainForwardsMetricsPlatform_Response_422} - 422 response type
4309
4441
  *
4310
4442
 
4311
4443
  */
4312
- export type GET_DomainForwardsMetricsPlatform_Response = GET_DomainForwardsMetricsPlatform_Response_200 | GET_DomainForwardsMetricsPlatform_Response_422;
4444
+ export type GET_DomainForwardsMetricsPlatform_Response = GET_DomainForwardsMetricsPlatform_Response_200 | GET_DomainForwardsMetricsPlatform_Response_401 | GET_DomainForwardsMetricsPlatform_Response_403 | GET_DomainForwardsMetricsPlatform_Response_422;
4313
4445
 
4314
4446
  /**
4315
4447
  * 200 response for GET DomainForwardsMetricsPlatform endpoint
@@ -4331,6 +4463,46 @@ export type GET_DomainForwardsMetricsPlatform_Response = GET_DomainForwardsMetri
4331
4463
  */
4332
4464
  export type GET_DomainForwardsMetricsPlatform_Response_200 = DomainForwardPlatformStats
4333
4465
 
4466
+ /**
4467
+ * 401 response for GET DomainForwardsMetricsPlatform endpoint
4468
+ *
4469
+ * @remarks
4470
+ * This type defines the response structure for the 401 status code
4471
+ * of the GET DomainForwardsMetricsPlatform endpoint.
4472
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4473
+ *
4474
+
4475
+ *
4476
+ * @path /v1/domain-forwards/metrics/platform
4477
+ * @param protocol (query) - Filter by protocol: http or https
4478
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4479
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4480
+ *
4481
+ * @see {@link GET_DomainForwardsMetricsPlatform_Response} - The main response type definition
4482
+ * @see {@link Problem} - The actual schema type definition
4483
+ */
4484
+ export type GET_DomainForwardsMetricsPlatform_Response_401 = Problem
4485
+
4486
+ /**
4487
+ * 403 response for GET DomainForwardsMetricsPlatform endpoint
4488
+ *
4489
+ * @remarks
4490
+ * This type defines the response structure for the 403 status code
4491
+ * of the GET DomainForwardsMetricsPlatform endpoint.
4492
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4493
+ *
4494
+
4495
+ *
4496
+ * @path /v1/domain-forwards/metrics/platform
4497
+ * @param protocol (query) - Filter by protocol: http or https
4498
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4499
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4500
+ *
4501
+ * @see {@link GET_DomainForwardsMetricsPlatform_Response} - The main response type definition
4502
+ * @see {@link Problem} - The actual schema type definition
4503
+ */
4504
+ export type GET_DomainForwardsMetricsPlatform_Response_403 = Problem
4505
+
4334
4506
  /**
4335
4507
  * 422 response for GET DomainForwardsMetricsPlatform endpoint
4336
4508
  *
@@ -4354,7 +4526,8 @@ export type GET_DomainForwardsMetricsPlatform_Response_422 = HTTPValidationError
4354
4526
  /**
4355
4527
  * Response types for GET DomainForwardsMetricsReferrer endpoint
4356
4528
  *
4357
- * Referrer Stats
4529
+ * Get referrer statistics
4530
+ * Retrieves visitor referral sources (where traffic came from) with total and unique visit counts.
4358
4531
  *
4359
4532
  * @remarks
4360
4533
  * This type defines all possible response structures for the GET DomainForwardsMetricsReferrer endpoint.
@@ -4369,11 +4542,13 @@ export type GET_DomainForwardsMetricsPlatform_Response_422 = HTTPValidationError
4369
4542
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4370
4543
  *
4371
4544
  * @see {@link GET_DomainForwardsMetricsReferrer_Response_200} - 200 response type
4545
+ * @see {@link GET_DomainForwardsMetricsReferrer_Response_401} - 401 response type
4546
+ * @see {@link GET_DomainForwardsMetricsReferrer_Response_403} - 403 response type
4372
4547
  * @see {@link GET_DomainForwardsMetricsReferrer_Response_422} - 422 response type
4373
4548
  *
4374
4549
 
4375
4550
  */
4376
- export type GET_DomainForwardsMetricsReferrer_Response = GET_DomainForwardsMetricsReferrer_Response_200 | GET_DomainForwardsMetricsReferrer_Response_422;
4551
+ export type GET_DomainForwardsMetricsReferrer_Response = GET_DomainForwardsMetricsReferrer_Response_200 | GET_DomainForwardsMetricsReferrer_Response_401 | GET_DomainForwardsMetricsReferrer_Response_403 | GET_DomainForwardsMetricsReferrer_Response_422;
4377
4552
 
4378
4553
  /**
4379
4554
  * 200 response for GET DomainForwardsMetricsReferrer endpoint
@@ -4395,6 +4570,46 @@ export type GET_DomainForwardsMetricsReferrer_Response = GET_DomainForwardsMetri
4395
4570
  */
4396
4571
  export type GET_DomainForwardsMetricsReferrer_Response_200 = DomainForwardReferrerStats
4397
4572
 
4573
+ /**
4574
+ * 401 response for GET DomainForwardsMetricsReferrer endpoint
4575
+ *
4576
+ * @remarks
4577
+ * This type defines the response structure for the 401 status code
4578
+ * of the GET DomainForwardsMetricsReferrer endpoint.
4579
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4580
+ *
4581
+
4582
+ *
4583
+ * @path /v1/domain-forwards/metrics/referrer
4584
+ * @param protocol (query) - Filter by protocol: http or https
4585
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4586
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4587
+ *
4588
+ * @see {@link GET_DomainForwardsMetricsReferrer_Response} - The main response type definition
4589
+ * @see {@link Problem} - The actual schema type definition
4590
+ */
4591
+ export type GET_DomainForwardsMetricsReferrer_Response_401 = Problem
4592
+
4593
+ /**
4594
+ * 403 response for GET DomainForwardsMetricsReferrer endpoint
4595
+ *
4596
+ * @remarks
4597
+ * This type defines the response structure for the 403 status code
4598
+ * of the GET DomainForwardsMetricsReferrer endpoint.
4599
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4600
+ *
4601
+
4602
+ *
4603
+ * @path /v1/domain-forwards/metrics/referrer
4604
+ * @param protocol (query) - Filter by protocol: http or https
4605
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4606
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4607
+ *
4608
+ * @see {@link GET_DomainForwardsMetricsReferrer_Response} - The main response type definition
4609
+ * @see {@link Problem} - The actual schema type definition
4610
+ */
4611
+ export type GET_DomainForwardsMetricsReferrer_Response_403 = Problem
4612
+
4398
4613
  /**
4399
4614
  * 422 response for GET DomainForwardsMetricsReferrer endpoint
4400
4615
  *
@@ -4418,7 +4633,8 @@ export type GET_DomainForwardsMetricsReferrer_Response_422 = HTTPValidationError
4418
4633
  /**
4419
4634
  * Response types for GET DomainForwardsMetricsStatusCode endpoint
4420
4635
  *
4421
- * Status Code Stats
4636
+ * Get HTTP status code statistics
4637
+ * Retrieves distribution of HTTP redirect status codes (301, 302, 307, 308) used across forwards.
4422
4638
  *
4423
4639
  * @remarks
4424
4640
  * This type defines all possible response structures for the GET DomainForwardsMetricsStatusCode endpoint.
@@ -4433,11 +4649,13 @@ export type GET_DomainForwardsMetricsReferrer_Response_422 = HTTPValidationError
4433
4649
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4434
4650
  *
4435
4651
  * @see {@link GET_DomainForwardsMetricsStatusCode_Response_200} - 200 response type
4652
+ * @see {@link GET_DomainForwardsMetricsStatusCode_Response_401} - 401 response type
4653
+ * @see {@link GET_DomainForwardsMetricsStatusCode_Response_403} - 403 response type
4436
4654
  * @see {@link GET_DomainForwardsMetricsStatusCode_Response_422} - 422 response type
4437
4655
  *
4438
4656
 
4439
4657
  */
4440
- export type GET_DomainForwardsMetricsStatusCode_Response = GET_DomainForwardsMetricsStatusCode_Response_200 | GET_DomainForwardsMetricsStatusCode_Response_422;
4658
+ export type GET_DomainForwardsMetricsStatusCode_Response = GET_DomainForwardsMetricsStatusCode_Response_200 | GET_DomainForwardsMetricsStatusCode_Response_401 | GET_DomainForwardsMetricsStatusCode_Response_403 | GET_DomainForwardsMetricsStatusCode_Response_422;
4441
4659
 
4442
4660
  /**
4443
4661
  * 200 response for GET DomainForwardsMetricsStatusCode endpoint
@@ -4459,6 +4677,46 @@ export type GET_DomainForwardsMetricsStatusCode_Response = GET_DomainForwardsMet
4459
4677
  */
4460
4678
  export type GET_DomainForwardsMetricsStatusCode_Response_200 = DomainForwardStatusCodeStats
4461
4679
 
4680
+ /**
4681
+ * 401 response for GET DomainForwardsMetricsStatusCode endpoint
4682
+ *
4683
+ * @remarks
4684
+ * This type defines the response structure for the 401 status code
4685
+ * of the GET DomainForwardsMetricsStatusCode endpoint.
4686
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4687
+ *
4688
+
4689
+ *
4690
+ * @path /v1/domain-forwards/metrics/status-code
4691
+ * @param protocol (query) - Filter by protocol: http or https
4692
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4693
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4694
+ *
4695
+ * @see {@link GET_DomainForwardsMetricsStatusCode_Response} - The main response type definition
4696
+ * @see {@link Problem} - The actual schema type definition
4697
+ */
4698
+ export type GET_DomainForwardsMetricsStatusCode_Response_401 = Problem
4699
+
4700
+ /**
4701
+ * 403 response for GET DomainForwardsMetricsStatusCode endpoint
4702
+ *
4703
+ * @remarks
4704
+ * This type defines the response structure for the 403 status code
4705
+ * of the GET DomainForwardsMetricsStatusCode endpoint.
4706
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4707
+ *
4708
+
4709
+ *
4710
+ * @path /v1/domain-forwards/metrics/status-code
4711
+ * @param protocol (query) - Filter by protocol: http or https
4712
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4713
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4714
+ *
4715
+ * @see {@link GET_DomainForwardsMetricsStatusCode_Response} - The main response type definition
4716
+ * @see {@link Problem} - The actual schema type definition
4717
+ */
4718
+ export type GET_DomainForwardsMetricsStatusCode_Response_403 = Problem
4719
+
4462
4720
  /**
4463
4721
  * 422 response for GET DomainForwardsMetricsStatusCode endpoint
4464
4722
  *
@@ -4482,7 +4740,8 @@ export type GET_DomainForwardsMetricsStatusCode_Response_422 = HTTPValidationErr
4482
4740
  /**
4483
4741
  * Response types for GET DomainForwardsMetricsTimeSeries endpoint
4484
4742
  *
4485
- * Time Series
4743
+ * Get domain forward time series metrics
4744
+ * Retrieves visit counts bucketed by time intervals (hourly, daily) for the specified time range.
4486
4745
  *
4487
4746
  * @remarks
4488
4747
  * This type defines all possible response structures for the GET DomainForwardsMetricsTimeSeries endpoint.
@@ -4497,11 +4756,13 @@ export type GET_DomainForwardsMetricsStatusCode_Response_422 = HTTPValidationErr
4497
4756
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4498
4757
  *
4499
4758
  * @see {@link GET_DomainForwardsMetricsTimeSeries_Response_200} - 200 response type
4759
+ * @see {@link GET_DomainForwardsMetricsTimeSeries_Response_401} - 401 response type
4760
+ * @see {@link GET_DomainForwardsMetricsTimeSeries_Response_403} - 403 response type
4500
4761
  * @see {@link GET_DomainForwardsMetricsTimeSeries_Response_422} - 422 response type
4501
4762
  *
4502
4763
 
4503
4764
  */
4504
- export type GET_DomainForwardsMetricsTimeSeries_Response = GET_DomainForwardsMetricsTimeSeries_Response_200 | GET_DomainForwardsMetricsTimeSeries_Response_422;
4765
+ export type GET_DomainForwardsMetricsTimeSeries_Response = GET_DomainForwardsMetricsTimeSeries_Response_200 | GET_DomainForwardsMetricsTimeSeries_Response_401 | GET_DomainForwardsMetricsTimeSeries_Response_403 | GET_DomainForwardsMetricsTimeSeries_Response_422;
4505
4766
 
4506
4767
  /**
4507
4768
  * 200 response for GET DomainForwardsMetricsTimeSeries endpoint
@@ -4523,6 +4784,46 @@ export type GET_DomainForwardsMetricsTimeSeries_Response = GET_DomainForwardsMet
4523
4784
  */
4524
4785
  export type GET_DomainForwardsMetricsTimeSeries_Response_200 = DomainForwardMetricsTimeSeries
4525
4786
 
4787
+ /**
4788
+ * 401 response for GET DomainForwardsMetricsTimeSeries endpoint
4789
+ *
4790
+ * @remarks
4791
+ * This type defines the response structure for the 401 status code
4792
+ * of the GET DomainForwardsMetricsTimeSeries endpoint.
4793
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4794
+ *
4795
+
4796
+ *
4797
+ * @path /v1/domain-forwards/metrics/time-series
4798
+ * @param protocol (query) - Filter by protocol: http or https
4799
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4800
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4801
+ *
4802
+ * @see {@link GET_DomainForwardsMetricsTimeSeries_Response} - The main response type definition
4803
+ * @see {@link Problem} - The actual schema type definition
4804
+ */
4805
+ export type GET_DomainForwardsMetricsTimeSeries_Response_401 = Problem
4806
+
4807
+ /**
4808
+ * 403 response for GET DomainForwardsMetricsTimeSeries endpoint
4809
+ *
4810
+ * @remarks
4811
+ * This type defines the response structure for the 403 status code
4812
+ * of the GET DomainForwardsMetricsTimeSeries endpoint.
4813
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4814
+ *
4815
+
4816
+ *
4817
+ * @path /v1/domain-forwards/metrics/time-series
4818
+ * @param protocol (query) - Filter by protocol: http or https
4819
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4820
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4821
+ *
4822
+ * @see {@link GET_DomainForwardsMetricsTimeSeries_Response} - The main response type definition
4823
+ * @see {@link Problem} - The actual schema type definition
4824
+ */
4825
+ export type GET_DomainForwardsMetricsTimeSeries_Response_403 = Problem
4826
+
4526
4827
  /**
4527
4828
  * 422 response for GET DomainForwardsMetricsTimeSeries endpoint
4528
4829
  *
@@ -4546,7 +4847,8 @@ export type GET_DomainForwardsMetricsTimeSeries_Response_422 = HTTPValidationErr
4546
4847
  /**
4547
4848
  * Response types for GET DomainForwardsMetricsUserAgent endpoint
4548
4849
  *
4549
- * User Agent Stats
4850
+ * Get user agent statistics
4851
+ * Retrieves visitor traffic broken down by user agent string with total and unique visit counts.
4550
4852
  *
4551
4853
  * @remarks
4552
4854
  * This type defines all possible response structures for the GET DomainForwardsMetricsUserAgent endpoint.
@@ -4561,11 +4863,13 @@ export type GET_DomainForwardsMetricsTimeSeries_Response_422 = HTTPValidationErr
4561
4863
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4562
4864
  *
4563
4865
  * @see {@link GET_DomainForwardsMetricsUserAgent_Response_200} - 200 response type
4866
+ * @see {@link GET_DomainForwardsMetricsUserAgent_Response_401} - 401 response type
4867
+ * @see {@link GET_DomainForwardsMetricsUserAgent_Response_403} - 403 response type
4564
4868
  * @see {@link GET_DomainForwardsMetricsUserAgent_Response_422} - 422 response type
4565
4869
  *
4566
4870
 
4567
4871
  */
4568
- export type GET_DomainForwardsMetricsUserAgent_Response = GET_DomainForwardsMetricsUserAgent_Response_200 | GET_DomainForwardsMetricsUserAgent_Response_422;
4872
+ export type GET_DomainForwardsMetricsUserAgent_Response = GET_DomainForwardsMetricsUserAgent_Response_200 | GET_DomainForwardsMetricsUserAgent_Response_401 | GET_DomainForwardsMetricsUserAgent_Response_403 | GET_DomainForwardsMetricsUserAgent_Response_422;
4569
4873
 
4570
4874
  /**
4571
4875
  * 200 response for GET DomainForwardsMetricsUserAgent endpoint
@@ -4587,6 +4891,46 @@ export type GET_DomainForwardsMetricsUserAgent_Response = GET_DomainForwardsMetr
4587
4891
  */
4588
4892
  export type GET_DomainForwardsMetricsUserAgent_Response_200 = DomainForwardUserAgentStats
4589
4893
 
4894
+ /**
4895
+ * 401 response for GET DomainForwardsMetricsUserAgent endpoint
4896
+ *
4897
+ * @remarks
4898
+ * This type defines the response structure for the 401 status code
4899
+ * of the GET DomainForwardsMetricsUserAgent endpoint.
4900
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4901
+ *
4902
+
4903
+ *
4904
+ * @path /v1/domain-forwards/metrics/user-agent
4905
+ * @param protocol (query) - Filter by protocol: http or https
4906
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4907
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4908
+ *
4909
+ * @see {@link GET_DomainForwardsMetricsUserAgent_Response} - The main response type definition
4910
+ * @see {@link Problem} - The actual schema type definition
4911
+ */
4912
+ export type GET_DomainForwardsMetricsUserAgent_Response_401 = Problem
4913
+
4914
+ /**
4915
+ * 403 response for GET DomainForwardsMetricsUserAgent endpoint
4916
+ *
4917
+ * @remarks
4918
+ * This type defines the response structure for the 403 status code
4919
+ * of the GET DomainForwardsMetricsUserAgent endpoint.
4920
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4921
+ *
4922
+
4923
+ *
4924
+ * @path /v1/domain-forwards/metrics/user-agent
4925
+ * @param protocol (query) - Filter by protocol: http or https
4926
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4927
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4928
+ *
4929
+ * @see {@link GET_DomainForwardsMetricsUserAgent_Response} - The main response type definition
4930
+ * @see {@link Problem} - The actual schema type definition
4931
+ */
4932
+ export type GET_DomainForwardsMetricsUserAgent_Response_403 = Problem
4933
+
4590
4934
  /**
4591
4935
  * 422 response for GET DomainForwardsMetricsUserAgent endpoint
4592
4936
  *
@@ -4610,7 +4954,8 @@ export type GET_DomainForwardsMetricsUserAgent_Response_422 = HTTPValidationErro
4610
4954
  /**
4611
4955
  * Response types for GET DomainForwardsMetricsVisitsByKey endpoint
4612
4956
  *
4613
- * Visits By Key
4957
+ * Get visits grouped by key
4958
+ * Retrieves visit metrics grouped by a specified key (url, fqdn, domain, or forward) with total and unique visit counts.
4614
4959
  *
4615
4960
  * @remarks
4616
4961
  * This type defines all possible response structures for the GET DomainForwardsMetricsVisitsByKey endpoint.
@@ -4626,11 +4971,13 @@ export type GET_DomainForwardsMetricsUserAgent_Response_422 = HTTPValidationErro
4626
4971
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4627
4972
  *
4628
4973
  * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response_200} - 200 response type
4974
+ * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response_401} - 401 response type
4975
+ * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response_403} - 403 response type
4629
4976
  * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response_422} - 422 response type
4630
4977
  *
4631
4978
 
4632
4979
  */
4633
- export type GET_DomainForwardsMetricsVisitsByKey_Response = GET_DomainForwardsMetricsVisitsByKey_Response_200 | GET_DomainForwardsMetricsVisitsByKey_Response_422;
4980
+ export type GET_DomainForwardsMetricsVisitsByKey_Response = GET_DomainForwardsMetricsVisitsByKey_Response_200 | GET_DomainForwardsMetricsVisitsByKey_Response_401 | GET_DomainForwardsMetricsVisitsByKey_Response_403 | GET_DomainForwardsMetricsVisitsByKey_Response_422;
4634
4981
 
4635
4982
  /**
4636
4983
  * 200 response for GET DomainForwardsMetricsVisitsByKey endpoint
@@ -4653,6 +5000,48 @@ export type GET_DomainForwardsMetricsVisitsByKey_Response = GET_DomainForwardsMe
4653
5000
  */
4654
5001
  export type GET_DomainForwardsMetricsVisitsByKey_Response_200 = DomainForwardVisitsByKey
4655
5002
 
5003
+ /**
5004
+ * 401 response for GET DomainForwardsMetricsVisitsByKey endpoint
5005
+ *
5006
+ * @remarks
5007
+ * This type defines the response structure for the 401 status code
5008
+ * of the GET DomainForwardsMetricsVisitsByKey endpoint.
5009
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
5010
+ *
5011
+
5012
+ *
5013
+ * @path /v1/domain-forwards/metrics/visits-by-key
5014
+ * @param grouping (query) - Grouping key: url, fqdn, domain, or forward
5015
+ * @param protocol (query) - Filter by protocol: http or https
5016
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
5017
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
5018
+ *
5019
+ * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response} - The main response type definition
5020
+ * @see {@link Problem} - The actual schema type definition
5021
+ */
5022
+ export type GET_DomainForwardsMetricsVisitsByKey_Response_401 = Problem
5023
+
5024
+ /**
5025
+ * 403 response for GET DomainForwardsMetricsVisitsByKey endpoint
5026
+ *
5027
+ * @remarks
5028
+ * This type defines the response structure for the 403 status code
5029
+ * of the GET DomainForwardsMetricsVisitsByKey endpoint.
5030
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
5031
+ *
5032
+
5033
+ *
5034
+ * @path /v1/domain-forwards/metrics/visits-by-key
5035
+ * @param grouping (query) - Grouping key: url, fqdn, domain, or forward
5036
+ * @param protocol (query) - Filter by protocol: http or https
5037
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
5038
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
5039
+ *
5040
+ * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response} - The main response type definition
5041
+ * @see {@link Problem} - The actual schema type definition
5042
+ */
5043
+ export type GET_DomainForwardsMetricsVisitsByKey_Response_403 = Problem
5044
+
4656
5045
  /**
4657
5046
  * 422 response for GET DomainForwardsMetricsVisitsByKey endpoint
4658
5047
  *
@@ -6482,7 +6871,7 @@ export type POST_EmailForwards_Response_422 = HTTPValidationError
6482
6871
  * Response types for DELETE EmailForwardsByEmailForwardId endpoint
6483
6872
  *
6484
6873
  * Delete email forward configuration
6485
- * Permanently deletes the email forward configuration including all aliases. If enabled, automatically disables first (removes DNS records and unregisters from ImprovMX).
6874
+ * Permanently deletes the email forward configuration including all aliases. If enabled, automatically disables first (removes DNS records and unregisters from the email forwarding provider).
6486
6875
  *
6487
6876
  * @remarks
6488
6877
  * This type defines all possible response structures for the DELETE EmailForwardsByEmailForwardId endpoint.
@@ -6556,7 +6945,7 @@ export type DELETE_EmailForwardsByEmailForwardId_Response_422 = HTTPValidationEr
6556
6945
  * Response types for GET EmailForwardsByEmailForwardId endpoint
6557
6946
  *
6558
6947
  * Get email forward configuration
6559
- * Retrieves the email forward configuration for the specified zone including all aliases
6948
+ * Retrieves the email forward configuration for the specified email forward including all aliases
6560
6949
  *
6561
6950
  * @remarks
6562
6951
  * This type defines all possible response structures for the GET EmailForwardsByEmailForwardId endpoint.
@@ -6666,7 +7055,7 @@ export type GET_EmailForwardsByEmailForwardId_Response_422 = HTTPValidationError
6666
7055
  * Response types for POST EmailForwardsByEmailForwardIdAliases endpoint
6667
7056
  *
6668
7057
  * Create email forward alias
6669
- * Creates a new email forward alias for the specified hostname.
7058
+ * Creates a new email forward alias for the specified email forward. Use '*' as the alias name to configure a catch-all alias that forwards all unmatched emails for the domain.
6670
7059
  *
6671
7060
  * @remarks
6672
7061
  * This type defines all possible response structures for the POST EmailForwardsByEmailForwardIdAliases endpoint.
@@ -6794,7 +7183,7 @@ export type POST_EmailForwardsByEmailForwardIdAliases_Response_422 = HTTPValidat
6794
7183
  * Response types for DELETE EmailForwardsByEmailForwardIdAliasesByAliasId endpoint
6795
7184
  *
6796
7185
  * Delete email forward alias
6797
- * Deletes a specific email forward alias for the specified zone
7186
+ * Deletes a specific email forward alias specified by email_forward_alias_id for the specified email forward
6798
7187
  *
6799
7188
  * @remarks
6800
7189
  * This type defines all possible response structures for the DELETE EmailForwardsByEmailForwardIdAliasesByAliasId endpoint.
@@ -6886,7 +7275,7 @@ export type DELETE_EmailForwardsByEmailForwardIdAliasesByAliasId_Response_422 =
6886
7275
  * Response types for PUT EmailForwardsByEmailForwardIdAliasesByAliasId endpoint
6887
7276
  *
6888
7277
  * Update email forward alias
6889
- * Updates the forward_to address for a specific email forward alias
7278
+ * Updates the forward_to address for a specific email forward alias specified by email_forward_alias_id
6890
7279
  *
6891
7280
  * @remarks
6892
7281
  * This type defines all possible response structures for the PUT EmailForwardsByEmailForwardIdAliasesByAliasId endpoint.
@@ -6996,7 +7385,7 @@ export type PUT_EmailForwardsByEmailForwardIdAliasesByAliasId_Response_422 = HTT
6996
7385
  * Response types for PATCH EmailForwardsByEmailForwardIdDisable endpoint
6997
7386
  *
6998
7387
  * Disable email forwarding
6999
- * Disables email forwarding by removing MX and SPF DNS records and unregistering the domain from the email forward provider. The email forward configuration is preserved but disabled.
7388
+ * Disables email forwarding by removing MX and SPF DNS records and unregistering the domain from the email forwarding provider. The email forward configuration is preserved but disabled.
7000
7389
  *
7001
7390
  * @remarks
7002
7391
  * This type defines all possible response structures for the PATCH EmailForwardsByEmailForwardIdDisable endpoint.
@@ -7088,7 +7477,7 @@ export type PATCH_EmailForwardsByEmailForwardIdDisable_Response_422 = HTTPValida
7088
7477
  * Response types for PATCH EmailForwardsByEmailForwardIdEnable endpoint
7089
7478
  *
7090
7479
  * Enable email forwarding
7091
- * Enables email forwarding by creating necessary MX and SPF DNS records and registering the domain with the email forward provider.
7480
+ * Enables email forwarding by creating necessary MX and SPF DNS records and registering the domain with the email forwarding provider.
7092
7481
  *
7093
7482
  * @remarks
7094
7483
  * This type defines all possible response structures for the PATCH EmailForwardsByEmailForwardIdEnable endpoint.