From 2765afc8300d3981c46c15b394e8a640b125edee Mon Sep 17 00:00:00 2001
From: Malcolm Jones <malcolm.jones@nytimes.com>
Date: Thu, 14 Jun 2018 15:25:45 -0400
Subject: [PATCH] Document the endpoint for deleting an org

---
 docs/sources/http_api/org.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/sources/http_api/org.md b/docs/sources/http_api/org.md
index 16721b1c89d..1ebde0878e7 100644
--- a/docs/sources/http_api/org.md
+++ b/docs/sources/http_api/org.md
@@ -331,6 +331,27 @@ Content-Type: application/json
 {"message":"Organization updated"}
 ```
 
+## Delete Organisation
+
+`DELETE /api/orgs/:orgId`
+
+**Example Request**:
+
+```http
+DELETE /api/orgs/1 HTTP/1.1
+Accept: application/json
+Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
+```
+
+**Example Response**:
+
+```http
+HTTP/1.1 200
+Content-Type: application/json
+
+{"message":"Organization deleted"}
+```
+
 ## Get Users in Organisation
 
 `GET /api/orgs/:orgId/users`