diff --git a/pages/apis/rest_api/packages/registries.md b/pages/apis/rest_api/packages/registries.md
index d9bde9eb44..cdfb0e3cfa 100644
--- a/pages/apis/rest_api/packages/registries.md
+++ b/pages/apis/rest_api/packages/registries.md
@@ -72,7 +72,7 @@ curl -H "Authorization: Bearer $TOKEN" \
     "web_url": "https://buildkite.com/organizations/my-org/packages/registries/my-registry",
     "name": "my registry",
     "ecosystem": "ruby",
-    "description": null,
+    "description": "registry containing ruby gems",
     "emoji": null,
     "color": null,
     "public": false,
@@ -156,3 +156,14 @@ Optional [request body properties](/docs/api#request-body-properties):
 Required scope: `write_registries`
 
 Success response: `200 OK`
+
+## Delete a registry
+
+```bash
+curl -H "Authorization: Bearer $TOKEN" \
+  -X DELETE "https://api.buildkite.com/v2/packages/organizations/#{org.slug}/registries/#{registry.slug}"
+```
+
+Required scope: `delete_registries`
+
+Success response: `200 OK`