@opusdns/api 0.52.0 → 0.54.0

package/package.json

@@ -8,7 +8,7 @@
     "typescript": "^5.8.2"
   },
   "name": "@opusdns/api",
-  "version": "0.52.0",
+  "version": "0.54.0",
   "description": "TypeScript types for the OpusDNS OpenAPI specification",
   "main": "./src/index.ts",
   "module": "./src/index.ts",

package/src/helpers/constants.ts

@@ -21,7 +21,7 @@
  * ```
  */
 
-import { AgreementType, AllocationMethodType, BillingTransactionAction, BillingTransactionProductType, ContactRoleType, ContactSortField, Currency, DeletePolicyType, DnsChangeAction, DnsRrsetType, DnssecAlgorithm, DnssecDigestType, DnssecModeType, DnssecRecordType, DnssecStatus, DomainAvailabilityStatus, DomainClientStatus, DomainContactType, DomainSortField, DomainStatus, EmailVerificationStatus, EventObjectType, EventSubtype, EventType, GrantType, LaunchPhaseType, LocalPresenceRequirementType, OrganizationCredentialStatus, OrganizationStatus, PatchOp, PeriodUnit, Permission, PostTransferRequirements, PostalAddressType, PremiumAffectsType, PremiumSourceType, RegistrantChangeType, RegistryHandleAttributeType, Relation, RenewalMode, ReservedSourceType, SortOrder, SyncOperationType, TLDType, TransferAckType, UserNotificationStatus, UserStatus, VerificationType, ZoneSortField } from './schemas';
+import { AgreementType, AllocationMethodType, BillingTransactionAction, BillingTransactionProductType, ContactRoleType, ContactSortField, Currency, DeletePolicyType, DnsChangeAction, DnsRrsetType, DnssecAlgorithm, DnssecDigestType, DnssecModeType, DnssecRecordType, DnssecStatus, DomainAvailabilityStatus, DomainClientStatus, DomainContactType, DomainSortField, DomainStatus, EmailVerificationStatus, EventObjectType, EventSubtype, EventType, GrantType, LaunchPhaseType, LocalPresenceRequirementType, OrganizationCredentialStatus, OrganizationStatus, PatchOp, PeriodUnit, Permission, PlanRelation, PostTransferRequirements, PostalAddressType, PremiumAffectsType, PremiumSourceType, RegistrantChangeType, RegistryHandleAttributeType, Relation, RenewalMode, ReservedSourceType, SortOrder, SyncOperationType, TLDType, TransferAckType, UserNotificationStatus, UserStatus, VerificationType, ZoneSortField } from './schemas';
 
 /**
  * AgreementType. Auto-generated enum for AgreementType
@@ -1809,6 +1809,62 @@ export const PERMISSION_VALUES = [
   'view_events'
 ] as const satisfies [string, ...string[]] | Permission[];
 
+/**
+ * PlanRelation. Auto-generated enum for PlanRelation
+ *
+ * @remarks
+ * This constant provides both object and array forms for the PlanRelation enum.
+ * The object form allows key-value access, while the array form enables iteration and validation.
+ *
+ * @example
+ * ```typescript
+ * // Using the object form for key-value access
+ * const status = PLAN_RELATION.SUCCESS;
+ * 
+ * // Using the array form for iteration
+ * const allStatuses = PLAN_RELATION_VALUES;
+ * console.log(`Available statuses: ${allStatuses.join(', ')}`);
+ * ```
+ *
+ * @see {@link PlanRelation} - The TypeScript type definition
+ */
+export const PLAN_RELATION = {
+  BASIC: "basic",
+  ENTERPRISE: "enterprise",
+  CORPORATE: "corporate",
+  PREMIUM: "premium",
+  STARTER: "starter",
+} as const satisfies Record<string, PlanRelation>;
+
+/**
+ * Array of all PlanRelation enum values
+ *
+ * @remarks
+ * This constant provides a array containing all valid PlanRelation enum values.
+ * Useful for iteration, validation, and generating dynamic UI components.
+ *
+ * @example
+ * ```typescript
+ * // Iterating through all values
+ * for (const value of PLAN_RELATION_VALUES) {
+ *   console.log(`Processing: ${value}`);
+ * }
+ * 
+ * // Validation
+ * const isValid = PLAN_RELATION_VALUES.includes(someValue);
+ * ```
+ *
+ * @see {@link PlanRelation} - The TypeScript type definition
+ * @see {@link PLAN_RELATION} - The object form of this enum
+ */
+export const PLAN_RELATION_VALUES = [
+  'basic',
+  'enterprise',
+  'corporate',
+  'premium',
+  'starter'
+] as const satisfies [string, ...string[]] | PlanRelation[];
+
 /**
  * PostTransferRequirements. Auto-generated enum for PostTransferRequirements
  *

package/src/helpers/keys.ts

@@ -121,6 +121,7 @@ import { PasswordUpdate } from './schemas';
 import { Period } from './schemas';
 import { PermissionSet } from './schemas';
 import { PlanInfo } from './schemas';
+import { PlanUpdate } from './schemas';
 import { PremiumDomainsBase } from './schemas';
 import { PriceInfo } from './schemas';
 import { Problem } from './schemas';
@@ -9489,7 +9490,7 @@ export const KEYS_IDN_BASE = [
 /**
  * Ip Network
  *
- * IP address or CIDR range for the restriction.
+ * IP address or CIDR network range. Individual IPs can be specified without CIDR notation.
  *
  * @type {string}
  *
@@ -9591,7 +9592,7 @@ export const KEY_IP_RESTRICTION_CREATED_ON = 'created_on' as keyof IpRestriction
 /**
  * Ip Network
  *
- * IP address or CIDR range for the restriction.
+ * IP address or CIDR network range. Single IPs are returned with /32 (IPv4) or /128 (IPv6) notation.
  *
  * @type {string}
  *
@@ -9720,7 +9721,7 @@ export const KEYS_IP_RESTRICTION = [
 /**
  * Ip Network
  *
- * IP address or CIDR range for the restriction.
+ * IP address or CIDR network range to replace the existing restriction.
  *
  *
  *
@@ -15081,6 +15082,55 @@ export const KEYS_PLAN_INFO = [
   KEY_PLAN_INFO_PLAN_TYPE,
 ] as const satisfies (keyof PlanInfo)[];
 
+/**
+ * plan property
+ *
+ *
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `plan` property of PlanUpdate objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = planupdate[KEY_PLAN_UPDATE_PLAN];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_PLAN_UPDATE_PLAN;
+ * const value = planupdate[propertyName];
+ * ```
+ *
+ * @see {@link PlanUpdate} - The TypeScript type definition
+ * @see {@link KEYS_PLAN_UPDATE} - Array of all keys for this type
+ */
+export const KEY_PLAN_UPDATE_PLAN = 'plan' as keyof PlanUpdate;
+
+/**
+ * Array of all PlanUpdate property keys
+ *
+ * @remarks
+ * This constant provides a readonly array containing all valid property keys for PlanUpdate objects.
+ * Useful for iteration, validation, and generating dynamic UI components.
+ *
+ * @example
+ * ```typescript
+ * // Iterating through all keys
+ * for (const key of KEYS_PLAN_UPDATE) {
+ *   console.log(`Property: ${key}, Value: ${planupdate[key]}`);
+ * }
+ * 
+ * // Validation
+ * const isValidKey = KEYS_PLAN_UPDATE.includes(someKey);
+ * ```
+ *
+ * @see {@link PlanUpdate} - The TypeScript type definition
+ */
+export const KEYS_PLAN_UPDATE = [
+  KEY_PLAN_UPDATE_PLAN,
+] as const satisfies (keyof PlanUpdate)[];
+
 /**
  * Affects
  *

package/src/helpers/requests.d.ts

@@ -34,7 +34,7 @@ import { operations } from '../schema';
 
 import { DomainDnssecDataCreateArray, OrganizationAttributeUpdateArray } from './schemas-arrays.d';
 
-import { OrganizationCredentialExtra, SignupCreate, ContactCreate, DnsZoneCreate, DnsZoneRecordsPatchOps, DnsZoneRrsetsPatchOps, DnsZoneRrsetsCreate, DomainCreate, DomainUpdate, DomainRenewRequest, DomainRestoreRequest, DomainTransferIn, EmailForwardAlias, EmailForwardAliasUpdate, NotificationCreate, NotificationUpdate, OrganizationCreate, IpRestrictionCreate, IpRestrictionUpdate, OrganizationUpdate, UserCreate, StartPasswordReset, PasswordUpdate, UserUpdate, SpiceDbRelationshipUpdate } from './schemas.d';
+import { OrganizationCredentialExtra, SignupCreate, ContactCreate, DnsZoneCreate, DnsZoneRecordsPatchOps, DnsZoneRrsetsPatchOps, DnsZoneRrsetsCreate, DomainCreate, DomainUpdate, DomainRenewRequest, DomainRestoreRequest, DomainTransferIn, EmailForwardAlias, EmailForwardAliasUpdate, NotificationCreate, NotificationUpdate, OrganizationCreate, IpRestrictionCreate, IpRestrictionUpdate, OrganizationUpdate, PlanUpdate, UserCreate, StartPasswordReset, PasswordUpdate, UserUpdate, SpiceDbRelationshipUpdate } from './schemas.d';
 
 /**
  * Request type for GET AuthClientCredentials endpoint
@@ -2952,7 +2952,10 @@ export type PATCH_OrganizationsAttributesOrganizationId_Request_Body = PATCH_Org
  * Request type for GET OrganizationsIpRestrictions endpoint
  *
  * List Ip Restrictions
- * Get all IP restrictions for the organization
+ * List all IP restrictions for the organization.
+
+Returns a list of all IP restrictions configured for your organization.
+Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * This type defines the complete request structure for the GET OrganizationsIpRestrictions endpoint.
@@ -2975,7 +2978,10 @@ export type GET_OrganizationsIpRestrictions_Request = {
  * Request type for POST OrganizationsIpRestrictions endpoint
  *
  * Create Ip Restriction
- * Create a new IP restriction for the organization
+ * Create a new IP restriction for the organization.
+
+Accepts either a single IP address or a CIDR network range.
+Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * This type defines the complete request structure for the POST OrganizationsIpRestrictions endpoint.
@@ -3012,7 +3018,9 @@ export type POST_OrganizationsIpRestrictions_Request_Body = POST_OrganizationsIp
  * Request type for DELETE OrganizationsIpRestrictionsIpRestrictionId endpoint
  *
  * Delete Ip Restriction
- * Delete an IP restriction
+ * Delete an IP restriction.
+
+Permanently removes the specified IP restriction from your organization.
  *
  * @remarks
  * This type defines the complete request structure for the DELETE OrganizationsIpRestrictionsIpRestrictionId endpoint.
@@ -3051,7 +3059,10 @@ export type DELETE_OrganizationsIpRestrictionsIpRestrictionId_Request_Path = DEL
  * Request type for GET OrganizationsIpRestrictionsIpRestrictionId endpoint
  *
  * Get Ip Restriction
- * Get a specific IP restriction by ID
+ * Get a specific IP restriction by ID.
+
+Returns the details of a specific IP restriction if it exists and belongs to your organization.
+Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * This type defines the complete request structure for the GET OrganizationsIpRestrictionsIpRestrictionId endpoint.
@@ -3090,7 +3101,10 @@ export type GET_OrganizationsIpRestrictionsIpRestrictionId_Request_Path = GET_Or
  * Request type for PATCH OrganizationsIpRestrictionsIpRestrictionId endpoint
  *
  * Update Ip Restriction
- * Update an IP restriction
+ * Update an existing IP restriction.
+
+You can update the IP network range or the last usage timestamp.
+Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * This type defines the complete request structure for the PATCH OrganizationsIpRestrictionsIpRestrictionId endpoint.
@@ -3267,6 +3281,58 @@ export type PATCH_OrganizationsOrganizationId_Request_Path = PATCH_Organizations
  */
 export type PATCH_OrganizationsOrganizationId_Request_Body = PATCH_OrganizationsOrganizationId_Request['requestBody'];
 
