npm - @opusdns/api - Versions diffs - 1.151.0 → 1.153.0 - Mend

@opusdns/api 1.151.0 → 1.153.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/src/openapi.yaml CHANGED Viewed

@@ -3981,71 +3981,28 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Additional attributes of the domain, keyed by attribute name;
-            request values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Additional attributes of the domain, keyed by attribute name.\
+            \ Values are strings.\n\nCustomer-settable keys:\n\n- `auto_renew_period`:\
+            \ `monthly` or `yearly`. All TLDs on create and transfer-in, `.de` only\
+            \ on update. Selects the\n  period of the next renewal; the current expiry\
+            \ date does not move. On transfer-in without `period` it also sets the\n\
+            \  period added by the transfer. `monthly` is rejected on transfer-in\
+            \ and ignored at renewal when the TLD has no\n  month-unit renewal period.\n\
+            - `music_registrant_attestation`: `true`. `.music` registration.\n- `nic_it_compliance_confirmation`:\
+            \ `true`. `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           examples:
           - auto_renew_period: monthly
           title: Attributes
@@ -4142,74 +4099,29 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Override attributes for this domain.
-            Additional attributes of the domain, keyed by attribute name; request
-            values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Override attributes for this domain.\n\nAdditional attributes\
+            \ of the domain, keyed by attribute name. Values are strings.\n\nCustomer-settable\
+            \ keys:\n\n- `auto_renew_period`: `monthly` or `yearly`. All TLDs on create\
+            \ and transfer-in, `.de` only on update. Selects the\n  period of the\
+            \ next renewal; the current expiry date does not move. On transfer-in\
+            \ without `period` it also sets the\n  period added by the transfer. `monthly`\
+            \ is rejected on transfer-in and ignored at renewal when the TLD has no\n\
+            \  month-unit renewal period.\n- `music_registrant_attestation`: `true`.\
+            \ `.music` registration.\n- `nic_it_compliance_confirmation`: `true`.\
+            \ `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           title: Attributes
         auth_code:
           anyOf:
@@ -4291,71 +4203,28 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Additional attributes of the domain, keyed by attribute name;
-            request values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Additional attributes of the domain, keyed by attribute name.\
+            \ Values are strings.\n\nCustomer-settable keys:\n\n- `auto_renew_period`:\
+            \ `monthly` or `yearly`. All TLDs on create and transfer-in, `.de` only\
+            \ on update. Selects the\n  period of the next renewal; the current expiry\
+            \ date does not move. On transfer-in without `period` it also sets the\n\
+            \  period added by the transfer. `monthly` is rejected on transfer-in\
+            \ and ignored at renewal when the TLD has no\n  month-unit renewal period.\n\
+            - `music_registrant_attestation`: `true`. `.music` registration.\n- `nic_it_compliance_confirmation`:\
+            \ `true`. `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           title: Attributes
         auth_code:
           anyOf:
@@ -4427,71 +4296,28 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Additional attributes of the domain, keyed by attribute name;
-            request values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Additional attributes of the domain, keyed by attribute name.\
+            \ Values are strings.\n\nCustomer-settable keys:\n\n- `auto_renew_period`:\
+            \ `monthly` or `yearly`. All TLDs on create and transfer-in, `.de` only\
+            \ on update. Selects the\n  period of the next renewal; the current expiry\
+            \ date does not move. On transfer-in without `period` it also sets the\n\
+            \  period added by the transfer. `monthly` is rejected on transfer-in\
+            \ and ignored at renewal when the TLD has no\n  month-unit renewal period.\n\
+            - `music_registrant_attestation`: `true`. `.music` registration.\n- `nic_it_compliance_confirmation`:\
+            \ `true`. `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           examples:
           - auto_renew_period: monthly
           title: Attributes
