@opusdns/api 1.97.0 → 1.99.0

package/package.json

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

package/src/openapi.yaml

@@ -14990,7 +14990,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-08-04-122306
+  version: 2026-08-04-151228
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -19706,6 +19706,22 @@ paths:
         content:
           application/json:
             examples:
+              delegate_subdomain:
+                description: Add an NS RRset below the zone apex to delegate a subdomain
+                  to other nameservers (sub-zone delegation). The zone answers queries
+                  for the subtree with a referral. NS records at the apex are system-managed
+                  and cannot be changed here.
+                summary: Delegate a subdomain
+                value:
+                  ops:
+                  - op: upsert
+                    rrset:
+                      name: internal
+                      records:
+                      - rdata: ns1.other-provider.net.
+                      - rdata: ns2.other-provider.net.
+                      ttl: 3600
+                      type: NS
               remove_single_rrset:
                 description: Remove all records for a specific name and type
                 summary: Remove a single RRset
@@ -32147,24 +32163,29 @@ tags:
     \ DNSKEY, DS, and the NS rrset at the zone apex are system-managed by OpusDNS:\
     \ a payload rrset or patch op targeting one \u2014 upsert **or** remove \u2014\
     \ is rejected with a `409` protected-rrset error (these rrsets are reported with\
-    \ `\"protected\": true` in zone responses). NS records below the apex (sub-zone\
-    \ delegation) are not supported and are rejected with a `400` validation error.\
-    \ To change the nameservers a domain delegates to, update the nameservers on the\
-    \ domain instead.\n\n### `PUT /v1/dns/{zone_name}/rrsets` \u2014 Replace all rrsets\n\
-    \nSupply the complete set of rrsets the zone should contain. Any existing user-managed\
-    \ rrset **not** in the request is removed. System-managed rrsets cannot be set\
-    \ or removed via this endpoint; omit them from the payload.\n\nUse this when you\
-    \ have authoritative, end-state data for a zone and want to reset it to that state.\n\
-    \n### `PATCH /v1/dns/{zone_name}/rrsets` \u2014 Upsert or remove whole rrsets\n\
-    \nSubmit an `ops[]` array where each op targets an rrset by `(name, type)`:\n\n\
-    - `op: \"upsert\"` \u2014 create or **replace** the rrset at `(name, type)` with\
-    \ the records you provide. Any records that previously existed at that `(name,\
-    \ type)` are discarded.\n- `op: \"remove\"` \u2014 delete the entire rrset at\
-    \ `(name, type)` (pass `records: []`).\n\n```json\n{\n  \"ops\": [\n    {\n  \
-    \    \"op\": \"upsert\",\n      \"rrset\": {\n        \"name\": \"www\",\n   \
-    \     \"type\": \"A\",\n        \"ttl\": 300,\n        \"records\": [\n      \
-    \    {\"rdata\": \"203.0.113.10\"},\n          {\"rdata\": \"203.0.113.11\"}\n\
-    \        ]\n      }\n    },\n    {\n      \"op\": \"remove\",\n      \"rrset\"\
+    \ `\"protected\": true` in zone responses). To change the nameservers a domain\
+    \ delegates to, update the nameservers on the domain instead.\n\nNS rrsets **below**\
+    \ the apex delegate a subdomain to other nameservers and are managed like any\
+    \ other record type, on all three endpoints and at zone creation. Two caveats:\
+    \ records (including domain/email forwards and parking) at or below a delegated\
+    \ name stop resolving publicly, because the delegated nameservers are authoritative\
+    \ for that subtree; and delegations from DNSSEC-signed zones are *insecure* delegations\
+    \ \u2014 child DS records are not supported, so the delegated subtree is not covered\
+    \ by the parent's chain of trust.\n\n### `PUT /v1/dns/{zone_name}/rrsets` \u2014\
+    \ Replace all rrsets\n\nSupply the complete set of rrsets the zone should contain.\
+    \ Any existing user-managed rrset **not** in the request is removed. System-managed\
+    \ rrsets cannot be set or removed via this endpoint; omit them from the payload.\n\
+    \nUse this when you have authoritative, end-state data for a zone and want to\
+    \ reset it to that state.\n\n### `PATCH /v1/dns/{zone_name}/rrsets` \u2014 Upsert\
+    \ or remove whole rrsets\n\nSubmit an `ops[]` array where each op targets an rrset\
+    \ by `(name, type)`:\n\n- `op: \"upsert\"` \u2014 create or **replace** the rrset\
+    \ at `(name, type)` with the records you provide. Any records that previously\
+    \ existed at that `(name, type)` are discarded.\n- `op: \"remove\"` \u2014 delete\
+    \ the entire rrset at `(name, type)` (pass `records: []`).\n\n```json\n{\n  \"\
+    ops\": [\n    {\n      \"op\": \"upsert\",\n      \"rrset\": {\n        \"name\"\
+    : \"www\",\n        \"type\": \"A\",\n        \"ttl\": 300,\n        \"records\"\
+    : [\n          {\"rdata\": \"203.0.113.10\"},\n          {\"rdata\": \"203.0.113.11\"\
+    }\n        ]\n      }\n    },\n    {\n      \"op\": \"remove\",\n      \"rrset\"\
     : {\"name\": \"old\", \"type\": \"CNAME\", \"ttl\": 300, \"records\": []}\n  \
     \  }\n  ]\n}\n```\n\nUse this when you want to define the complete set of records\
     \ for a given `(name, type)` \u2014 e.g., \"`www` should have exactly these two\