+/**
+ * Request type for PATCH OrganizationsOrganizationIdPlan endpoint
+ *
+ * Change Plan
+ *
+ * @remarks
+ * This type defines the complete request structure for the PATCH OrganizationsOrganizationIdPlan endpoint.
+ * It includes all parameters (query, path) and request body types as defined in the OpenAPI specification.
+ * Use this type to ensure type safety when making API requests to this endpoint.
+ *
+ * @example
+ * Use this type to ensure type safety when making API requests to this endpoint.
+ *
+ * @path /v1/organizations/{organization_id}/plan
+ *
+ * @see {@link PATCH_OrganizationsOrganizationIdPlan_Request_Query} - Query parameters type
+ * @see {@link PATCH_OrganizationsOrganizationIdPlan_Request_Path} - Path parameters type
+ * @see {@link PATCH_OrganizationsOrganizationIdPlan_Request_Body} - Request body type
+ */
+export type PATCH_OrganizationsOrganizationIdPlan_Request = {
+  parameters: {
+    path: operations['change_plan_v1_organizations__organization_id__plan_patch']['parameters']['path'];
+  };
+  requestBody: PlanUpdate;
+}
+/**
+ * Path parameters for PATCH /v1/organizations/{organization_id}/plan
+ *
+ * @remarks
+ * This type defines the path parameters for the PATCH /v1/organizations/{organization_id}/plan endpoint.
+ * It provides type safety for all path parameters as defined in the OpenAPI specification.
+ *
+ * @example
+ * Use this type to ensure type safety for path parameters.
+ *
+ * @path /v1/organizations/{organization_id}/plan
+ */
+export type PATCH_OrganizationsOrganizationIdPlan_Request_Path = PATCH_OrganizationsOrganizationIdPlan_Request['parameters']['path'];
+/**
+ * Request body for PATCH /v1/organizations/{organization_id}/plan
+ *
+ * @remarks
+ * This type defines the request body structure for the PATCH /v1/organizations/{organization_id}/plan endpoint.
+ * It provides type safety for the request body as defined in the OpenAPI specification.
+ *
+ * @example
+ * Use this type to ensure type safety for request body structure.
+ *
+ * @path /v1/organizations/{organization_id}/plan
+ */
+export type PATCH_OrganizationsOrganizationIdPlan_Request_Body = PATCH_OrganizationsOrganizationIdPlan_Request['requestBody'];
+
 /**
  * Request type for GET OrganizationsOrganizationIdPlans endpoint
  *

package/src/helpers/responses.d.ts

@@ -4645,6 +4645,61 @@ export type PATCH_OrganizationsByOrganizationId_Response_200 = Organization
  */
 export type PATCH_OrganizationsByOrganizationId_Response_422 = HTTPValidationError
 
