Merge 0a76482118 into 2a3841347e

changelogs/s2s: add minimum_valid_until_ts clarification
s2s/keys: clarify minimum_valid_until_ts query
2026-04-21 02:14:09 +02:00 · 2026-01-16 21:43:32 +00:00 · 2026-01-16 22:42:35 +01:00 · 2026-01-06 23:18:32 +01:00
2 changed files with 8 additions and 8 deletions
--- a/changelogs/server_server/newsfragments/2191.clarification
+++ b/changelogs/server_server/newsfragments/2191.clarification
@ -0,0 +1 @@
+Clarify what the `minimum_valid_until_ts` field means when it is set in key queries.
--- a/data/api/server-server/keys_query.yaml
+++ b/data/api/server-server/keys_query.yaml
@ -34,10 +34,10 @@ paths:
        - in: query
          name: minimum_valid_until_ts
          description: |-
-            A millisecond POSIX timestamp in milliseconds indicating when the returned
-            certificates will need to be valid until to be useful to the requesting server.
+            A millisecond POSIX timestamp. The returned keys SHOULD be valid
+            until at least this timestamp.

-            If not supplied, the current time as determined by the notary server is used.
+            If not supplied, the notary server MUST use the current time.
          required: false
          example: 1234567890
          schema:
@ -98,12 +98,11 @@ paths:
                          type: integer
                          format: int64
                          description: |-
-                            A millisecond POSIX timestamp in milliseconds indicating when
-                            the returned certificates will need to be valid until to be
-                            useful to the requesting server.
+                            A millisecond POSIX timestamp. The returned keys
+                            SHOULD be valid until at least this timestamp.

-                            If not supplied, the current time as determined by the notary
-                            server is used.
+                            If not supplied, the notary server MUST use the
+                            current time.
                          example: 1234567890
              required:
                - server_keys
Author	SHA1	Message	Date
famfo	fb98bd837b	Merge `0a76482118` into `2a3841347e`	2026-01-16 21:43:32 +00:00
famfo	0a76482118	changelogs/s2s: add minimum_valid_until_ts clarification	2026-01-16 22:42:35 +01:00
famfo	7f35431eb7	s2s/keys: clarify minimum_valid_until_ts query Signed-off-by: famfo <famfo@famfo.xyz>	2026-01-06 23:18:32 +01:00
				`@ -0,0 +1 @@`
				Clarify what the `minimum_valid_until_ts` field means when it is set in key queries.