@opusdns/api 0.258.0 → 0.260.0

package/src/openapi.yaml

@@ -259,6 +259,70 @@ components:
       - unique
       title: BrowserStatsBucket
       type: object
+    BulkObjectTagChanges:
+      properties:
+        add:
+          description: Tag IDs to add to the objects.
+          items:
+            examples:
+            - tag_01h45ytscbebyvny4gc8cr8ma2
+            format: typeid
+            pattern: ^tag_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+            type: string
+            x-typeid-prefix: tag
+          maxItems: 1000
+          title: Add
+          type: array
+        objects:
+          description: Object references to operate on. TypeIDs and resource names
+            may be mixed.
+          items:
+            description: A TypeID (e.g. domain_01h45ytscbebyvny4gc8cr8ma2) or a resource
+              name (e.g. example.com)
+            examples:
+            - domain_01h45ytscbebyvny4gc8cr8ma2
+            - example.com
+            type: string
+          maxItems: 1000
+          minItems: 1
+          title: Objects
+          type: array
+        remove:
+          description: Tag IDs to remove from the objects.
+          items:
+            examples:
+            - tag_01h45ytscbebyvny4gc8cr8ma2
+            format: typeid
+            pattern: ^tag_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+            type: string
+            x-typeid-prefix: tag
+          maxItems: 1000
+          title: Remove
+          type: array
+        replace:
+          anyOf:
+          - items:
+              examples:
+              - tag_01h45ytscbebyvny4gc8cr8ma2
+              format: typeid
+              pattern: ^tag_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+              type: string
+              x-typeid-prefix: tag
+            maxItems: 1000
+            type: array
+          - type: 'null'
+          description: Tag IDs to set as the complete tag set for the objects, replacing
+            any existing tags. Mutually exclusive with 'add' and 'remove'. An empty
+            list removes all tags.
+          title: Replace
+        type:
+          $ref: '#/components/schemas/TagType'
+          description: The object/tag type (e.g. DOMAIN, CONTACT, ZONE)
+      required:
+      - type
+      - objects
+      title: BulkObjectTagChanges
+      type: object
     CommandError:
       properties:
         error:
@@ -6329,6 +6393,57 @@ components:
       - performed_by_id
       title: ObjectLogSortField
       type: string
+    ObjectTagChanges:
+      properties:
+        add:
+          description: Object TypeIDs or resource names to tag. TypeIDs and names
+            may be mixed.
+          items:
+            description: A TypeID (e.g. domain_01h45ytscbebyvny4gc8cr8ma2) or a resource
+              name (e.g. example.com)
+            examples:
+            - domain_01h45ytscbebyvny4gc8cr8ma2
+            - example.com
+            type: string
+          maxItems: 1000
+          title: Add
+          type: array
+        remove:
+          description: Object TypeIDs or resource names to untag. TypeIDs and names
+            may be mixed.
+          items:
+            description: A TypeID (e.g. domain_01h45ytscbebyvny4gc8cr8ma2) or a resource
+              name (e.g. example.com)
+            examples:
+            - domain_01h45ytscbebyvny4gc8cr8ma2
+            - example.com
+            type: string
+          maxItems: 1000
+          title: Remove
+          type: array
+      title: ObjectTagChanges
+      type: object
+    ObjectTagChangesResponse:
+      properties:
+        added:
+          description: Number of objects tagged
+          title: Added
+          type: integer
+        removed:
+          description: Number of objects untagged
+          title: Removed
+          type: integer
+        unresolved:
+          description: References that could not be resolved
+          items:
+            type: string
+          title: Unresolved
+          type: array
+      required:
+      - added
+      - removed
+      title: ObjectTagChangesResponse
+      type: object
     Organization:
       properties:
         address_1:
@@ -7309,6 +7424,20 @@ components:
       - pagination
       title: Pagination[RequestHistory]
       type: object
+    Pagination_TagResponse_:
+      properties:
+        pagination:
+          $ref: '#/components/schemas/PaginationMetadata'
+        results:
+          items:
+            $ref: '#/components/schemas/TagResponse'
+          title: Results
+          type: array
+      required:
+      - results
+      - pagination
+      title: Pagination[TagResponse]
+      type: object
     Pagination_UserPublic_:
       properties:
         pagination:
@@ -8673,12 +8802,132 @@ components:
       - color-10
       title: TagColor
       type: string
+    TagCreate:
+      properties:
+        color:
+          anyOf:
+          - $ref: '#/components/schemas/TagColor'
+          - type: 'null'
+          default: color-1
+          description: The color of the tag
+        description:
+          anyOf:
+          - maxLength: 1024
+            type: string
+          - type: 'null'
+          description: Optional description of the tag
+          title: Description
+        label:
+          description: A human-readable label for the tag
+          maxLength: 50
+          minLength: 1
+          title: Label
+          type: string
+        type:
+          $ref: '#/components/schemas/TagType'
+          description: Which category a tag applies to, cannot be changed once created
+      required:
+      - label
+      - type
+      title: TagCreate
+      type: object
     TagFilterMode:
       enum:
       - match_any
       - match_all
       title: TagFilterMode
       type: string
+    TagResponse:
+      properties:
+        color:
+          $ref: '#/components/schemas/TagColor'
+          description: The color of the tag
+        created_on:
+          description: The date/time the tag was created on
+          format: date-time
+          title: Created On
+          type: string
+        description:
+          anyOf:
+          - maxLength: 1024
+            type: string
+          - type: 'null'
+          description: Optional description of the tag
+          title: Description
+        label:
+          description: The label of the tag
+          minLength: 1
+          title: Label
+          type: string
+        object_count:
+          default: 0
+          description: Number of objects tagged with this tag
+          title: Object Count
+          type: integer
+        tag_id:
+          description: The unique identifier of the tag
+          examples:
+          - tag_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^tag_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Tag Id
+          type: string
+          x-typeid-prefix: tag
+        type:
+          $ref: '#/components/schemas/TagType'
+          description: Which category a tag applies to, cannot be changed once created
+        updated_on:
+          description: The date/time the tag was last updated on
+          format: date-time
+          title: Updated On
+          type: string
+      required:
+      - tag_id
+      - label
+      - type
+      - color
+      - created_on
+      - updated_on
+      title: TagResponse
+      type: object
+    TagSortField:
+      enum:
+      - label
+      - created_on
+      - updated_on
+      title: TagSortField
+      type: string
+    TagType:
+      enum:
+      - DOMAIN
+      - CONTACT
+      - ZONE
+      title: TagType
+      type: string
+    TagUpdate:
+      properties:
+        color:
+          anyOf:
+          - $ref: '#/components/schemas/TagColor'
+          - type: 'null'
+          description: The color of the tag
+        description:
+          anyOf:
+          - maxLength: 1024
+            type: string
+          - type: 'null'
+          description: Optional description of the tag
+          title: Description
+        label:
+          anyOf:
+          - maxLength: 50
+            minLength: 1
+            type: string
+          - type: 'null'
+          description: A human-readable label for the tag
+          title: Label
+      title: TagUpdate
+      type: object
     TimeRange:
       enum:
       - 1h
@@ -9869,7 +10118,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-04-21-115243
+  version: 2026-04-21-172930
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -21111,40 +21360,79 @@ paths:
       summary: Download Report
       tags:
       - report
-  /v1/tlds/:
+  /v1/tags:
     get:
-      description: Retrieves a list of TLD Specifications we have support for
-      operationId: get_tld_specifications_v1_tlds__get
+      description: Retrieves a paginated list of tags
+      operationId: list_tags_v1_tags_get
       parameters:
       - in: query
-        name: fields
+        name: sort_by
+        required: false
+        schema:
+          $ref: '#/components/schemas/TagSortField'
+          default: label
+      - in: query
+        name: sort_order
+        required: false
+        schema:
+          $ref: '#/components/schemas/SortOrder'
+          default: asc
+      - description: Filter by tag types (OR semantics)
+        in: query
+        name: tag_types
         required: false
         schema:
           anyOf:
-          - type: string
+          - items:
+              $ref: '#/components/schemas/TagType'
+            type: array
           - type: 'null'
-          title: Fields
+          description: Filter by tag types (OR semantics)
+          title: Tag Types
       - in: query
-        name: tlds
+        name: search
         required: false
         schema:
           anyOf:
           - type: string
           - type: 'null'