+/**
+ * Response types for PATCH OrganizationsByOrganizationIdPlan endpoint
+ *
+ * Change Plan
+ *
+ * @remarks
+ * This type defines all possible response structures for the PATCH OrganizationsByOrganizationIdPlan endpoint.
+ * Each response code maps to a specific response type as defined in the OpenAPI specification.
+ * Use this type to ensure type safety when handling API responses from this endpoint.
+ *
+
+ *
+ * @path /v1/organizations/{organization_id}/plan
+ *
+ * @see {@link PATCH_OrganizationsByOrganizationIdPlan_Response_200} - 200 response type
+ * @see {@link PATCH_OrganizationsByOrganizationIdPlan_Response_422} - 422 response type
+ *
+
+ */
+export type PATCH_OrganizationsByOrganizationIdPlan_Response = PATCH_OrganizationsByOrganizationIdPlan_Response_200 | PATCH_OrganizationsByOrganizationIdPlan_Response_422;
+
+/**
+ * 200 response for PATCH OrganizationsByOrganizationIdPlan endpoint
+ *
+ * @remarks
+ * This type defines the response structure for the 200 status code
+ * of the PATCH OrganizationsByOrganizationIdPlan endpoint.
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
+ *
+
+ *
+ * @path /v1/organizations/{organization_id}/plan
+ *
+ * @see {@link PATCH_OrganizationsByOrganizationIdPlan_Response} - The main response type definition
+ * @see {@link OrganizationWithBillingData} - The actual schema type definition
+ */
+export type PATCH_OrganizationsByOrganizationIdPlan_Response_200 = OrganizationWithBillingData
+
+/**
+ * 422 response for PATCH OrganizationsByOrganizationIdPlan endpoint
+ *
+ * @remarks
+ * This type defines the response structure for the 422 status code
+ * of the PATCH OrganizationsByOrganizationIdPlan endpoint.
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
+ *
+
+ *
+ * @path /v1/organizations/{organization_id}/plan
+ *
+ * @see {@link PATCH_OrganizationsByOrganizationIdPlan_Response} - The main response type definition
+ * @see {@link HTTPValidationError} - The actual schema type definition
+ */
+export type PATCH_OrganizationsByOrganizationIdPlan_Response_422 = HTTPValidationError
+
 /**
  * Response types for GET OrganizationsByOrganizationIdPlans endpoint
  *
@@ -4759,7 +4814,10 @@ export type GET_OrganizationsByOrganizationIdPricingProductTypeByProductType_Res
  * Response types for GET OrganizationsIpRestrictions endpoint
  *
  * List Ip Restrictions
- * Get all IP restrictions for the organization
+ * List all IP restrictions for the organization.
+
+Returns a list of all IP restrictions configured for your organization.
+Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * This type defines all possible response structures for the GET OrganizationsIpRestrictions endpoint.
@@ -4797,7 +4855,10 @@ export type GET_OrganizationsIpRestrictions_Response_200 = IpRestrictionArray
  * Response types for POST OrganizationsIpRestrictions endpoint
  *
  * Create Ip Restriction
- * Create a new IP restriction for the organization
+ * Create a new IP restriction for the organization.
+
+Accepts either a single IP address or a CIDR network range.
+Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * This type defines all possible response structures for the POST OrganizationsIpRestrictions endpoint.
@@ -4853,7 +4914,9 @@ export type POST_OrganizationsIpRestrictions_Response_422 = HTTPValidationError
  * Response types for DELETE OrganizationsIpRestrictionsByIpRestrictionId endpoint
  *
  * Delete Ip Restriction
- * Delete an IP restriction
+ * Delete an IP restriction.
+
+Permanently removes the specified IP restriction from your organization.
  *
  * @remarks
  * This type defines all possible response structures for the DELETE OrganizationsIpRestrictionsByIpRestrictionId endpoint.
@@ -4891,7 +4954,10 @@ export type DELETE_OrganizationsIpRestrictionsByIpRestrictionId_Response_422 = H
  * Response types for GET OrganizationsIpRestrictionsByIpRestrictionId endpoint
  *
  * Get Ip Restriction
- * Get a specific IP restriction by ID
+ * Get a specific IP restriction by ID.
+
+Returns the details of a specific IP restriction if it exists and belongs to your organization.
+Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * This type defines all possible response structures for the GET OrganizationsIpRestrictionsByIpRestrictionId endpoint.
@@ -4947,7 +5013,10 @@ export type GET_OrganizationsIpRestrictionsByIpRestrictionId_Response_422 = HTTP
  * Response types for PATCH OrganizationsIpRestrictionsByIpRestrictionId endpoint
  *
  * Update Ip Restriction
- * Update an IP restriction
+ * Update an existing IP restriction.
+
+You can update the IP network range or the last usage timestamp.
+Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * This type defines all possible response structures for the PATCH OrganizationsIpRestrictionsByIpRestrictionId endpoint.

package/src/helpers/schemas.d.ts

@@ -1499,7 +1499,10 @@ export type HTTPValidationError = components['schemas']['HTTPValidationError'];
  */
 export type IdnBase = components['schemas']['IdnBase'];
 /**
- * IpRestrictionCreate
+ * IpRestrictionCreate. Create an IP restriction for an organization.
+
+Accepts either a single IP address or a CIDR network range.
+Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
  *
  * @remarks
  * Type alias for the `IpRestrictionCreate` OpenAPI schema.
@@ -1531,7 +1534,9 @@ export type IpRestrictionCreate = components['schemas']['IpRestrictionCreate'];
  */
 export type IpRestriction = components['schemas']['IpRestrictionResponse'];
 /**
- * IpRestrictionUpdate
+ * IpRestrictionUpdate. Update an existing IP restriction.
+
+You can update the IP network range or the last usage timestamp.
  *
  * @remarks
  * Type alias for the `IpRestrictionUpdate` OpenAPI schema.
@@ -2234,6 +2239,38 @@ export type PermissionSet = components['schemas']['PermissionSet'];
  * @see {@link components} - The OpenAPI components schema definition
  */
 export type PlanInfo = components['schemas']['PlanInfo'];
