Backport PR #4677: Improve validation, docs for token.expires_in

2025-10-17 23:13:00 +00:00 · 2024-01-25 00:19:33 +01:00
parent ee9e509ab5
commit 5e57e0141a
3 changed files with 23 additions and 3 deletions
--- a/docs/source/_static/rest-api.yml
+++ b/docs/source/_static/rest-api.yml
@@ -562,9 +562,10 @@ paths:
              properties:
                expires_in:
                  type: number
+                  example: 3600
                  description:
                    lifetime (in seconds) after which the requested token
-                    will expire.
+                    will expire. Omit, or specify null or 0 for no expiration.
                note:
                  type: string
                  description: A note attached to the token for future bookkeeping