@opusdns/api 0.118.0 → 0.120.0

package/package.json

@@ -3,7 +3,7 @@
     "@opusdns/api-spec-ts-generator": "^0.9.1"
   },
   "name": "@opusdns/api",
-  "version": "0.118.0",
+  "version": "0.120.0",
   "description": "TypeScript types for the OpusDNS OpenAPI specification",
   "main": "./src/index.ts",
   "module": "./src/index.ts",

package/src/helpers/requests.d.ts

@@ -1669,7 +1669,7 @@ export type PATCH_DomainForwardsHostnameDisable_Request_Path = PATCH_DomainForwa
  * Request type for PATCH DomainForwardsHostnameEnable endpoint
  *
  * Enable domain forward
- * Enables domain forwarding by creating necessary DNS records. Optionally auto-creates the zone and domain forward if they don't exist.
+ * Enables domain forwarding by creating necessary DNS records
  *
  * @remarks
  * This type defines the complete request structure for the PATCH DomainForwardsHostnameEnable endpoint.

package/src/helpers/responses.d.ts

@@ -3435,7 +3435,7 @@ export type PATCH_DomainForwardsByHostnameDisable_Response_422 = HTTPValidationE
  * Response types for PATCH DomainForwardsByHostnameEnable endpoint
  *
  * Enable domain forward
- * Enables domain forwarding by creating necessary DNS records. Optionally auto-creates the zone and domain forward if they don't exist.
+ * Enables domain forwarding by creating necessary DNS records
  *
  * @remarks
  * This type defines all possible response structures for the PATCH DomainForwardsByHostnameEnable endpoint.

package/src/openapi.yaml

@@ -5922,7 +5922,7 @@ info:
     '
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2025-12-09-194737
+  version: 2025-12-10-084326
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -9162,8 +9162,7 @@ paths:
       - domain_forward
   /v1/domain-forwards/{hostname}/enable:
     patch:
-      description: Enables domain forwarding by creating necessary DNS records. Optionally
-        auto-creates the zone and domain forward if they don't exist.
+      description: Enables domain forwarding by creating necessary DNS records
       operationId: enable_domain_forward_v1_domain_forwards__hostname__enable_patch
       parameters:
       - description: Hostname
@@ -13488,8 +13487,78 @@ tags:
     '
   name: availability
   x-displayName: Availability
-- description: 'Endpoints for submitting and tracking batch command execution (internal
-    preview).
+- description: 'Endpoints for submitting and tracking batch command execution.
+
+
+    The Jobs API enables asynchronous execution of bulk operations through batches.
+    Submit multiple commands in a single request and poll for completion status.
+
+
+    ## Supported Commands
+
+
+    | Command | Description |
+
+    |---------|-------------|
+
+    | `domain_create` | Register a new domain |
+
+    | `domain_update` | Modify domain settings (contacts, nameservers, renewal mode)
+    |
+
+    | `domain_transfer` | Initiate an inbound domain transfer |
+
+    | `dns_zone_create` | Create a new DNS zone with optional records |
+
+
+    ## Batch Lifecycle
+
+
+    Each job within a batch transitions through states:
+
+
+    1. **queued** - Awaiting processing
+
+    2. **running** - Currently being executed
+
+    3. **succeeded** - Completed successfully
+
+    4. **failed** - Execution failed (check `error_class` and `error_message`)
+
+    5. **canceled** - Job was canceled before completion
+
+    6. **dead_letter** - Permanently failed after exhausting retries
+
+
+    ## Usage Pattern
+
+
+    1. **Submit a batch** - `POST /v1/jobs` with an array of commands
+
+    2. **Poll for status** - `GET /v1/jobs/{batch_id}` to check progress
+
+    3. **Review results** - `GET /v1/jobs/{batch_id}/jobs` to see individual job outcomes
+
+
+    ## Limits
+
+
+    - Maximum **50,000 commands** per batch
+
+
+    ## Scheduling
+
+
+    Use `not_before` to schedule batch execution for a future time (UTC timestamp).
+    If not provided, processing begins immediately.
+
+
+    ## Idempotency
+
+
+    Each command can include an optional `idempotency_key` to prevent duplicate execution.
+    If a command with the same idempotency key has already been processed, it will
+    be skipped.
 
     '
   name: jobs
@@ -13578,3 +13647,4 @@ x-tagGroups:
   - rdap
   - domain_search
   - archive
+  - jobs

package/src/schema.d.ts

@@ -549,7 +549,7 @@ export interface paths {
         head?: never;
         /**
          * Enable domain forward
-         * @description Enables domain forwarding by creating necessary DNS records. Optionally auto-creates the zone and domain forward if they don't exist.
+         * @description Enables domain forwarding by creating necessary DNS records
          */
         patch: operations["enable_domain_forward_v1_domain_forwards__hostname__enable_patch"];
         trace?: never;