Deprecation: Remove getWhoisPrivacy and renewWhoisPrivacy endpoints (#919)

These endpoints were deprecated on 2023-05-01. The WHOIS privacy state
can now be retrieved through getDomain, and WHOIS privacy no longer
requires renewal as it stays enabled unless explicitly disabled.

Author: weppos

content/v2/openapi.yml

@@ -1450,27 +1450,17 @@ paths:
   '/{account}/registrar/domains/{domain}/whois_privacy':
     get:
       deprecated: true
-      description: Gets the whois privacy status for an existing domain.
+      description: 'This endpoint has been deprecated and removed. Use getDomain instead.'
       parameters:
         - $ref: '#/components/parameters/Account'
         - $ref: '#/components/parameters/Domain'
       operationId: getWhoisPrivacy
       tags:
         - registrar privacy
       responses:
-        '200':
-          description: Successfully retrieved whois privacy details.
-          content:
-            application/json:
-              schema:
-                type: object
-                required: [data]
-                properties:
-                  data:
-                    $ref: '#/components/schemas/WhoisPrivacy'
-        '404':
-          $ref: '#/components/responses/404'
-      summary: WHOIS privacy status
+        '410':
+          description: This endpoint has been removed.
+      summary: WHOIS privacy status (deprecated)
     put:
       description: |-
         Enables the WHOIS privacy for the domain.
@@ -1531,32 +1521,17 @@ paths:
   '/{account}/registrar/domains/{domain}/whois_privacy/renewals':
     post:
       deprecated: true
-      description: |-
-        Renews the WHOIS privacy for the domain.
-
-        Note that if the WHOIS privacy was never purchased for the domain or if there is another renewal order in progress, renewing WHOIS privacy will return an error.
+      description: 'This endpoint has been deprecated and removed. WHOIS privacy no longer requires renewal.'
       parameters:
         - $ref: '#/components/parameters/Account'
         - $ref: '#/components/parameters/Domain'
       operationId: renewWhoisPrivacy
       tags:
         - registrar privacy
       responses:
-        '201':
-          description: Successfully renew whois privacy.
-          content:
-            application/json:
-              schema:
-                type: object
-                required: [data]
-                properties:
-                  data:
-                    $ref: '#/components/schemas/WhoisPrivacyRenewal'
-        '400':
-          $ref: '#/components/responses/400'
-        '404':
-          $ref: '#/components/responses/404'
-      summary: Renew WHOIS privacy
+        '410':
+          description: This endpoint has been removed.
+      summary: Renew WHOIS privacy (deprecated)
   '/{account}/secondary_dns/primaries':
     get:
       summary: List primary servers
@@ -6178,43 +6153,6 @@ components:
         enabled: true
         created_at: '2016-02-13T14:34:50Z'
         updated_at: '2016-02-13T14:34:52Z'
-    WhoisPrivacyRenewal:
-      type: object
-      required:
-        - id
-        - domain_id
-        - whois_privacy_id
-        - state
-        - enabled
-        - expires_on
-        - created_at
-        - updated_at
-      properties:
-        id:
-          type: integer
-        domain_id:
-          type: integer
-        whois_privacy_id:
-          type: integer
-        state:
-          type: string
-        enabled:
-          type: boolean
-        expires_on:
-          $ref: '#/components/schemas/Date'
-        created_at:
-          $ref: '#/components/schemas/DateTimeCreatedAt'
-        updated_at:
-          $ref: '#/components/schemas/DateTimeUpdatedAt'
-      example:
-        id: 1
-        domain_id: 100
-        whois_privacy_id: 999
-        state: new
-        enabled: true
-        expires_on: '2020-01-10'
-        created_at: '2019-01-10T12:12:48Z'
-        updated_at: '2019-01-10T12:12:48Z'
     Zone:
       type: object
       description: Represents a DNS zone.

content/v2/registrar/whois-privacy.md

@@ -16,35 +16,8 @@ Enable and disable WHOIS privacy on registered domains.
 
 ## Retrieve the domain WHOIS privacy {#getWhoisPrivacy}
 
-    GET /:account/registrar/domains/:domain/whois_privacy
-
-Get the WHOIS privacy details for a domain.
-
-> [!WARNING] Deprecated since 01 May 2023
-> This endpoint has been deprecated. You can retrieve a domain WHOIS privacy state through [retrieve domain](/v2/domains/#getDomain).
-
-### Parameters
-
-Name | Type | Description
------|------|------------
-`:account` | `integer` | The account id
-`:domain` | `string`, `integer` | The domain name or id
-
-### Example
-
-Get WHOIS privacy for the domain `example.com` in the account `1010`:
-
-    curl  -H 'Authorization: Bearer <token>' \
-          -H 'Accept: application/json' \
-          https://api.dnsimple.com/v2/1010/registrar/domains/example.com/whois_privacy
-
-### Response
-
-Responds with HTTP 200 on success
-
-```json
-<%= pretty_print_fixture("/api/getWhoisPrivacy/success.http") %>
-```
+> [!WARNING]
+> This endpoint has been deprecated and removed. Use [retrieve domain](/v2/domains/#getDomain) instead.
 
 ## Enable WHOIS privacy {#enableWhoisPrivacy}
 
@@ -124,39 +97,5 @@ Responds with [HTTP 401](/v2/#unauthorized) in case of case of authentication is
 
 ## Renew WHOIS privacy {#renewWhoisPrivacy}
 
-```
-POST /:account/registrar/domains/:domain/whois_privacy/renewals
-```
-
-> [!WARNING] Deprecated since 01 May 2023
-> This endpoint has been deprecated. You no longer need to renew the WHOIS privacy service. It will stay enabled unless you disable it.
-
-### Parameters
-
-Name | Type | Description
------|------|------------
-`:account` | `integer` | The account id
-`:domain` | `string`, `integer` | The domain name or id
-
-### Example
-
-Renew WHOIS privacy for the domain `example.com` in the account `1010`:
-
-    curl  -H 'Authorization: Bearer <token>' \
-          -H 'Accept: application/json' \
-          -X POST \
-          https://api.dnsimple.com/v2/1010/registrar/domains/example.com/whois_privacy/renewals
-
-### Response
-
-Responds with HTTP 201 if WHOIS privacy is renewed.
-
-```json
-<%= pretty_print_fixture("/api/renewWhoisPrivacy/success.http") %>
-```
-
-### Errors
-
-Responds with [HTTP 400](/v2/#bad-request) if WHOIS privacy cannot be renewed.
-
-Responds with [HTTP 401](/v2/#unauthorized) in case of case of authentication issues.
+> [!WARNING]
+> This endpoint has been deprecated and removed. WHOIS privacy no longer requires renewal.