docs: clarify Zone object description, closes #8748

Point out that the `rrsets` is only included at the zone detail endpoint

diff --git a/docs/http-api/swagger/authoritative-api-swagger.yaml b/docs/http-api/swagger/authoritative-api-swagger.yaml
index 86bc3921bee779abf6e40a5a0b5d310330f8aa5d..27c40047d7c579d64a123afbaff98e8865e81bd0 100644 (file)
--- a/docs/http-api/swagger/authoritative-api-swagger.yaml
+++ b/docs/http-api/swagger/authoritative-api-swagger.yaml
@@ -918,7 +918,7 @@ definitions:
         type: array
         items:
           $ref: '#/definitions/RRSet'
-        description: 'RRSets in this zone'
+        description: 'RRSets in this zone (for zones/{zone_id} endpoint only; omitted during GET on the .../zones list endpoint)'
       serial:
         type: integer
         description: 'The SOA serial number'