@@ -6350,74 +6176,29 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Override attributes for this domain.
-            Additional attributes of the domain, keyed by attribute name; request
-            values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Override attributes for this domain.\n\nAdditional attributes\
+            \ of the domain, keyed by attribute name. Values are strings.\n\nCustomer-settable\
+            \ keys:\n\n- `auto_renew_period`: `monthly` or `yearly`. All TLDs on create\
+            \ and transfer-in, `.de` only on update. Selects the\n  period of the\
+            \ next renewal; the current expiry date does not move. On transfer-in\
+            \ without `period` it also sets the\n  period added by the transfer. `monthly`\
+            \ is rejected on transfer-in and ignored at renewal when the TLD has no\n\
+            \  month-unit renewal period.\n- `music_registrant_attestation`: `true`.\
+            \ `.music` registration.\n- `nic_it_compliance_confirmation`: `true`.\
+            \ `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           title: Attributes
         auth_code:
           anyOf:
@@ -6499,71 +6280,28 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Additional attributes of the domain, keyed by attribute name;
-            request values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Additional attributes of the domain, keyed by attribute name.\
+            \ Values are strings.\n\nCustomer-settable keys:\n\n- `auto_renew_period`:\
+            \ `monthly` or `yearly`. All TLDs on create and transfer-in, `.de` only\
+            \ on update. Selects the\n  period of the next renewal; the current expiry\
+            \ date does not move. On transfer-in without `period` it also sets the\n\
+            \  period added by the transfer. `monthly` is rejected on transfer-in\
+            \ and ignored at renewal when the TLD has no\n  month-unit renewal period.\n\
+            - `music_registrant_attestation`: `true`. `.music` registration.\n- `nic_it_compliance_confirmation`:\
+            \ `true`. `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           title: Attributes
         contacts:
           $ref: '#/components/schemas/DomainContactHandles'
@@ -6629,71 +6367,28 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Additional attributes of the domain, keyed by attribute name;
-            request values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Additional attributes of the domain, keyed by attribute name.\
+            \ Values are strings.\n\nCustomer-settable keys:\n\n- `auto_renew_period`:\
+            \ `monthly` or `yearly`. All TLDs on create and transfer-in, `.de` only\
+            \ on update. Selects the\n  period of the next renewal; the current expiry\
+            \ date does not move. On transfer-in without `period` it also sets the\n\
+            \  period added by the transfer. `monthly` is rejected on transfer-in\
+            \ and ignored at renewal when the TLD has no\n  month-unit renewal period.\n\
+            - `music_registrant_attestation`: `true`. `.music` registration.\n- `nic_it_compliance_confirmation`:\
+            \ `true`. `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           examples:
           - auto_renew_period: monthly
           title: Attributes
@@ -6759,71 +6454,28 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Additional attributes of the domain, keyed by attribute name;
-            request values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Additional attributes of the domain, keyed by attribute name.\
+            \ Values are strings.\n\nCustomer-settable keys:\n\n- `auto_renew_period`:\
+            \ `monthly` or `yearly`. All TLDs on create and transfer-in, `.de` only\
+            \ on update. Selects the\n  period of the next renewal; the current expiry\
+            \ date does not move. On transfer-in without `period` it also sets the\n\
+            \  period added by the transfer. `monthly` is rejected on transfer-in\
+            \ and ignored at renewal when the TLD has no\n  month-unit renewal period.\n\
+            - `music_registrant_attestation`: `true`. `.music` registration.\n- `nic_it_compliance_confirmation`:\
+            \ `true`. `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           examples:
           - auto_renew_period: monthly
           title: Attributes