-          title: Tlds
+          title: Search
+      - in: query
+        name: page
+        required: false
+        schema:
+          default: 1
+          minimum: 1
+          title: Page
+          type: integer
+      - in: query
+        name: page_size
+        required: false
+        schema:
+          default: 10
+          maximum: 1000
+          minimum: 1
+          title: Page Size
+          type: integer
       responses:
         '200':
           content:
             application/json:
               schema:
-                additionalProperties:
-                  items:
-                    additionalProperties: true
-                    type: object
-                  type: array
-                title: Response Get Tld Specifications V1 Tlds  Get
-                type: object
+                $ref: '#/components/schemas/Pagination_TagResponse_'
           description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
         '422':
           content:
             application/problem+json:
@@ -21154,22 +21442,449 @@ paths:
       security:
       - OAuth2PasswordBearer: []
       - APIKeyHeader: []
-      summary: Get list of Specifications for all TLDs we support
+      summary: List tags
       tags:
-      - tld
-  /v1/tlds/portfolio:
-    get:
-      description: Retrieves a list of TLDs we have support for
-      operationId: get_tld_portfolio_v1_tlds_portfolio_get
+      - tag
+    post:
+      description: Create a new tag
+      operationId: create_tag_v1_tags_post
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TagCreate'
+        required: true
       responses:
-        '200':
+        '201':
           content:
             application/json:
               schema:
-                items:
-                  $ref: '#/components/schemas/TldResponseShort'
-                title: Response Get Tld Portfolio V1 Tlds Portfolio Get
-                type: array
+                $ref: '#/components/schemas/TagResponse'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '409':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_TAG_LABEL_ALREADY_EXISTS
+                detail: A tag with label 'Additional error context.' already exists
+                label: Additional error context.
+                status: 409
+                title: Tag Management Error
+                type: tag-label-already-exists
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Conflict
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Create a tag
+      tags:
+      - tag
+  /v1/tags/objects:
+    post:
+      description: Add, remove, or replace tags on multiple objects at once. 'replace'
+        is mutually exclusive with 'add' and 'remove'.
+      operationId: bulk_update_object_tags_v1_tags_objects_post
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/BulkObjectTagChanges'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ObjectTagChangesResponse'
+          description: Successful Response
+        '400':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_ILLEGAL_OBJECT_TYPE_FOR_TAG
+                detail: One or more provided object ids are not valid for this tag
+                object_ids: Additional error context.
+                status: 400
+                title: Tag Management Error
+                type: illegal-object-type-tag
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Bad Request
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_TAG_NOT_FOUND
+                detail: Tag not found
+                status: 404
+                tag_id: Additional error context.
+                title: Tag Management Error
+                type: tag-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Bulk tag or untag objects
+      tags:
+      - tag
+  /v1/tags/{tag_id}:
+    delete:
+      description: Delete a tag
+      operationId: delete_tag_v1_tags__tag_id__delete
+      parameters:
+      - in: path
+        name: tag_id
+        required: true
+        schema:
+          examples:
+          - tag_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^tag_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Tag Id
+          type: string
+          x-typeid-prefix: tag
+      responses:
+        '204':
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_TAG_NOT_FOUND
+                detail: Tag not found
+                status: 404
+                tag_id: Additional error context.
+                title: Tag Management Error
+                type: tag-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Delete a tag
+      tags:
+      - tag
+    get:
+      description: Retrieve a single tag by its ID
+      operationId: get_tag_v1_tags__tag_id__get
+      parameters:
+      - in: path
+        name: tag_id
+        required: true
+        schema:
+          examples:
+          - tag_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^tag_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Tag Id
+          type: string
+          x-typeid-prefix: tag
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TagResponse'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_TAG_NOT_FOUND
+                detail: Tag not found
+                status: 404
+                tag_id: Additional error context.
+                title: Tag Management Error
+                type: tag-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Get a tag
+      tags:
+      - tag
+    patch:
+      description: Update a tag's label, description, or color
+      operationId: update_tag_v1_tags__tag_id__patch
+      parameters:
+      - in: path
+        name: tag_id
+        required: true
+        schema:
+          examples:
+          - tag_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^tag_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Tag Id
+          type: string
+          x-typeid-prefix: tag
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TagUpdate'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TagResponse'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_TAG_NOT_FOUND
+                detail: Tag not found
+                status: 404
+                tag_id: Additional error context.
+                title: Tag Management Error
+                type: tag-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '409':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_TAG_LABEL_ALREADY_EXISTS
+                detail: A tag with label 'Additional error context.' already exists
+                label: Additional error context.
+                status: 409
+                title: Tag Management Error
+                type: tag-label-already-exists
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Conflict
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Update a tag
+      tags:
+      - tag
+  /v1/tags/{tag_id}/objects:
+    post:
+      description: Add or remove objects from a tag. Objects are matched by the tag's
+        type (e.g. a DOMAIN tag only accepts domain IDs).
+      operationId: update_tag_objects_v1_tags__tag_id__objects_post
+      parameters:
+      - in: path
+        name: tag_id
+        required: true
+        schema:
+          examples:
+          - tag_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^tag_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Tag Id
+          type: string
+          x-typeid-prefix: tag
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ObjectTagChanges'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ObjectTagChangesResponse'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_TAG_NOT_FOUND
+                detail: Tag not found
+                status: 404
+                tag_id: Additional error context.
+                title: Tag Management Error
+                type: tag-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Tag or untag objects
+      tags:
+      - tag
+  /v1/tlds/:
+    get:
+      description: Retrieves a list of TLD Specifications we have support for
+      operationId: get_tld_specifications_v1_tlds__get
+      parameters:
+      - in: query
+        name: fields
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Fields
+      - in: query
+        name: tlds
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Tlds
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                additionalProperties:
+                  items:
+                    additionalProperties: true
+                    type: object
+                  type: array
+                title: Response Get Tld Specifications V1 Tlds  Get
+                type: object
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Get list of Specifications for all TLDs we support
+      tags:
+      - tld
+  /v1/tlds/portfolio:
+    get:
+      description: Retrieves a list of TLDs we have support for
+      operationId: get_tld_portfolio_v1_tlds_portfolio_get
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                items:
+                  $ref: '#/components/schemas/TldResponseShort'
+                title: Response Get Tld Portfolio V1 Tlds Portfolio Get
+                type: array
           description: Successful Response
         '422':
           content:
@@ -21606,58 +22321,112 @@ tags:
     \ Register multiple domains |\n| `domain_update_bulk` | Update multiple domains\
     \ (statuses, nameservers, contacts, renewal mode) |\n| `domain_transfer_bulk`\
     \ | Transfer multiple domains |\n| `dns_zone_create_bulk` | Create multiple DNS\
-    \ zones |\n| `dns_zone_update_bulk` | Update multiple DNS zones |\n| `dns_zone_patch_rrsets_bulk`\
-    \ | Patch DNS record sets across zones |\n| `dns_zone_patch_records_bulk` | Patch\
-    \ individual DNS records across zones |\n| `contact_create_bulk` | Create multiple\
-    \ contacts |\n| `parking_create_bulk` | Create parking pages for multiple domains\
-    \ |\n| `parking_enable_bulk` | Enable parking on multiple domains |\n| `parking_disable_bulk`\
-    \ | Disable parking on multiple domains |\n| `parking_delete_bulk` | Delete parking\
-    \ pages for multiple domains |\n\n### Batch Lifecycle\n\nEach job within a batch\
-    \ transitions through states:\n\n1. **blocked** \u2014 Waiting for eligibility\
-    \ (scheduled via `not_before`, or awaiting capacity)\n2. **queued** \u2014 Eligible\
-    \ and awaiting processing\n3. **paused** \u2014 Paused; must be explicitly resumed\
-    \ to continue\n4. **running** \u2014 Currently being executed\n5. **succeeded**\
-    \ \u2014 Completed successfully\n6. **failed** \u2014 Execution failed (check\
-    \ `error_class` and `error_message`)\n7. **canceled** \u2014 Job was canceled\
-    \ before completion\n8. **dead_letter** \u2014 Permanently failed after exhausting\
-    \ retries\n\nA batch itself has a `status` field that is either `pending` (jobs\
-    \ are still in progress) or `complete` (all jobs have reached a terminal state).\n\
-    \n### Usage Pattern\n\n1. **Submit a batch** \u2014 `POST /v1/jobs` with an array\
-    \ of commands\n2. **Poll for status** \u2014 `GET /v1/jobs/{batch_id}` to check\
-    \ progress counts and `progress_percentage`\n3. **Review results** \u2014 `GET\
-    \ /v1/jobs/{batch_id}/jobs` to see individual job outcomes\n\n### Managing Batches\n\
-    \n- **Pause** \u2014 `POST /v1/jobs/{batch_id}/pause` pauses all eligible jobs\
-    \ in the batch\n- **Resume** \u2014 `POST /v1/jobs/{batch_id}/resume` resumes\
-    \ all paused jobs\n- **Cancel** \u2014 `DELETE /v1/jobs/{batch_id}` cancels all\
-    \ pending jobs in the batch\n\nIndividual jobs can also be paused, resumed, or\
-    \ canceled via the `/v1/job/{job_id}` endpoints.\n\n### Limits\n\n- Maximum **50,000\
-    \ commands** per batch\n- Bulk commands support up to **1,000 instances** per\
-    \ command\n\n### Scheduling\n\nUse `not_before` to schedule batch execution for\
-    \ a future time (UTC timestamp). If not provided, processing begins as soon as\
-    \ a worker is available.\n\n### Idempotency\n\nEach 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.\n\n### Domain\
-    \ Status Updates in Batches\n\nThe `domain_update` and `domain_update_bulk` commands\
-    \ support two mutually exclusive approaches for modifying domain statuses. These\
-    \ work the same way as the `PATCH /v1/domains/{domain_reference}` endpoint \u2014\
-    \ see the [Domain management](#tag/Domain-management) documentation for full details\
-    \ on `statuses` vs `status_changes`.\n\n#### Using `status_changes` in bulk templates\n\
-    \nThe `domain_update_bulk` command is particularly useful with `status_changes`\
-    \ when you need to apply the same relative status change across many domains.\
-    \ Set `status_changes` in the **template** and list the target domains as **instances**.\
-    \ Each instance identifies a domain by either `name` or `domain_id` (but not both):\n\
-    \n```json\n{\n  \"command\": \"domain_update_bulk\",\n  \"payload\": {\n    \"\
-    template\": {\n      \"status_changes\": {\n        \"add\": [\"clientTransferProhibited\"\
+    \ zones |\n| `dns_zone_update_bulk` | Replace rrsets (and zone attributes like\
+    \ DNSSEC) across multiple DNS zones |\n| `dns_zone_patch_rrsets_bulk` | Upsert\
+    \ or remove entire rrsets (by name + type) across multiple zones |\n| `dns_zone_patch_records_bulk`\
+    \ | Upsert or remove individual rdata values across multiple zones |\n| `contact_create_bulk`\
+    \ | Create multiple contacts |\n| `parking_create_bulk` | Create parking pages\
+    \ for multiple domains |\n| `parking_enable_bulk` | Enable parking on multiple\
+    \ domains |\n| `parking_disable_bulk` | Disable parking on multiple domains |\n\
+    | `parking_delete_bulk` | Delete parking pages for multiple domains |\n\n### Batch\
+    \ Lifecycle\n\nEach job within a batch transitions through states:\n\n1. **blocked**\
+    \ \u2014 Waiting for eligibility (scheduled via `not_before`, or awaiting capacity)\n\
+    2. **queued** \u2014 Eligible and awaiting processing\n3. **paused** \u2014 Paused;\
+    \ must be explicitly resumed to continue\n4. **running** \u2014 Currently being\
+    \ executed\n5. **succeeded** \u2014 Completed successfully\n6. **failed** \u2014\
+    \ Execution failed (check `error_class` and `error_message`)\n7. **canceled**\
+    \ \u2014 Job was canceled before completion\n8. **dead_letter** \u2014 Permanently\
+    \ failed after exhausting retries\n\nA batch itself has a `status` field that\
+    \ is either `pending` (jobs are still in progress) or `complete` (all jobs have\
+    \ reached a terminal state).\n\n### Usage Pattern\n\n1. **Submit a batch** \u2014\
+    \ `POST /v1/jobs` with an array of commands\n2. **Poll for status** \u2014 `GET\
+    \ /v1/jobs/{batch_id}` to check progress counts and `progress_percentage`\n3.\
+    \ **Review results** \u2014 `GET /v1/jobs/{batch_id}/jobs` to see individual job\
+    \ outcomes\n\n### Managing Batches\n\n- **Pause** \u2014 `POST /v1/jobs/{batch_id}/pause`\
+    \ pauses all eligible jobs in the batch\n- **Resume** \u2014 `POST /v1/jobs/{batch_id}/resume`\
+    \ resumes all paused jobs\n- **Cancel** \u2014 `DELETE /v1/jobs/{batch_id}` cancels\
+    \ all pending jobs in the batch\n\nIndividual jobs can also be paused, resumed,\
+    \ or canceled via the `/v1/job/{job_id}` endpoints.\n\n### Limits\n\n- Maximum\
+    \ **50,000 commands** per batch\n- Bulk commands support up to **1,000 instances**\
+    \ per command\n\n### Scheduling\n\nUse `not_before` to schedule batch execution\
+    \ for a future time (UTC timestamp). If not provided, processing begins as soon\
+    \ as a worker is available.\n\n### Idempotency\n\nEach 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.\n\n\
+    ### Domain Status Updates in Batches\n\nThe `domain_update` and `domain_update_bulk`\
+    \ commands support two mutually exclusive approaches for modifying domain statuses.\
+    \ These work the same way as the `PATCH /v1/domains/{domain_reference}` endpoint\
+    \ \u2014 see the [Domain management](#tag/Domain-management) documentation for\
+    \ full details on `statuses` vs `status_changes`.\n\n#### Using `status_changes`\
+    \ in bulk templates\n\nThe `domain_update_bulk` command is particularly useful\
+    \ with `status_changes` when you need to apply the same relative status change\
+    \ across many domains. Set `status_changes` in the **template** and list the target\
+    \ domains as **instances**. Each instance identifies a domain by either `name`\
+    \ or `domain_id` (but not both):\n\n```json\n{\n  \"command\": \"domain_update_bulk\"\
+    ,\n  \"payload\": {\n    \"template\": {\n      \"status_changes\": {\n      \
+    \  \"add\": [\"clientTransferProhibited\"]\n      }\n    },\n    \"instances\"\
+    : [\n      { \"name\": \"example.com\" },\n      { \"name\": \"example.net\" },\n\
+    \      { \"name\": \"example.org\" }\n    ]\n  }\n}\n```\n\n#### Per-domain overrides\n\
+    \nIf an instance provides its own `statuses` or `status_changes` field, it completely\
+    \ overrides the template's status settings for that domain. This lets you apply\
+    \ a default change to most domains while handling exceptions individually:\n\n\
+    ```json\n{\n  \"command\": \"domain_update_bulk\",\n  \"payload\": {\n    \"template\"\
+    : {\n      \"status_changes\": {\n        \"add\": [\"clientTransferProhibited\"\
     ]\n      }\n    },\n    \"instances\": [\n      { \"name\": \"example.com\" },\n\
-    \      { \"name\": \"example.net\" },\n      { \"name\": \"example.org\" }\n \
-    \   ]\n  }\n}\n```\n\n#### Per-domain overrides\n\nIf an instance provides its\
-    \ own `statuses` or `status_changes` field, it completely overrides the template's\
-    \ status settings for that domain. This lets you apply a default change to most\
-    \ domains while handling exceptions individually:\n\n```json\n{\n  \"command\"\
-    : \"domain_update_bulk\",\n  \"payload\": {\n    \"template\": {\n      \"status_changes\"\
-    : {\n        \"add\": [\"clientTransferProhibited\"]\n      }\n    },\n    \"\
-    instances\": [\n      { \"name\": \"example.com\" },\n      { \"name\": \"special-case.com\"\
-    , \"status_changes\": { \"remove\": [\"clientHold\"] } }\n    ]\n  }\n}\n```\n"
+    \      { \"name\": \"special-case.com\", \"status_changes\": { \"remove\": [\"\
+    clientHold\"] } }\n    ]\n  }\n}\n```\n\n### DNS Zone Bulk Commands\n\nThe three\
+    \ `dns_zone_*_bulk` commands operate at different levels of granularity. Picking\
+    \ the right one depends on how much of the zone's existing state you want to preserve.\n\
+    \n| Command | Operates on | Use when |\n|---------|-------------|----------|\n\
+    | `dns_zone_update_bulk` | Whole zone | Resetting rrsets (or zone attributes like\
+    \ DNSSEC) across many zones |\n| `dns_zone_patch_rrsets_bulk` | Whole rrsets by\
+    \ `(name, type)` | Replacing *all* records of a given type at a given name |\n\
+    | `dns_zone_patch_records_bulk` | Individual rdata values | Adding or removing\
+    \ a single record without touching siblings |\n\nThese are the bulk equivalents\
+    \ of the single-zone `PUT` and `PATCH` DNS endpoints \u2014 see the [DNS Management](#tag/DNS-Management)\
+    \ documentation for the underlying semantics. The bulk variants accept up to **100\
+    \ ops per instance** for the two patch commands.\n\n#### `dns_zone_update_bulk`\n\
+    \nBulk equivalent of `PUT /v1/dns/{zone_name}/rrsets` plus zone-level attribute\
+    \ updates. For each zone, whatever rrsets you supply become the zone's rrsets\
+    \ \u2014 anything not listed is removed. System-managed record types (SOA, DNSKEY,\
+    \ DS) cannot be set via this command. This is also the command to flip DNSSEC\
+    \ on or off across many zones.\n\nPayload: `template` (shared `rrsets` and `dnssec_status`)\
+    \ + `instances[]` (per-zone overrides).\n\n```json\n{\n  \"command\": \"dns_zone_update_bulk\"\
+    ,\n  \"payload\": {\n    \"template\": {\n      \"rrsets\": [\n        {\"name\"\
+    : \"@\", \"type\": \"A\", \"ttl\": 300, \"records\": [{\"rdata\": \"203.0.113.10\"\
+    }]}\n      ],\n      \"dnssec_status\": \"enabled\"\n    },\n    \"instances\"\
+    : [\n      { \"name\": \"example.com\" },\n      {\n        \"name\": \"example.net\"\
+    ,\n        \"rrsets\": [\n          {\"name\": \"@\", \"type\": \"A\", \"ttl\"\
+    : 300, \"records\": [{\"rdata\": \"203.0.113.20\"}]}\n        ]\n      }\n   \
+    \ ]\n  }\n}\n```\n\n#### `dns_zone_patch_rrsets_bulk`\n\nBulk equivalent of `PATCH\
+    \ /v1/dns/{zone_name}/rrsets`. Each instance is `{ zone_name, ops[] }`, where\
+    \ each op targets an rrset by `(name, type)`:\n\n- `op: \"upsert\"` \u2014 create\
+    \ or **replace** the rrset with the records you provide. Any prior records for\
+    \ that `(name, type)` are discarded.\n- `op: \"remove\"` \u2014 delete the entire\
+    \ rrset (pass `records: []`).\n\n```json\n{\n  \"command\": \"dns_zone_patch_rrsets_bulk\"\
+    ,\n  \"payload\": {\n    \"instances\": [\n      {\n        \"zone_name\": \"\
+    example.com\",\n        \"ops\": [\n          {\n            \"op\": \"upsert\"\
+    ,\n            \"rrset\": {\n              \"name\": \"www\", \"type\": \"A\"\
+    , \"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  }\n}\n```\n\n####\
+    \ `dns_zone_patch_records_bulk`\n\nBulk equivalent of `PATCH /v1/dns/{zone_name}/records`.\
+    \ Each instance is `{ zone_name, ops[] }`, where each op targets a single `rdata`\
+    \ value inside an rrset. Note the op payload uses a single `rdata` field, not\
+    \ `records[]`.\n\n- `op: \"upsert\"` \u2014 add or update that one rdata value\
+    \ (creates the rrset if it doesn't exist). Sibling records in the rrset are untouched.\n\
+    - `op: \"remove\"` \u2014 remove just that one rdata value. Other records in the\
+    \ rrset remain.\n\n```json\n{\n  \"command\": \"dns_zone_patch_records_bulk\"\
+    ,\n  \"payload\": {\n    \"instances\": [\n      {\n        \"zone_name\": \"\
+    example.com\",\n        \"ops\": [\n          {\n            \"op\": \"upsert\"\
+    ,\n            \"record\": {\n              \"name\": \"@\", \"type\": \"MX\"\
+    , \"ttl\": 300,\n              \"rdata\": \"5 new-mail.example.com.\"\n      \
+    \      }\n          },\n          {\n            \"op\": \"remove\",\n       \
+    \     \"record\": {\n              \"name\": \"@\", \"type\": \"MX\", \"ttl\"\
+    : 300,\n              \"rdata\": \"10 old-mail.example.com.\"\n            }\n\
+    \          }\n        ]\n      }\n    ]\n  }\n}\n```\n"
   name: jobs
   x-displayName: Jobs
 - description: 'Endpoints for creating and managing contacts.
@@ -21665,9 +22434,60 @@ tags:
     '
   name: contact
   x-displayName: Contacts
-- description: 'Endpoints for managing DNS records.
-
-    '
+- description: "Endpoints for managing DNS zones and records.\n\n### Zone, RRset,\
+    \ and Record\n\nOpusDNS uses standard DNS terminology, and the distinction matters\
+    \ when choosing which endpoint to call:\n\n- **Zone** \u2014 a DNS zone (e.g.,\
+    \ `example.com`). Contains many rrsets.\n- **RRset (Resource Record Set)** \u2014\
+    \ all records that share the same `(name, type)` tuple within a zone (e.g., the\
+    \ set of all `A` records for `www.example.com`). An rrset is the smallest unit\
+    \ DNS resolvers return in a query response.\n- **Record** \u2014 a single `rdata`\
+    \ value inside an rrset (e.g., `203.0.113.10`). An rrset contains one or more\
+    \ records.\n\nThree different update endpoints let you operate at different levels\
+    \ of granularity:\n\n| Endpoint | Scope | Semantics |\n|----------|-------|-----------|\n\
+    | `PUT /v1/dns/{zone_name}/rrsets` | Whole zone | Replaces all user-managed rrsets\
+    \ in the zone |\n| `PATCH /v1/dns/{zone_name}/rrsets` | RRset-level | Upserts\
+    \ or removes entire rrsets by `(name, type)` |\n| `PATCH /v1/dns/{zone_name}/records`\
+    \ | Record-level | Upserts or removes individual rdata values inside an rrset\
+    \ |\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 record types (SOA, DNSKEY,\
+    \ DS) are managed by OpusDNS and cannot be set or removed via this endpoint.\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\
+    \ A records\". Any other A records for `www` that currently exist will be removed.\n\
+    \n### `PATCH /v1/dns/{zone_name}/records` \u2014 Upsert or remove individual records\n\
+    \nSubmit an `ops[]` array where each op targets a single `rdata` value inside\
+    \ an rrset. Note the op payload uses a single `rdata` field, not `records[]`.\n\
+    \n- `op: \"upsert\"` \u2014 add or update that one rdata value. The containing\
+    \ rrset is created if it doesn't exist; sibling records in the rrset are left\
+    \ alone.\n- `op: \"remove\"` \u2014 remove just that one rdata value. Other records\
+    \ in the same rrset remain.\n\n```json\n{\n  \"ops\": [\n    {\n      \"op\":\
+    \ \"upsert\",\n      \"record\": {\n        \"name\": \"@\", \"type\": \"MX\"\
+    , \"ttl\": 300,\n        \"rdata\": \"5 new-mail.example.com.\"\n      }\n   \
+    \ },\n    {\n      \"op\": \"remove\",\n      \"record\": {\n        \"name\"\
+    : \"@\", \"type\": \"MX\", \"ttl\": 300,\n        \"rdata\": \"10 old-mail.example.com.\"\
+    \n      }\n    }\n  ]\n}\n```\n\nUse this when you need to surgically add or remove\
+    \ an individual record without disturbing sibling records in the same rrset \u2014\
+    \ e.g., \"add one more MX target\", \"rotate one A record IP out of a pool\".\n\
+    \n### Choosing the right endpoint\n\n| Scenario | Endpoint |\n|----------|----------|\n\
+    | Migrating a zone from another provider; want to set it to a known state | `PUT\
+    \ /rrsets` |\n| Replacing *all* records of a given name+type (e.g., the full MX\
+    \ set) | `PATCH /rrsets` with `upsert` |\n| Adding or removing a single record\
+    \ without touching its siblings | `PATCH /records` |\n| Swapping a name from CNAME\
+    \ to A | `PATCH /rrsets` with `remove` + `upsert` |\n\nFor bulk variants that\
+    \ operate across many zones in a single request, see the [Jobs](#tag/Jobs) documentation.\n"
   name: dns
   x-displayName: DNS Management
 - description: "Endpoints for creating and managing domains.\n\n### Domain References\n\