+/**
+ * PlanRelation
+ *
+ * @remarks
+ * Type alias for the `PlanRelation` OpenAPI schema.
+ * This type represents planrelation data structures used in API requests and responses.
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getPlanRelation();
+ * const item: PlanRelation = response.results;
+ * ```
+ *
+ * @see {@link components} - The OpenAPI components schema definition
+ */
+export type PlanRelation = components['schemas']['PlanRelation'];
+/**
+ * PlanUpdate
+ *
+ * @remarks
+ * Type alias for the `PlanUpdate` OpenAPI schema.
+ * This type represents planupdate data structures used in API requests and responses.
+ *
+ * @example
+ * ```typescript
+ * const response = await api.getPlanUpdate();
+ * const item: PlanUpdate = response.results;
+ * ```
+ *
+ * @see {@link components} - The OpenAPI components schema definition
+ */
+export type PlanUpdate = components['schemas']['PlanUpdate'];
 /**
  * PostTransferRequirements
  *

package/src/openapi.yaml

@@ -2352,11 +2352,22 @@ components:
       title: IdnBase
       type: object
     IpRestrictionCreate:
+      description: 'Create an IP restriction for an organization.
+
+
+        Accepts either a single IP address or a CIDR network range.
+
+        Individual IP addresses are stored and returned with CIDR notation (/32 for
+        IPv4, /128 for IPv6).'
       properties:
         ip_network:
-          description: IP address or CIDR range for the restriction.
+          description: IP address or CIDR network range. Individual IPs can be specified
+            without CIDR notation.
           examples:
+          - 192.0.2.1
           - 192.0.2.0/24
+          - 2001:db8::1
+          - 2001:db8::/32
           format: ipvanynetwork
           title: Ip Network
           type: string
@@ -2379,9 +2390,13 @@ components:
           title: Created On
           type: string
         ip_network:
-          description: IP address or CIDR range for the restriction.
+          description: IP address or CIDR network range. Single IPs are returned with
+            /32 (IPv4) or /128 (IPv6) notation.
           examples:
+          - 192.0.2.1/32
           - 192.0.2.0/24
+          - 2001:db8::1/128
+          - 2001:db8::/32
           format: ipvanynetwork
           title: Ip Network
           type: string
@@ -2410,15 +2425,22 @@ components:
       title: IpRestrictionResponse
       type: object
     IpRestrictionUpdate:
+      description: 'Update an existing IP restriction.
+
+
+        You can update the IP network range or the last usage timestamp.'
       properties:
         ip_network:
           anyOf:
           - format: ipvanynetwork
             type: string
           - type: 'null'
-          description: IP address or CIDR range for the restriction.
+          description: IP address or CIDR network range to replace the existing restriction.
           examples:
+          - 192.0.2.1
           - 192.0.2.0/24
+          - 2001:db8::1
+          - 2001:db8::/32
           title: Ip Network
         last_used_on:
           anyOf:
@@ -3858,6 +3880,22 @@ components:
       - amount
       title: PlanInfo
       type: object
+    PlanRelation:
+      enum:
+      - basic
+      - enterprise
+      - corporate
+      - premium
+      - starter
+      title: PlanRelation
+      type: string
+    PlanUpdate:
+      properties:
+        plan:
+          $ref: '#/components/schemas/PlanRelation'
+          default: basic
+      title: PlanUpdate
+      type: object
     PostTransferRequirements:
       enum:
       - update_contacts
@@ -5335,7 +5373,7 @@ info:
     '
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2025-09-18-131050
+  version: 2025-09-18-175712
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -8879,7 +8917,13 @@ paths:
       - organization
   /v1/organizations/ip-restrictions:
     get:
-      description: Get all IP restrictions for the organization
+      description: 'List all IP restrictions for the organization.
+
+
+        Returns a list of all IP restrictions configured for your organization.
+
+        Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for
+        IPv6).'
       operationId: list_ip_restrictions_v1_organizations_ip_restrictions_get
       responses:
         '200':
@@ -8898,7 +8942,13 @@ paths:
       tags:
       - organization
     post:
-      description: Create a new IP restriction for the organization
+      description: 'Create a new IP restriction for the organization.
+
+
+        Accepts either a single IP address or a CIDR network range.
+
+        Individual IP addresses are stored and returned with CIDR notation (/32 for
+        IPv4, /128 for IPv6).'
       operationId: create_ip_restriction_v1_organizations_ip_restrictions_post
       requestBody:
         content:
@@ -8926,7 +8976,10 @@ paths:
       - organization
   /v1/organizations/ip-restrictions/{ip_restriction_id}:
     delete:
-      description: Delete an IP restriction
+      description: 'Delete an IP restriction.
+
+
+        Permanently removes the specified IP restriction from your organization.'
       operationId: delete_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__delete
       parameters:
       - in: path
@@ -8950,7 +9003,14 @@ paths:
       tags:
       - organization
     get:
-      description: Get a specific IP restriction by ID
+      description: 'Get a specific IP restriction by ID.
+
+
+        Returns the details of a specific IP restriction if it exists and belongs
+        to your organization.
+
+        Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for
+        IPv6).'
       operationId: get_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__get
       parameters:
       - in: path
@@ -8978,7 +9038,13 @@ paths:
       tags:
       - organization
     patch:
-      description: Update an IP restriction
+      description: 'Update an existing IP restriction.
+
+
+        You can update the IP network range or the last usage timestamp.
+
+        Individual IP addresses are stored and returned with CIDR notation (/32 for
+        IPv4, /128 for IPv6).'
       operationId: update_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__patch
       parameters:
       - in: path
@@ -9163,6 +9229,45 @@ paths:
       summary: Update Organization
       tags:
       - organization
+  /v1/organizations/{organization_id}/plan:
+    patch:
+      operationId: change_plan_v1_organizations__organization_id__plan_patch
+      parameters:
+      - in: path
+        name: organization_id
+        required: true
+        schema:
+          examples:
+          - organization_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^organization_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Organization Id
+          type: string
+          x-typeid-prefix: organization
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PlanUpdate'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OrganizationWithBillingData'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Change Plan
+      tags:
+      - organization
   /v1/organizations/{organization_id}/plans:
     get:
       operationId: get_current_available_plans_v1_organizations__organization_id__plans_get

package/src/schema.d.ts

@@ -861,13 +861,19 @@ export interface paths {
         };
         /**
          * List Ip Restrictions
-         * @description Get all IP restrictions for the organization
+         * @description List all IP restrictions for the organization.
+         *
+         *     Returns a list of all IP restrictions configured for your organization.
+         *     Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
          */
         get: operations["list_ip_restrictions_v1_organizations_ip_restrictions_get"];
         put?: never;
         /**
          * Create Ip Restriction
-         * @description Create a new IP restriction for the organization
+         * @description Create a new IP restriction for the organization.
+         *
+         *     Accepts either a single IP address or a CIDR network range.
+         *     Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
          */
         post: operations["create_ip_restriction_v1_organizations_ip_restrictions_post"];
         delete?: never;
