@opusdns/api 0.298.0 → 0.300.0

package/src/openapi.yaml

@@ -188,7 +188,8 @@ components:
           type: string
         product_reference:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The reference of the product
@@ -729,6 +730,7 @@ components:
       properties:
         city:
           description: The city of the contact
+          maxLength: 255
           minLength: 1
           title: City
           type: string
@@ -757,17 +759,20 @@ components:
           title: Fax
         first_name:
           description: The first name of the contact
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: The last name of the contact
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
         org:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The organization of the contact
@@ -781,24 +786,28 @@ components:
           type: string
         postal_code:
           description: The postal code of the contact
+          maxLength: 255
           minLength: 1
           title: Postal Code
           type: string
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The state of the contact
           title: State
         street:
           description: The address of the contact
+          maxLength: 255
           minLength: 1
           title: Street
           type: string
         title:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The title of the contact
@@ -844,6 +853,7 @@ components:
       properties:
         city:
           description: City
+          maxLength: 255
           minLength: 1
           title: City
           type: string
@@ -874,17 +884,20 @@ components:
           title: Fax
         first_name:
           description: First name of the contact
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: Last name of the contact
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
         org:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Override organization for this contact
@@ -896,24 +909,28 @@ components:
           type: string
         postal_code:
           description: Postal code
+          maxLength: 255
           minLength: 1
           title: Postal Code
           type: string
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Override state for this contact
           title: State
         street:
           description: Street address
+          maxLength: 255
           minLength: 1
           title: Street
           type: string
         title:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Override title for this contact
@@ -959,21 +976,24 @@ components:
           type: boolean
         org:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Organization name
           title: Org
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: State/province
           title: State
         title:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Contact title
@@ -1012,6 +1032,7 @@ components:
       properties:
         city:
           description: The city of the contact
+          maxLength: 255
           minLength: 1
           title: City
           type: string
@@ -1040,17 +1061,20 @@ components:
           title: Fax
         first_name:
           description: The first name of the contact
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: The last name of the contact
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
         org:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The organization of the contact
@@ -1064,24 +1088,28 @@ components:
           type: string
         postal_code:
           description: The postal code of the contact
+          maxLength: 255
           minLength: 1
           title: Postal Code
           type: string
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The state of the contact
           title: State
         street:
           description: The address of the contact
+          maxLength: 255
           minLength: 1
           title: Street
           type: string
         title:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The title of the contact
@@ -1185,6 +1213,7 @@ components:
           type: array
         city:
           description: The city of the contact
+          maxLength: 255
           minLength: 1
           title: City
           type: string
@@ -1226,17 +1255,20 @@ components:
           title: Fax
         first_name:
           description: The first name of the contact
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: The last name of the contact
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
         org:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The organization of the contact
@@ -1260,18 +1292,21 @@ components:
           type: string
         postal_code:
           description: The postal code of the contact
+          maxLength: 255
           minLength: 1
           title: Postal Code
           type: string
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The state of the contact
           title: State
         street:
           description: The address of the contact
+          maxLength: 255
           minLength: 1
           title: Street
           type: string
@@ -1285,7 +1320,8 @@ components:
           title: Tags
         title:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The title of the contact
@@ -1306,6 +1342,7 @@ components:
       properties:
         city:
           description: The city of the contact
+          maxLength: 255
           minLength: 1
           title: City
           type: string
@@ -1347,17 +1384,20 @@ components:
           title: Fax
         first_name:
           description: The first name of the contact
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: The last name of the contact
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
         org:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The organization of the contact
@@ -1381,24 +1421,28 @@ components:
           type: string
         postal_code:
           description: The postal code of the contact
+          maxLength: 255
           minLength: 1
           title: Postal Code
           type: string
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The state of the contact
           title: State
         street:
           description: The address of the contact
+          maxLength: 255
           minLength: 1
           title: Street
           type: string
         title:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The title of the contact
@@ -4003,7 +4047,8 @@ components:
       properties:
         auth_code:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The auth code for the domain
@@ -4123,6 +4168,7 @@ components:
           description: The second level domain
           examples:
           - example
