From 6ef3c03d079c8e45c06246959eedb1b7f251e700 Mon Sep 17 00:00:00 2001
From: Matthieu Bronner <matthieu.bronner@scalingo.com>
Date: Thu, 13 Aug 2026 11:37:31 +0200
Subject: [PATCH] Document new pitr/recovery_window endpoint

---
 _database_api/databases.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/_database_api/databases.md b/_database_api/databases.md
index 80953c6f..f4ad73a7 100644
--- a/_database_api/databases.md
+++ b/_database_api/databases.md
@@ -284,6 +284,38 @@ Headers:
 ```
 
 
+--- row ---
+
+## Recovery window for Point-in-Time Restoration
+
+--- row ---
+
+`GET https://$DB_API_URL/api/databases/[:db_id]/pitr/recovery_window`
+
+Fetch the recovery window for a given database, to then use the restore endpoint. This is currently only
+available for PostgreSQL databases.
+
+||| col |||
+
+Example request
+
+```shell
+curl -H "Accept: application/json" -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $DB_BEARER_TOKEN" \
+  -X GET https://$DB_API_URL/api/databases/my-db-123/pitr/recovery_window
+```
+
+Returns 200 OK
+
+```json
+{
+  "recovery_window": {
+    "earliest_recoverable_at": "2026-04-23T08:00:00Z",
+    "latest_recoverable_at": "2026-04-30T22:00:00Z"
+  }
+}
+```
+
 --- row ---
 
 ## Point-in-Time Restoration