diff --git a/doc/compiled.json b/doc/compiled.json
index afba5090..ea3ec9af 100644
--- a/doc/compiled.json
+++ b/doc/compiled.json
@@ -5684,7 +5684,7 @@
     "/projects/{project_id}/documents/{id}": {
       "delete": {
         "summary": "Delete document",
-        "description": "Delete an existing document.",
+        "description": "Permanently deletes a document and all of its associated translation segments from the project. Use this when you want to remove a document that is no longer needed; the deletion cannot be reversed and all associated segments will be lost.\n",
         "operationId": "document/delete",
         "tags": [
           "Documents"
@@ -5702,32 +5702,38 @@
         ],
         "responses": {
           "200": {
+            "description": "The document was successfully deleted. The response body is empty.",
             "$ref": "#/components/responses/200"
           },
           "400": {
+            "description": "Bad request. The request was malformed or contained an invalid parameter. Correct the request and retry.",
             "$ref": "#/components/responses/400"
           },
           "401": {
+            "description": "Unauthorized. The access token is missing or invalid. Provide a valid token and retry.",
             "$ref": "#/components/responses/401"
           },
           "403": {
-            "$ref": "#/components/responses/403",
-            "description": "Forbidden. Returned when the access token lacks the `write` scope or when the requesting user is not allowed to delete this document."
+            "description": "Forbidden. The access token lacks the write scope or the authenticated user does not have manage permission on this document. Obtain a token with the write scope or request manage access from a project administrator.",
+            "$ref": "#/components/responses/403"
           },
           "404": {
+            "description": "Not Found. No document with the given ID exists in this project. Verify the document ID and project ID before retrying.",
             "$ref": "#/components/responses/404"
           },
           "422": {
+            "description": "Unprocessable entity. The document could not be deleted due to a validation error. Check the errors field in the response body for details.",
             "$ref": "#/components/responses/422"
           },
           "429": {
+            "description": "Rate limit exceeded. Too many requests in a short period. Wait until the time indicated by the X-Rate-Limit-Reset header before retrying.",
             "$ref": "#/components/responses/429"
           }
         },
         "x-code-samples": [
           {
             "lang": "Curl",
-            "source": "curl \"https://api.phrase.com/v2/projects/:project_id/documents/:id\" \\\n  -u USERNAME_OR_ACCESS_TOKEN \\\n  -X DELETE \\\n  -H 'Content-Type: application/json'"
+            "source": "curl \"https://api.phrase.com/v2/projects/:project_id/documents/:id\" \\\n  -u USERNAME_OR_ACCESS_TOKEN \\\n  -X DELETE"
           },
           {
             "lang": "CLI v2",
diff --git a/paths/documents/destroy.yaml b/paths/documents/destroy.yaml
index bcae3e6e..5bebd2ef 100644
--- a/paths/documents/destroy.yaml
+++ b/paths/documents/destroy.yaml
@@ -1,6 +1,7 @@
 ---
 summary: Delete document
-description: Delete an existing document.
+description: |
+  Permanently deletes a document and all of its associated translation segments from the project. Use this when you want to remove a document that is no longer needed; the deletion cannot be reversed and all associated segments will be lost.
 operationId: document/delete
 tags:
 - Documents
@@ -10,27 +11,32 @@ parameters:
 - "$ref": "../../parameters.yaml#/id"
 responses:
   '200':
+    description: The document was successfully deleted. The response body is empty.
     "$ref": "../../responses.yaml#/200"
   '400':
+    description: Bad request. The request was malformed or contained an invalid parameter. Correct the request and retry.
     "$ref": "../../responses.yaml#/400"
-  '404':
-    "$ref": "../../responses.yaml#/404"
   '401':
+    description: Unauthorized. The access token is missing or invalid. Provide a valid token and retry.
     "$ref": "../../responses.yaml#/401"
   '403':
+    description: Forbidden. The access token lacks the write scope or the authenticated user does not have manage permission on this document. Obtain a token with the write scope or request manage access from a project administrator.
     "$ref": "../../responses.yaml#/403"
-    description: Forbidden. Returned when the access token lacks the `write` scope or when the requesting user is not allowed to delete this document.
+  '404':
+    description: Not Found. No document with the given ID exists in this project. Verify the document ID and project ID before retrying.
+    "$ref": "../../responses.yaml#/404"
   '422':
+    description: Unprocessable entity. The document could not be deleted due to a validation error. Check the errors field in the response body for details.
     "$ref": "../../responses.yaml#/422"
   '429':
+    description: Rate limit exceeded. Too many requests in a short period. Wait until the time indicated by the X-Rate-Limit-Reset header before retrying.
     "$ref": "../../responses.yaml#/429"
 x-code-samples:
 - lang: Curl
   source: |-
     curl "https://api.phrase.com/v2/projects/:project_id/documents/:id" \
       -u USERNAME_OR_ACCESS_TOKEN \
-      -X DELETE \
-      -H 'Content-Type: application/json'
+      -X DELETE
 - lang: CLI v2
   source: |-
     phrase documents delete \