@@ -885,21 +891,29 @@ export interface paths {
         };
         /**
          * Get Ip Restriction
-         * @description Get a specific IP restriction by ID
+         * @description Get a specific IP restriction by ID.
+         *
+         *     Returns the details of a specific IP restriction if it exists and belongs to your organization.
+         *     Single IP addresses are returned with CIDR notation (/32 for IPv4, /128 for IPv6).
          */
         get: operations["get_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__get"];
         put?: never;
         post?: never;
         /**
          * Delete Ip Restriction
-         * @description Delete an IP restriction
+         * @description Delete an IP restriction.
+         *
+         *     Permanently removes the specified IP restriction from your organization.
          */
         delete: operations["delete_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__delete"];
         options?: never;
         head?: never;
         /**
          * Update Ip Restriction
-         * @description Update an IP restriction
+         * @description Update an existing IP restriction.
+         *
+         *     You can update the IP network range or the last usage timestamp.
+         *     Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
          */
         patch: operations["update_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__patch"];
         trace?: never;
@@ -957,6 +971,23 @@ export interface paths {
         patch: operations["update_organization_v1_organizations__organization_id__patch"];
         trace?: never;
     };
+    "/v1/organizations/{organization_id}/plan": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Change Plan */
+        patch: operations["change_plan_v1_organizations__organization_id__plan_patch"];
+        trace?: never;
+    };
     "/v1/organizations/{organization_id}/plans": {
         parameters: {
             query?: never;
@@ -2749,12 +2780,18 @@ export interface components {
              */
             idn_tables?: string[] | null;
         };
-        /** IpRestrictionCreate */
+        /**
+         * IpRestrictionCreate
+         * @description Create an IP restriction for an organization.
+         *
+         *     Accepts either a single IP address or a CIDR network range.
+         *     Individual IP addresses are stored and returned with CIDR notation (/32 for IPv4, /128 for IPv6).
+         */
         IpRestrictionCreate: {
             /**
              * Ip Network
              * Format: ipvanynetwork
-             * @description IP address or CIDR range for the restriction.
+             * @description IP address or CIDR network range. Individual IPs can be specified without CIDR notation.
              */
             ip_network: string;
             /**
@@ -2773,7 +2810,7 @@ export interface components {
             /**
              * Ip Network
              * Format: ipvanynetwork
-             * @description IP address or CIDR range for the restriction.
+             * @description IP address or CIDR network range. Single IPs are returned with /32 (IPv4) or /128 (IPv6) notation.
              */
             ip_network: string;
             /** Ip Restriction Id */
@@ -2786,11 +2823,16 @@ export interface components {
              */
             organization_id: TypeId<"organization">;
         };
-        /** IpRestrictionUpdate */
+        /**
+         * IpRestrictionUpdate
+         * @description Update an existing IP restriction.
+         *
+         *     You can update the IP network range or the last usage timestamp.
+         */
         IpRestrictionUpdate: {
             /**
              * Ip Network
-             * @description IP address or CIDR range for the restriction.
+             * @description IP address or CIDR network range to replace the existing restriction.
              */
             ip_network?: string | null;
             /**
@@ -3776,6 +3818,16 @@ export interface components {
              */
             plan_type?: string | null;
         };
+        /**
+         * PlanRelation
+         * @enum {string}
+         */
+        PlanRelation: "basic" | "enterprise" | "corporate" | "premium" | "starter";
+        /** PlanUpdate */
+        PlanUpdate: {
+            /** @default basic */
+            plan: components["schemas"]["PlanRelation"];
+        };
         /**
          * PostTransferRequirements
          * @enum {string}
@@ -8262,6 +8314,41 @@ export interface operations {
             };
         };
     };
+    change_plan_v1_organizations__organization_id__plan_patch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                organization_id: TypeId<"organization">;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PlanUpdate"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrganizationWithBillingData"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     get_current_available_plans_v1_organizations__organization_id__plans_get: {
         parameters: {
             query?: never;