@opusdns/api 0.52.0 → 0.53.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.
package/package.json CHANGED
@@ -8,7 +8,7 @@
8
8
  "typescript": "^5.8.2"
9
9
  },
10
10
  "name": "@opusdns/api",
11
- "version": "0.52.0",
11
+ "version": "0.53.0",
12
12
  "description": "TypeScript types for the OpusDNS OpenAPI specification",
13
13
  "main": "./src/index.ts",
14
14
  "module": "./src/index.ts",
@@ -9489,7 +9489,7 @@ export const KEYS_IDN_BASE = [
9489
9489
  /**
9490
9490
  * Ip Network
9491
9491
  *
9492
- * IP address or CIDR range for the restriction.
9492
+ * IP address or CIDR network range. Individual IPs can be specified without CIDR notation.
9493
9493
  *
9494
9494
  * @type {string}
9495
9495
  *
@@ -9591,7 +9591,7 @@ export const KEY_IP_RESTRICTION_CREATED_ON = 'created_on' as keyof IpRestriction
9591
9591
  /**
9592
9592
  * Ip Network
9593
9593
  *
9594
- * IP address or CIDR range for the restriction.
9594
+ * IP address or CIDR network range. Single IPs are returned with /32 (IPv4) or /128 (IPv6) notation.
9595
9595
  *
9596
9596
  * @type {string}
9597
9597
  *
@@ -9720,7 +9720,7 @@ export const KEYS_IP_RESTRICTION = [
9720
9720
  /**
9721
9721
  * Ip Network
9722
9722
  *
9723
- * IP address or CIDR range for the restriction.
9723
+ * IP address or CIDR network range to replace the existing restriction.
9724
9724
  *
9725
9725
  *
9726
9726
  *
@@ -2952,7 +2952,10 @@ export type PATCH_OrganizationsAttributesOrganizationId_Request_Body = PATCH_Org
2952
2952
  * Request type for GET OrganizationsIpRestrictions endpoint
2953
2953
  *
2954
2954
  * List Ip Restrictions
2955
- * Get all IP restrictions for the organization
2955
+ * List all IP restrictions for the organization.
2956
+
2957
+ Returns a list of all IP restrictions configured for your organization.
2958
+ Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
2956
2959
  *
2957
2960
  * @remarks
2958
2961
  * This type defines the complete request structure for the GET OrganizationsIpRestrictions endpoint.
@@ -2975,7 +2978,10 @@ export type GET_OrganizationsIpRestrictions_Request = {
2975
2978
  * Request type for POST OrganizationsIpRestrictions endpoint
2976
2979
  *
2977
2980
  * Create Ip Restriction
2978
- * Create a new IP restriction for the organization
2981
+ * Create a new IP restriction for the organization.
2982
+
2983
+ Accepts either a single IP address or a CIDR network range.
2984
+ Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
2979
2985
  *
2980
2986
  * @remarks
2981
2987
  * This type defines the complete request structure for the POST OrganizationsIpRestrictions endpoint.
@@ -3012,7 +3018,9 @@ export type POST_OrganizationsIpRestrictions_Request_Body = POST_OrganizationsIp
3012
3018
  * Request type for DELETE OrganizationsIpRestrictionsIpRestrictionId endpoint
3013
3019
  *
3014
3020
  * Delete Ip Restriction
3015
- * Delete an IP restriction
3021
+ * Delete an IP restriction.
3022
+
3023
+ Permanently removes the specified IP restriction from your organization.
3016
3024
  *
3017
3025
  * @remarks
3018
3026
  * This type defines the complete request structure for the DELETE OrganizationsIpRestrictionsIpRestrictionId endpoint.
@@ -3051,7 +3059,10 @@ export type DELETE_OrganizationsIpRestrictionsIpRestrictionId_Request_Path = DEL
3051
3059
  * Request type for GET OrganizationsIpRestrictionsIpRestrictionId endpoint
3052
3060
  *
3053
3061
  * Get Ip Restriction
3054
- * Get a specific IP restriction by ID
3062
+ * Get a specific IP restriction by ID.
3063
+
3064
+ Returns the details of a specific IP restriction if it exists and belongs to your organization.
3065
+ Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
3055
3066
  *
3056
3067
  * @remarks
3057
3068
  * This type defines the complete request structure for the GET OrganizationsIpRestrictionsIpRestrictionId endpoint.
@@ -3090,7 +3101,10 @@ export type GET_OrganizationsIpRestrictionsIpRestrictionId_Request_Path = GET_Or
3090
3101
  * Request type for PATCH OrganizationsIpRestrictionsIpRestrictionId endpoint
3091
3102
  *
3092
3103
  * Update Ip Restriction
3093
- * Update an IP restriction
3104
+ * Update an existing IP restriction.
3105
+
3106
+ You can update the IP network range or the last usage timestamp.
3107
+ Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
3094
3108
  *
3095
3109
  * @remarks
3096
3110
  * This type defines the complete request structure for the PATCH OrganizationsIpRestrictionsIpRestrictionId endpoint.
@@ -4759,7 +4759,10 @@ export type GET_OrganizationsByOrganizationIdPricingProductTypeByProductType_Res
4759
4759
  * Response types for GET OrganizationsIpRestrictions endpoint
4760
4760
  *
4761
4761
  * List Ip Restrictions
4762
- * Get all IP restrictions for the organization
4762
+ * List all IP restrictions for the organization.
4763
+
4764
+ Returns a list of all IP restrictions configured for your organization.
4765
+ Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
4763
4766
  *
4764
4767
  * @remarks
4765
4768
  * This type defines all possible response structures for the GET OrganizationsIpRestrictions endpoint.
@@ -4797,7 +4800,10 @@ export type GET_OrganizationsIpRestrictions_Response_200 = IpRestrictionArray
4797
4800
  * Response types for POST OrganizationsIpRestrictions endpoint
4798
4801
  *
4799
4802
  * Create Ip Restriction
4800
- * Create a new IP restriction for the organization
4803
+ * Create a new IP restriction for the organization.
4804
+
4805
+ Accepts either a single IP address or a CIDR network range.
4806
+ Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
4801
4807
  *
4802
4808
  * @remarks
4803
4809
  * This type defines all possible response structures for the POST OrganizationsIpRestrictions endpoint.
@@ -4853,7 +4859,9 @@ export type POST_OrganizationsIpRestrictions_Response_422 = HTTPValidationError
4853
4859
  * Response types for DELETE OrganizationsIpRestrictionsByIpRestrictionId endpoint
4854
4860
  *
4855
4861
  * Delete Ip Restriction
4856
- * Delete an IP restriction
4862
+ * Delete an IP restriction.
4863
+
4864
+ Permanently removes the specified IP restriction from your organization.
4857
4865
  *
4858
4866
  * @remarks
4859
4867
  * This type defines all possible response structures for the DELETE OrganizationsIpRestrictionsByIpRestrictionId endpoint.
@@ -4891,7 +4899,10 @@ export type DELETE_OrganizationsIpRestrictionsByIpRestrictionId_Response_422 = H
4891
4899
  * Response types for GET OrganizationsIpRestrictionsByIpRestrictionId endpoint
4892
4900
  *
4893
4901
  * Get Ip Restriction
4894
- * Get a specific IP restriction by ID
4902
+ * Get a specific IP restriction by ID.
4903
+
4904
+ Returns the details of a specific IP restriction if it exists and belongs to your organization.
4905
+ Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
4895
4906
  *
4896
4907
  * @remarks
4897
4908
  * This type defines all possible response structures for the GET OrganizationsIpRestrictionsByIpRestrictionId endpoint.
@@ -4947,7 +4958,10 @@ export type GET_OrganizationsIpRestrictionsByIpRestrictionId_Response_422 = HTTP
4947
4958
  * Response types for PATCH OrganizationsIpRestrictionsByIpRestrictionId endpoint
4948
4959
  *
4949
4960
  * Update Ip Restriction
4950
- * Update an IP restriction
4961
+ * Update an existing IP restriction.
4962
+
4963
+ You can update the IP network range or the last usage timestamp.
4964
+ Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
4951
4965
  *
4952
4966
  * @remarks
4953
4967
  * This type defines all possible response structures for the PATCH OrganizationsIpRestrictionsByIpRestrictionId endpoint.
@@ -1499,7 +1499,10 @@ export type HTTPValidationError = components['schemas']['HTTPValidationError'];
1499
1499
  */
1500
1500
  export type IdnBase = components['schemas']['IdnBase'];
1501
1501
  /**
1502
- * IpRestrictionCreate
1502
+ * IpRestrictionCreate. Create an IP restriction for an organization.
1503
+
1504
+ Accepts either a single IP address or a CIDR network range.
1505
+ Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
1503
1506
  *
1504
1507
  * @remarks
1505
1508
  * Type alias for the `IpRestrictionCreate` OpenAPI schema.
@@ -1531,7 +1534,9 @@ export type IpRestrictionCreate = components['schemas']['IpRestrictionCreate'];
1531
1534
  */
1532
1535
  export type IpRestriction = components['schemas']['IpRestrictionResponse'];
1533
1536
  /**
1534
- * IpRestrictionUpdate
1537
+ * IpRestrictionUpdate. Update an existing IP restriction.
1538
+
1539
+ You can update the IP network range or the last usage timestamp.
1535
1540
  *
1536
1541
  * @remarks
1537
1542
  * Type alias for the `IpRestrictionUpdate` OpenAPI schema.
package/src/openapi.yaml CHANGED
@@ -2352,11 +2352,22 @@ components:
2352
2352
  title: IdnBase
2353
2353
  type: object
2354
2354
  IpRestrictionCreate:
2355
+ description: 'Create an IP restriction for an organization.
2356
+
2357
+
2358
+ Accepts either a single IP address or a CIDR network range.
2359
+
2360
+ Individual IP addresses are stored and returned with CIDR notation (/32 for
2361
+ IPv4, /128 for IPv6).'
2355
2362
  properties:
2356
2363
  ip_network:
2357
- description: IP address or CIDR range for the restriction.
2364
+ description: IP address or CIDR network range. Individual IPs can be specified
2365
+ without CIDR notation.
2358
2366
  examples:
2367
+ - 192.0.2.1
2359
2368
  - 192.0.2.0/24
2369
+ - 2001:db8::1
2370
+ - 2001:db8::/32
2360
2371
  format: ipvanynetwork
2361
2372
  title: Ip Network
2362
2373
  type: string
@@ -2379,9 +2390,13 @@ components:
2379
2390
  title: Created On
2380
2391
  type: string
2381
2392
  ip_network:
2382
- description: IP address or CIDR range for the restriction.
2393
+ description: IP address or CIDR network range. Single IPs are returned with
2394
+ /32 (IPv4) or /128 (IPv6) notation.
2383
2395
  examples:
2396
+ - 192.0.2.1/32
2384
2397
  - 192.0.2.0/24
2398
+ - 2001:db8::1/128
2399
+ - 2001:db8::/32
2385
2400
  format: ipvanynetwork
2386
2401
  title: Ip Network
2387
2402
  type: string
@@ -2410,15 +2425,22 @@ components:
2410
2425
  title: IpRestrictionResponse
2411
2426
  type: object
2412
2427
  IpRestrictionUpdate:
2428
+ description: 'Update an existing IP restriction.
2429
+
2430
+
2431
+ You can update the IP network range or the last usage timestamp.'
2413
2432
  properties:
2414
2433
  ip_network:
2415
2434
  anyOf:
2416
2435
  - format: ipvanynetwork
2417
2436
  type: string
2418
2437
  - type: 'null'
2419
- description: IP address or CIDR range for the restriction.
2438
+ description: IP address or CIDR network range to replace the existing restriction.
2420
2439
  examples:
2440
+ - 192.0.2.1
2421
2441
  - 192.0.2.0/24
2442
+ - 2001:db8::1
2443
+ - 2001:db8::/32
2422
2444
  title: Ip Network
2423
2445
  last_used_on:
2424
2446
  anyOf:
@@ -5335,7 +5357,7 @@ info:
5335
5357
  '
5336
5358
  summary: OpusDNS - your gateway to a seamless domain management experience.
5337
5359
  title: OpusDNS API
5338
- version: 2025-09-18-131050
5360
+ version: 2025-09-18-175058
5339
5361
  x-logo:
5340
5362
  altText: OpusDNS API Reference
5341
5363
  url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -8879,7 +8901,13 @@ paths:
8879
8901
  - organization
8880
8902
  /v1/organizations/ip-restrictions:
8881
8903
  get:
8882
- description: Get all IP restrictions for the organization
8904
+ description: 'List all IP restrictions for the organization.
8905
+
8906
+
8907
+ Returns a list of all IP restrictions configured for your organization.
8908
+
8909
+ Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for
8910
+ IPv6).'
8883
8911
  operationId: list_ip_restrictions_v1_organizations_ip_restrictions_get
8884
8912
  responses:
8885
8913
  '200':
@@ -8898,7 +8926,13 @@ paths:
8898
8926
  tags:
8899
8927
  - organization
8900
8928
  post:
8901
- description: Create a new IP restriction for the organization
8929
+ description: 'Create a new IP restriction for the organization.
8930
+
8931
+
8932
+ Accepts either a single IP address or a CIDR network range.
8933
+
8934
+ Individual IP addresses are stored and returned with CIDR notation (/32 for
8935
+ IPv4, /128 for IPv6).'
8902
8936
  operationId: create_ip_restriction_v1_organizations_ip_restrictions_post
8903
8937
  requestBody:
8904
8938
  content:
@@ -8926,7 +8960,10 @@ paths:
8926
8960
  - organization
8927
8961
  /v1/organizations/ip-restrictions/{ip_restriction_id}:
8928
8962
  delete:
8929
- description: Delete an IP restriction
8963
+ description: 'Delete an IP restriction.
8964
+
8965
+
8966
+ Permanently removes the specified IP restriction from your organization.'
8930
8967
  operationId: delete_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__delete
8931
8968
  parameters:
8932
8969
  - in: path
@@ -8950,7 +8987,14 @@ paths:
8950
8987
  tags:
8951
8988
  - organization
8952
8989
  get:
8953
- description: Get a specific IP restriction by ID
8990
+ description: 'Get a specific IP restriction by ID.
8991
+
8992
+
8993
+ Returns the details of a specific IP restriction if it exists and belongs
8994
+ to your organization.
8995
+
8996
+ Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for
8997
+ IPv6).'
8954
8998
  operationId: get_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__get
8955
8999
  parameters:
8956
9000
  - in: path
@@ -8978,7 +9022,13 @@ paths:
8978
9022
  tags:
8979
9023
  - organization
8980
9024
  patch:
8981
- description: Update an IP restriction
9025
+ description: 'Update an existing IP restriction.
9026
+
9027
+
9028
+ You can update the IP network range or the last usage timestamp.
9029
+
9030
+ Individual IP addresses are stored and returned with CIDR notation (/32 for
9031
+ IPv4, /128 for IPv6).'
8982
9032
  operationId: update_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__patch
8983
9033
  parameters:
8984
9034
  - in: path
package/src/schema.d.ts CHANGED
@@ -861,13 +861,19 @@ export interface paths {
861
861
  };
862
862
  /**
863
863
  * List Ip Restrictions
864
- * @description Get all IP restrictions for the organization
864
+ * @description List all IP restrictions for the organization.
865
+ *
866
+ * Returns a list of all IP restrictions configured for your organization.
867
+ * Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
865
868
  */
866
869
  get: operations["list_ip_restrictions_v1_organizations_ip_restrictions_get"];
867
870
  put?: never;
868
871
  /**
869
872
  * Create Ip Restriction
870
- * @description Create a new IP restriction for the organization
873
+ * @description Create a new IP restriction for the organization.
874
+ *
875
+ * Accepts either a single IP address or a CIDR network range.
876
+ * Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
871
877
  */
872
878
  post: operations["create_ip_restriction_v1_organizations_ip_restrictions_post"];
873
879
  delete?: never;
@@ -885,21 +891,29 @@ export interface paths {
885
891
  };
886
892
  /**
887
893
  * Get Ip Restriction
888
- * @description Get a specific IP restriction by ID
894
+ * @description Get a specific IP restriction by ID.
895
+ *
896
+ * Returns the details of a specific IP restriction if it exists and belongs to your organization.
897
+ * Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
889
898
  */
890
899
  get: operations["get_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__get"];
891
900
  put?: never;
892
901
  post?: never;
893
902
  /**
894
903
  * Delete Ip Restriction
895
- * @description Delete an IP restriction
904
+ * @description Delete an IP restriction.
905
+ *
906
+ * Permanently removes the specified IP restriction from your organization.
896
907
  */
897
908
  delete: operations["delete_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__delete"];
898
909
  options?: never;
899
910
  head?: never;
900
911
  /**
901
912
  * Update Ip Restriction
902
- * @description Update an IP restriction
913
+ * @description Update an existing IP restriction.
914
+ *
915
+ * You can update the IP network range or the last usage timestamp.
916
+ * Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
903
917
  */
904
918
  patch: operations["update_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__patch"];
905
919
  trace?: never;
@@ -2749,12 +2763,18 @@ export interface components {
2749
2763
  */
2750
2764
  idn_tables?: string[] | null;
2751
2765
  };
2752
- /** IpRestrictionCreate */
2766
+ /**
2767
+ * IpRestrictionCreate
2768
+ * @description Create an IP restriction for an organization.
2769
+ *
2770
+ * Accepts either a single IP address or a CIDR network range.
2771
+ * Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
2772
+ */
2753
2773
  IpRestrictionCreate: {
2754
2774
  /**
2755
2775
  * Ip Network
2756
2776
  * Format: ipvanynetwork
2757
- * @description IP address or CIDR range for the restriction.
2777
+ * @description IP address or CIDR network range. Individual IPs can be specified without CIDR notation.
2758
2778
  */
2759
2779
  ip_network: string;
2760
2780
  /**
@@ -2773,7 +2793,7 @@ export interface components {
2773
2793
  /**
2774
2794
  * Ip Network
2775
2795
  * Format: ipvanynetwork
2776
- * @description IP address or CIDR range for the restriction.
2796
+ * @description IP address or CIDR network range. Single IPs are returned with /32 (IPv4) or /128 (IPv6) notation.
2777
2797
  */
2778
2798
  ip_network: string;
2779
2799
  /** Ip Restriction Id */
@@ -2786,11 +2806,16 @@ export interface components {
2786
2806
  */
2787
2807
  organization_id: TypeId<"organization">;
2788
2808
  };
2789
- /** IpRestrictionUpdate */
2809
+ /**
2810
+ * IpRestrictionUpdate
2811
+ * @description Update an existing IP restriction.
2812
+ *
2813
+ * You can update the IP network range or the last usage timestamp.
2814
+ */
2790
2815
  IpRestrictionUpdate: {
2791
2816
  /**
2792
2817
  * Ip Network
2793
- * @description IP address or CIDR range for the restriction.
2818
+ * @description IP address or CIDR network range to replace the existing restriction.
2794
2819
  */
2795
2820
  ip_network?: string | null;
2796
2821
  /**