@@ -6934,71 +6586,28 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Additional attributes of the domain, keyed by attribute name;
-            request values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Additional attributes of the domain, keyed by attribute name.\
+            \ Values are strings.\n\nCustomer-settable keys:\n\n- `auto_renew_period`:\
+            \ `monthly` or `yearly`. All TLDs on create and transfer-in, `.de` only\
+            \ on update. Selects the\n  period of the next renewal; the current expiry\
+            \ date does not move. On transfer-in without `period` it also sets the\n\
+            \  period added by the transfer. `monthly` is rejected on transfer-in\
+            \ and ignored at renewal when the TLD has no\n  month-unit renewal period.\n\
+            - `music_registrant_attestation`: `true`. `.music` registration.\n- `nic_it_compliance_confirmation`:\
+            \ `true`. `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           examples:
           - auto_renew_period: monthly
           title: Attributes
@@ -7218,71 +6827,28 @@ components:
               $ref: '#/components/schemas/DomainAttributeKey'
             type: object
           - type: 'null'
-          description: 'Additional attributes of the domain, keyed by attribute name;
-            request values are strings.
-            Direction: *input* keys are read from the request; *output* keys are written
-            by the platform, rejected if supplied and
-            never returned under `attributes`; *ignored* keys are dropped from the
-            request because the platform derives them itself.
-            | Key | Accepted values | TLDs | Direction |
-            |---|---|---|---|
-            | `auto_renew_period` | `monthly`, `yearly` | all on create and transfer-in,
-            `.de` only on update | both |
-            | `music_registrant_attestation` | `true` (also `1`, `yes`) | .music (registration)
-            | input |
-            | `nic_it_compliance_confirmation` | `true` (also `1`, `yes`) | .it (registration,
-            transfer) | input |
-            | `travel_industry_acknowledgement` | `true` (also `1`, `yes`) | .travel
-            (registration) | input |
-            | `internet_ee_registrant_agreement` | `true` (also `1`, `yes`) | .ee
-            (registration) | input |
-            | `punktum_dk_terms_acceptance` | `true` (also `1`, `yes`) | .dk (registration,
-            registrant change) | input |
-            | `de_general_request_contact` | id of a contact whose `.de` attribute
-            set has `DE_CONTACT_TYPE` = `REQUEST` | .de | input |
-            | `de_abuse_contact` | id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`
-            = `REQUEST` | .de | input |
-            | `nor_id_applicant_version`, `nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`
-            | taken from the signed applicant declaration | .no | ignored |
-            | `nor_id_declaration`, `nor_id_declaration_token` | | .no | output |
-            | `punktum_dk_tracking_no` | registry-issued | .dk | output |
-            | `verification_required` | | all | output |
-            | `promotion`, `promotion_eligibility` | | all | output |
-            `auto_renew_period`: on transfer-in without `period` it also sets the
-            period added by the transfer; on create and update it
-            selects the period of the next renewal only and the current expiry date
-            does not move. `monthly` is rejected on transfer-in
-            and ignored at renewal when the TLD''s renewal periods have no month unit.
-            On update, only `.de` stores attributes and an empty value removes the
-            stored attribute; `.dk` reads
-            `punktum_dk_terms_acceptance` to confirm a registrant change and other
-            registries ignore attributes.
-            '
+          description: "Additional attributes of the domain, keyed by attribute name.\
+            \ Values are strings.\n\nCustomer-settable keys:\n\n- `auto_renew_period`:\
+            \ `monthly` or `yearly`. All TLDs on create and transfer-in, `.de` only\
+            \ on update. Selects the\n  period of the next renewal; the current expiry\
+            \ date does not move. On transfer-in without `period` it also sets the\n\
+            \  period added by the transfer. `monthly` is rejected on transfer-in\
+            \ and ignored at renewal when the TLD has no\n  month-unit renewal period.\n\
+            - `music_registrant_attestation`: `true`. `.music` registration.\n- `nic_it_compliance_confirmation`:\
+            \ `true`. `.it` registration and transfer.\n- `travel_industry_acknowledgement`:\
+            \ `true`. `.travel` registration.\n- `internet_ee_registrant_agreement`:\
+            \ `true`. `.ee` registration.\n- `punktum_dk_terms_acceptance`: `true`.\
+            \ `.dk` registration and registrant change.\n- `de_general_request_contact`,\
+            \ `de_abuse_contact`: id of a contact whose `.de` attribute set has `DE_CONTACT_TYPE`\
+            \ =\n  `REQUEST`. `.de` only.\n\nBoolean keys also accept `1` and `yes`.\n\
+            \nWritten by the platform and rejected if supplied: `verification_required`,\
+            \ `promotion`, `promotion_eligibility`,\n`nor_id_declaration`, `nor_id_declaration_token`,\
+            \ `punktum_dk_tracking_no`. They are never returned under `attributes`.\n\
+            \nDerived from the signed `.no` applicant declaration and ignored if supplied:\
+            \ `nor_id_applicant_version`,\n`nor_id_applicant_accept_name`, `nor_id_applicant_accept_date`.\n\
+            \nOn update, only `.de` stores attributes and an empty value removes the\
+            \ stored attribute; `.dk` reads\n`punktum_dk_terms_acceptance` to confirm\
+            \ a registrant change and other registries ignore attributes.\n"
           examples:
           - auto_renew_period: monthly
           title: Attributes
@@ -13343,6 +12909,7 @@ components:
       - generating
       - completed
       - failed
+      - empty
       title: ReportStatus
       type: string
     ReportTriggerType:
@@ -16598,7 +16165,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-09-02-200743
+  version: 2026-09-03-091013
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -35046,8 +34613,9 @@ tags:
     \ the registrar-elements OpenSearch index, populated by the scheduled daily registrar\
     \ syncs. Report generation does not trigger a sync; it uses the most recently\
     \ synced data as-is. If the credential has no portfolio data yet (for example,\
-    \ a credential created since the last sync), generation fails with an error indicating\
-    \ the credential is too new to report on.\n\nThe downloaded ZIP contains `registrar-portfolio-{report_typeid}.pdf`.\
+    \ a credential created since the last sync), the report ends as `empty` rather\
+    \ than `failed`: there is nothing to report on yet, and the next run after a sync\
+    \ produces the real report.\n\nThe downloaded ZIP contains `registrar-portfolio-{report_typeid}.pdf`.\
     \ Before each PDF generation, the report service loads the organization's current\
     \ available TLD list from the backend and uses it to mark TLDs in the portfolio\
     \ as available or unavailable. The first version includes the sections backed\
@@ -35058,14 +34626,18 @@ tags:
     \ through the following statuses:\n\n1. **pending** \u2014 Report has been queued\
     \ for generation\n2. **generating** \u2014 Report is being built\n3. **completed**\
     \ \u2014 Report is ready for download\n4. **failed** \u2014 Generation failed\n\
+    5. **empty** \u2014 The organization had no data for this report type (for example\
+    \ no domains, zones or forwards). No file is produced and download returns `409\
+    \ Conflict`. `record_count` is `0`.\n\n`completed`, `failed` and `empty` are terminal.\n\
     \n### Usage Pattern\n\n1. **Request a report** \u2014 `POST /v1/reports` with\
     \ the desired `report_type`\n2. **Poll for completion** \u2014 `GET /v1/reports/{report_id}`\
-    \ until `status` is `completed`\n3. **Download** \u2014 `GET /v1/reports/{report_id}/download`\
-    \ returns the report as a streamed ZIP file\n\n### Downloading Reports\n\n`GET\
-    \ /v1/reports/{report_id}/download` streams the report file directly to the client.\
-    \ The report **must** have status `completed` before it can be downloaded \u2014\
-    \ calling this endpoint on a report that is still `pending` or `generating` returns\
-    \ `409 Conflict`.\n\n**Response details:**\n\n| Header | Value |\n|--------|-------|\n\
+    \ until `status` is terminal (`completed`, `empty` or `failed`)\n3. **Download**\
+    \ \u2014 `GET /v1/reports/{report_id}/download` returns the report as a streamed\
+    \ ZIP file\n\n### Downloading Reports\n\n`GET /v1/reports/{report_id}/download`\
+    \ streams the report file directly to the client. The report **must** have status\
+    \ `completed` before it can be downloaded \u2014 calling this endpoint on a report\
+    \ that is still `pending` or `generating`, or that ended `empty`, returns `409\
+    \ Conflict`.\n\n**Response details:**\n\n| Header | Value |\n|--------|-------|\n\
     | `Content-Type` | `application/zip` |\n| `Content-Disposition` | `attachment;\
     \ filename={report_type}-{report_id}.zip` |\n| `Content-Length` | File size in\
     \ bytes (included when known) |\n\nThe response body is streamed in chunks, so\
@@ -35081,13 +34653,17 @@ tags:
     \ per clock hour** (UTC) can be generated. Duplicate requests within the same\
     \ hour will not produce an additional report.\n\n### Retention\n\nThe **30 most\
     \ recent reports** of each type are kept per organization. Older reports and their\
-    \ associated files are automatically deleted when a new report is generated.\n\
-    \n### Listing Reports\n\nUse `GET /v1/reports` to list reports with optional filters:\n\
-    \n| Parameter | Description |\n|-----------|-------------|\n| `report_type` |\
-    \ Filter by report type (repeatable) |\n| `status` | Filter by report status (repeatable)\
-    \ |\n| `trigger_type` | Filter by trigger type |\n| `created_after` | Only reports\
-    \ created after this timestamp |\n| `created_before` | Only reports created before\
-    \ this timestamp |\n"
+    \ associated files are automatically deleted when a new report is generated. Of\
+    \ the `empty` reports of a type, only the most recent one is kept, so scheduled\
+    \ runs for an organization without data do not fill the list with identical entries.\
+    \ `registrar_portfolio_pdf` is exempt from that rule, because its reports are\
+    \ per registrar credential and an `empty` result for one credential says nothing\
+    \ about another.\n\n### Listing Reports\n\nUse `GET /v1/reports` to list reports\
+    \ with optional filters:\n\n| Parameter | Description |\n|-----------|-------------|\n\
+    | `report_type` | Filter by report type (repeatable) |\n| `status` | Filter by\
+    \ report status (repeatable) |\n| `trigger_type` | Filter by trigger type |\n\
+    | `created_after` | Only reports created after this timestamp |\n| `created_before`\
+    \ | Only reports created before this timestamp |\n"
   name: report
   x-displayName: Reports
 - description: Endpoints for creating new Tags