9.20 will get API item status

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>

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