+          maxLength: 255
           minLength: 1
           title: Sld
           type: string
@@ -4148,6 +4194,7 @@ components:
           description: The top level domain of the domain
           examples:
           - com
+          maxLength: 255
           minLength: 1
           title: Tld
           type: string
@@ -4766,7 +4813,8 @@ components:
       properties:
         auth_code:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The new auth code for the domain
@@ -4840,7 +4888,8 @@ components:
       properties:
         auth_code:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Override auth code for this domain
@@ -4972,7 +5021,8 @@ components:
       properties:
         auth_code:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The new auth code for the domain
@@ -6349,6 +6399,26 @@ components:
       - commands
       title: JobBatchRequest
       type: object
+    JobBatchRetryResponse:
+      properties:
+        batch_id:
+          description: TypeID identifying this batch
+          examples:
+          - batch_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^batch_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Batch Id
+          type: string
+          x-typeid-prefix: batch
+        retried_count:
+          description: Number of FAILED/DEAD_LETTER jobs reset to QUEUED for retry
+          title: Retried Count
+          type: integer
+      required:
+      - batch_id
+      - retried_count
+      title: JobBatchRetryResponse
+      type: object
     JobBatchStatusResponse:
       properties:
         batch_id:
@@ -7152,14 +7222,16 @@ components:
       properties:
         address_1:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: First line of the organization's address.
           title: Address 1
         address_2:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Second line of the organization's address.
@@ -7180,7 +7252,8 @@ components:
           title: Business Number
         city:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: City of the organization's address.
@@ -7226,6 +7299,7 @@ components:
           title: Keycloak Organization Id
         name:
           description: Name of the organization.
+          maxLength: 255
           minLength: 1
           title: Name
           type: string
@@ -7259,7 +7333,8 @@ components:
           title: Postal Code
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: State or province of the organization's address.
@@ -7435,14 +7510,16 @@ components:
       properties:
         address_1:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: First line of the organization's address.
           title: Address 1
         address_2:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Second line of the organization's address.
@@ -7464,7 +7541,8 @@ components:
           title: Business Number
         city:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: City of the organization's address.
@@ -7492,6 +7570,7 @@ components:
           title: Default Locale
         name:
           description: Name of the organization.
+          maxLength: 255
           minLength: 1
           title: Name
           type: string
@@ -7516,7 +7595,8 @@ components:
           title: Postal Code
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: State or province of the organization's address.
@@ -7595,14 +7675,16 @@ components:
       properties:
         address_1:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: First line of the organization's address.
           title: Address 1
         address_2:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Second line of the organization's address.
@@ -7618,7 +7700,8 @@ components:
           title: Business Number
         city:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: City of the organization's address.
@@ -7642,35 +7725,40 @@ components:
           title: Default Locale
         name:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Name of the organization.
           title: Name
         postal_code:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Postal code of the organization's address.
           title: Postal Code
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: State or province of the organization's address.
           title: State
         tax_id:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Tax ID of the organization.
           title: Tax Id
         tax_id_type:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Type of tax ID for the organization.
@@ -7697,14 +7785,16 @@ components:
           $ref: '#/components/schemas/BillingPlan'
         address_1:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: First line of the organization's address.
           title: Address 1
         address_2:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: Second line of the organization's address.
@@ -7727,7 +7817,8 @@ components:
           title: Business Number
         city:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: City of the organization's address.
@@ -7773,6 +7864,7 @@ components:
           title: Keycloak Organization Id
         name:
           description: Name of the organization.
+          maxLength: 255
           minLength: 1
           title: Name
           type: string
@@ -7806,7 +7898,8 @@ components:
           title: Postal Code
         state:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: State or province of the organization's address.
@@ -9531,6 +9624,7 @@ components:
           title: Description
         label:
           description: The label of the tag
+          maxLength: 255
           minLength: 1
           title: Label
           type: string
@@ -9616,6 +9710,7 @@ components:
           description: The color of the tag
         label:
           description: The label of the tag
+          maxLength: 255
           minLength: 1
           title: Label
           type: string
