From f4fd1529ca35c75b070849f29d38e05f0d8e01bb Mon Sep 17 00:00:00 2001
From: Jean-Paul Calderone <exarkun@twistedmatrix.com>
Date: Tue, 25 Feb 2020 14:16:24 -0500
Subject: [PATCH] Document the changes to the interface

---
 docs/source/interface.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/source/interface.rst b/docs/source/interface.rst
index e790bd8..2c5e990 100644
--- a/docs/source/interface.rst
+++ b/docs/source/interface.rst
@@ -117,4 +117,14 @@ This endpoint accepts no request body.
 
 The response is **OK** with ``application/json`` content-type response body like::
 
-  {"total": <integer>, "unblinded-tokens": [<unblinded token string>, ...]}
+  { "total": <integer>
+  , "unblinded-tokens": [<unblinded token string>, ...]
+  , "lease-maintenance-spending": <spending object>
+  }
+
+The ``<spending object>`` may be ``null`` if the lease maintenance process has never run.
+If it has run,
+``<spending object>`` has two properties:
+
+ * ``when``: associated with an ISO8601 datetime string giving the approximate time the process ran
+ * ``count``: associated with a number giving the number of passes which would need to be spent to renew leases on all stored objects seen during the lease maintenance activity
-- 
GitLab