From be18260a3ba571bf615e0ab62cf8d9271aec380b Mon Sep 17 00:00:00 2001
From: AndrewDonkin-Gallagher
 <66979641+AndrewDonkin-Gallagher@users.noreply.github.com>
Date: Fri, 1 Nov 2024 14:23:42 +1300
Subject: [PATCH] 9.20 will get API item status

---
 ref/rest.html        | 7 ++++++-
 swagger/restApi.yaml | 4 ++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/ref/rest.html b/ref/rest.html
index da9011b..6bc1a04 100644
--- a/ref/rest.html
+++ b/ref/rest.html
@@ -378,7 +378,12 @@ <h4 id="changes-in-930">Changes in 9.30</h4>
                 </ul>
                 <h4 id="changes-in-920">Changes in 9.20</h4>
                 <ul>
-                  <li>You can filter by items&#39; direct division. The current division search is recursive: it returns all items that have any of the filter&#39;s divisions anywhere in their ancestry. The new division search is shallow: it only returns items that are direct members of the filter&#39;s divisions.</li>
+                  <li>
+                    <p>In a future patch release of 9.20, an API client will be able to switch its own status between <code>normal</code> and <code>faulty</code> and set arbitrary status text. Marking the item as faulty will raise an alarm in Command Centre.</p>
+                  </li>
+                  <li>
+                    <p>You can filter by items&#39; direct division. The current division search is recursive: it returns all items that have any of the filter&#39;s divisions anywhere in their ancestry. The new division search is shallow: it only returns items that are direct members of the filter&#39;s divisions.</p>
+                  </li>
                 </ul>
                 <h4 id="changes-in-880">Changes in 8.80</h4>
                 <ul>
diff --git a/swagger/restApi.yaml b/swagger/restApi.yaml
index 5ef78b3..6bcb06d 100644
--- a/swagger/restApi.yaml
+++ b/swagger/restApi.yaml
@@ -69,6 +69,10 @@ info:
 
     #### Changes in 9.20
 
+    * In a future patch release of 9.20, an API client will be able to switch its own status between
+      `normal` and `faulty` and set arbitrary status text.  Marking the item as faulty will raise an
+      alarm in Command Centre.
+
     * You can filter by items' direct division.  The current division search is recursive:  it
       returns all items that have any of the filter's divisions anywhere in their ancestry.  The new
       division search is shallow:  it only returns items that are direct members of the filter's