Add note about removed flagging feature

freedomofpress · Jun 17, 2021 · dc5a73c · dc5a73c
1 parent 78ad67d
commit dc5a73c
Showing 1 changed file with 18 additions and 0 deletions.
diff --git a/docs/development/journalist_api.rst b/docs/development/journalist_api.rst
@@ -776,3 +776,21 @@ response body:
 
 None of the requested items will be marked seen if any of them cannot
 be found.
+
+
+Removed functionality
+~~~~~~~~~~~~~~~~~~~~~
+
+Flagging sources
+----------------
+
+Previous versions of the API supported flagging sources for reply, which would
+generate a reply keypair for the source upon their next login. This
+functionality was removed in SecureDrop 2.0.0.
+
+The ``/api/v1/sources/<source_uuid>/flag`` endpoint (``POST``) and the
+``is_flagged`` property for sources are retained for backwards compatibility,
+but no longer function. ``is_flagged`` is always ``false``.
+
+The endpoint and the ``is_flagged`` property will be fully removed from the API
+in a future release.