@@ -9659,6 +9754,7 @@ components:
           title: Description
         label:
           description: The label of the tag
+          maxLength: 255
           minLength: 1
           title: Label
           type: string
@@ -10329,6 +10425,7 @@ components:
           type: string
         first_name:
           description: The user's first name
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
@@ -10340,6 +10437,7 @@ components:
           title: Keycloak User Id
         last_name:
           description: The user's last name
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
@@ -10457,11 +10555,13 @@ components:
           type: string
         first_name:
           description: The user's first name
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: The user's last name
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
@@ -10531,11 +10631,13 @@ components:
           type: string
         first_name:
           description: The user's first name
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: The user's last name
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
@@ -10616,11 +10718,13 @@ components:
           type: string
         first_name:
           description: The user's first name
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: The user's last name
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
@@ -10753,14 +10857,16 @@ components:
           title: Email
         first_name:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The user's first name
           title: First Name
         last_name:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The user's last name
@@ -10790,7 +10896,8 @@ components:
           title: User Attributes
         username:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           description: The user's unique username
@@ -10818,11 +10925,13 @@ components:
           type: string
         first_name:
           description: The user's first name
+          maxLength: 255
           minLength: 1
           title: First Name
           type: string
         last_name:
           description: The user's last name
+          maxLength: 255
           minLength: 1
           title: Last Name
           type: string
@@ -11216,7 +11325,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-05-13-081105
+  version: 2026-05-14-142832
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -20978,6 +21087,66 @@ paths:
       summary: Resume a paused job
       tags:
       - jobs
+  /v1/job/{job_id}/retry:
+    post:
+      operationId: retry_job_v1_job__job_id__retry_post
+      parameters:
+      - description: Job ID
+        in: path
+        name: job_id
+        required: true
+        schema:
+          examples:
+          - job_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^job_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Job Id
+          type: string
+          x-typeid-prefix: job
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JobResponse'
+          description: Successful Response
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_JOB_NOT_FOUND
+                detail: No job found with id 'Additional error context.'
+                job_id: Additional error context.
+                status: 404
+                title: Batch Operation Error
+                type: job-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '409':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_JOB_STATUS_CONFLICT
+                detail: Additional error context.
+                status: 409
+                title: Batch Operation Error
+                type: job-status-conflict
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Conflict
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Retry a failed or dead-lettered job
+      tags:
+      - jobs
   /v1/jobs:
     get:
       operationId: list_batches_v1_jobs_get
@@ -22039,6 +22208,72 @@ paths:
       summary: Resume all paused jobs in a batch
       tags:
       - jobs
+  /v1/jobs/{batch_id}/retry:
+    post:
+      operationId: retry_batch_v1_jobs__batch_id__retry_post
+      parameters:
+      - description: Batch ID
+        in: path
+        name: batch_id
+        required: true
+        schema:
+          examples:
+          - batch_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^batch_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Batch Id
+          type: string
+          x-typeid-prefix: batch
+      - description: 'Optional repeatable filter: only retry jobs whose error_class
+          matches one of these values. Example: `?error_class=BillingInsufficientFundsError`
+          to retry only insufficient-funds failures. Omit to retry all failed/dead-lettered
+          jobs in the batch.'
+        in: query
+        name: error_class
+        required: false
+        schema:
+          anyOf:
+          - items:
+              type: string
+            type: array
+          - type: 'null'
+          description: 'Optional repeatable filter: only retry jobs whose error_class
+            matches one of these values. Example: `?error_class=BillingInsufficientFundsError`
+            to retry only insufficient-funds failures. Omit to retry all failed/dead-lettered
+            jobs in the batch.'
+          title: Error Class
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/JobBatchRetryResponse'
+          description: Successful Response
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_BATCH_NOT_FOUND
+                correlation_id: Additional error context.
+                detail: No batch found with correlation_id 'Additional error context.'
+                status: 404
+                title: Batch Operation Error
+                type: batch-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: Retry failed and dead-lettered jobs in a batch
+      tags:
+      - jobs
   /v1/organizations:
     get:
       description: Retrieves a paginated list of organizations under the current organization
