diff --git a/website/source/api/allocations.html.md b/website/source/api/allocations.html.md
index 06f3f42f2..c1b427e63 100644
--- a/website/source/api/allocations.html.md
+++ b/website/source/api/allocations.html.md
@@ -567,3 +567,40 @@ $ curl \
- `Building Task Directory` - Task is building its file system.
Depending on the type the event will have applicable annotations.
+
+## Stop Allocation
+
+This endpoint stops and reschedules a specific allocation.
+
+| Method | Path | Produces |
+| ------ | -------------------------- | -------------------------- |
+| `POST` / `PUT` | `/v1/allocation/:alloc_id/stop` | `application/json` |
+
+The table below shows this endpoint's support for
+[blocking queries](/api/index.html#blocking-queries) and
+[required ACLs](/api/index.html#acls).
+
+| Blocking Queries | ACL Required |
+| ---------------- | -------------------- |
+| `NO` | `namespace:alloc-lifecycle` |
+
+### Parameters
+
+- `:alloc_id` `(string: )`- Specifies the UUID of the allocation. This
+ must be the full UUID, not the short 8-character one. This is specified as
+ part of the path.
+
+### Sample Request
+
+```text
+$ curl -X POST \
+ https://localhost:4646/v1/allocation/5456bd7a-9fc0-c0dd-6131-cbee77f57577/stop
+```
+
+### Sample Response
+
+```json
+{
+ "EvalID": "5456bd7a-9fc0-c0dd-6131-cbee77f57577",
+ "Index": 54
+}