@@ -23223,7 +23458,8 @@ paths:
         required: false
         schema:
           anyOf:
-          - minLength: 1
+          - maxLength: 255
+            minLength: 1
             type: string
           - type: 'null'
           title: Product Reference
@@ -24931,25 +25167,60 @@ tags:
     \ **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\"\
+    \ resumes all paused jobs\n- **Retry** \u2014 `POST /v1/jobs/{batch_id}/retry`\
+    \ retries failed and dead-lettered jobs in the batch (see [Retrying Failed Jobs](#retrying-failed-jobs))\n\
+    - **Cancel** \u2014 `DELETE /v1/jobs/{batch_id}` cancels all pending jobs in the\
+    \ batch\n\nIndividual jobs can also be paused, resumed, retried, or canceled via\
+    \ the `/v1/job/{job_id}` endpoints.\n\n### Retrying Failed Jobs\n\nIf jobs in\
+    \ a batch end up in `failed` or `dead_letter` state \u2014 for example because\
+    \ the account had insufficient funds at the time the batch was processed \u2014\
+    \ you can re-attempt them without rebuilding the batch from scratch.\n\n- **Single\
+    \ job:** `POST /v1/job/{job_id}/retry`\n- **Whole batch:** `POST /v1/jobs/{batch_id}/retry`\n\
+    \n#### What gets retried\n\nOnly jobs in `failed` or `dead_letter` status are\
+    \ eligible. Jobs in any other status are left unchanged:\n\n- `succeeded` \u2014\
+    \ already complete; retrying returns **409 Conflict**\n- `canceled` \u2014 you\
+    \ explicitly canceled these, so the retry won't undo that; returns **409 Conflict**\
+    \ (single) or is silently skipped (batch)\n- `queued`, `blocked`, `paused`, `running`\
+    \ \u2014 still in progress; not touched\n\nCalling batch retry on a mixed-state\
+    \ batch returns `retried_count` (the number of `failed` / `dead_letter` jobs that\
+    \ were re-queued); everything else is left alone. If the batch has no retryable\
+    \ jobs, `retried_count` is `0`.\n\n#### What happens to a retried job\n\nEach\
+    \ retried job is reset to a fresh attempt:\n\n- `status` \u2192 `queued`\n- `attempts`\
+    \ \u2192 `0`\n- `not_before` \u2192 now\n- `error_class` and `error_message` \u2192\
+    \ cleared\n- The job is republished for worker pickup\n\nThe original `payload`,\
+    \ `idempotency_key`, `correlation_id` (batch id), `max_attempts`, and backoff\
+    \ configuration are preserved. Each retry is processed under the same worker idempotency\
+    \ guarantees as the original \u2014 for billing operations specifically, a retried\
+    \ job will not double-charge an account that was already debited.\n\n#### Filtering\
+    \ by error type\n\nA batch may contain a mix of failures that you do and don't\
+    \ want to retry. For example, after adding funds to your account, you may want\
+    \ to retry only the jobs that failed with `BillingInsufficientFundsError`, while\
+    \ leaving alone jobs that failed for other reasons (e.g. an invalid domain name\
+    \ that should not be re-attempted).\n\nPass one or more `error_class` query parameters\
+    \ to filter:\n\n```\nPOST /v1/jobs/{batch_id}/retry?error_class=BillingInsufficientFundsError\n\
+    POST /v1/jobs/{batch_id}/retry?error_class=BillingInsufficientFundsError&error_class=DomainRegistryTemporaryError\n\
+    ```\n\nMultiple values are OR'd \u2014 a job is retried if its `error_class` matches\
+    \ **any** of the supplied values. Omitting the filter retries all `failed` and\
+    \ `dead_letter` jobs in the batch.\n\nThe `error_class` for each failed job is\
+    \ visible on the individual job response (`GET /v1/jobs/{batch_id}/jobs`), so\
+    \ the typical flow is:\n\n1. List the failed jobs in the batch and group by `error_class`.\n\
+    2. Determine which failures are recoverable.\n3. Call retry with the relevant\
+    \ `error_class` filter.\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\