Add documentation for new backup and restore cloud API endpoints

src/current/_includes/cockroachcloud/backups/cloud-api-get-put.md → src/current/_includes/cockroachcloud/backups/cloud-api-backup-settings.md

@@ -1,9 +1,3 @@
-You can use the [CockroachDB Cloud API]({% link cockroachcloud/cloud-api.md %}) to [view](#get-information-on-backup-settings) and [modify](#modify-backup-settings-on-a-cluster) managed backup settings.
-
-{{site.data.alerts.callout_info}}
-The [service account]({% link cockroachcloud/authorization.md %}#service-accounts) associated with the secret key must have the [Cluster Admin]({% link cockroachcloud/authorization.md %}#cluster-admin) role.
-{{site.data.alerts.end}}
-
 ### Get information on backup settings
 
 To retrieve information about a specific cluster, make a `GET` request to the `/v1/clusters/{cluster_id}/backups/config` endpoint.
@@ -20,7 +14,7 @@ Set the following:
 - `{cluster_id}` is the unique ID of the cluster. Use this ID when making API requests. You can find the cluster ID in the cluster's Cloud Console page. Find your cluster ID in the URL of the single cluster overview page: `https://cockroachlabs.cloud/cluster/{your_cluster_id}/overview`. The ID should resemble `f78b7feb-b6cf-4396-9d7f-494982d7d81e`.
 - `{secret_key}` is your API key. Refer to [API Access]({% link cockroachcloud/managing-access.md %}#api-access) for more details.
 
-If the request was successful, the API will return details about the managed backup settings:
+If the request is successful, the API will return details about the managed backup settings:
 
 ~~~json
 {
@@ -59,7 +53,7 @@ Set the following:
 - `{frequency_minutes}` determines [how often](#frequency) the managed backup will run in minutes. Possible values are: `5`, `10`, `15`, `30`, `60`, `240` (4 hours), `1440` (24 hours).
 - `{retention_days}` sets the number of days Cockroach Labs will [retain](#retention) the managed backup in storage. You can change `retention_days` for the cluster **once** (whether in the Cloud API or [Cloud Console](#cloud-console)). Possible values are: `2`, `7`, `30`, `90`, `365`.
 
-    If `{retention_days}` has previously been modified (in the Cloud API or Cloud Console), you will receive the message "cluster already has a retention policy set, open a support ticket to change it". To modify the setting again, contact the [Cockroach Labs Support team]({% link {{site.current_cloud_version}}/support-resources.md %}).
+    If `{retention_days}` has previously been modified (in the Cloud API or Cloud Console), you receive the message "cluster already has a retention policy set, open a support ticket to change it". To modify the setting again, contact the [Cockroach Labs Support team]({% link {{site.current_cloud_version}}/support-resources.md %}).
 - `{secret_key}` is your API key. Refer to [API Access]({% link cockroachcloud/managing-access.md %}#api-access) for more details.
 
-If the request was successful, the client will receive an empty HTTP 200 OK status response.
+If the request is successful, the client recieves an empty HTTP 200 OK status response.

src/current/_includes/cockroachcloud/backups/cloud-api-backup-view.md

@@ -0,0 +1,43 @@
+### View managed backups
+
+{{site.data.alerts.callout_info}}
+{% include feature-phases/limited-access.md %}
+{{site.data.alerts.end}}
+
+To view a list of managed backups on a cluster with timestamps and their respective IDs, send a `GET` request to the `/v1/clusters/{cluster_id}/backups` endpoint:
+
+{% include_cached copy-clipboard.html %}
+~~~ shell
+curl --request GET \
+--url https://cockroachlabs.cloud/api/v1/clusters/{cluster_id}/backups \
+--header 'Authorization: Bearer {secret_key}' \
+~~~
+
+If the request is successful, the client recieves a JSON response listing backups with their unique `{id}`. The `{as_of_time}` timestamp describes the system time of the cluster when the backup was created:
+
+~~~ json
+{
+  "backups": [
+    {
+      "id": "example-157a-4b04-8f72-3179369a50d9",
+      "as_of_time": "2025-07-25T15:45:00Z"
+    },
+    {
+      "id": "example-c090-429c-9f84-2b1297f5de89",
+      "as_of_time": "2025-07-25T15:35:32Z"
+    },
+    {
+      "id": "example-4e41-44ec-926a-0cc368efdea2",
+      "as_of_time": "2025-07-25T15:00:00Z"
+    },
+    {
+      "id": "example-3c67-4822-b7b9-90c2d8cc06a3",
+      "as_of_time": "2025-07-25T14:56:15Z"
+    },
+    {
+      "id": "example-abef-4191-aa98-36a019da97c2",
+      "as_of_time": "2025-07-25T14:52:05.637170Z"
+    }
+  ],
+  "pagination": null
+~~~

src/current/_includes/cockroachcloud/backups/cloud-api-managed-backup-intro.md

@@ -0,0 +1,11 @@
+{% if page.name == "managed-backups-basic.md" %}
+You can use the [CockroachDB Cloud API]({% link cockroachcloud/cloud-api.md %}) to [view managed backups](#view-managed-backups) or [restore clusters](#restore-from-a-managed-backup) from a managed backup.
+{% else if page.name == "managed-backups.md"  %}
+You can use the [CockroachDB Cloud API]({% link cockroachcloud/cloud-api.md %}) to [view](#get-information-on-backup-settings) and [modify managed backup settings](#modify-backup-settings-on-a-cluster), [view managed backups](#view-managed-backups), or [restore clusters](#restore-from-a-managed-backup) from a managed backup.
+{% else %}
+You can use the [CockroachDB Cloud API]({% link cockroachcloud/cloud-api.md %}) to [view](#get-information-on-backup-settings) and [modify managed backup settings](#modify-backup-settings-on-a-cluster), [view managed backups](#view-managed-backups), or [restore clusters/databases/tables](#restore-from-a-managed-backup) from a managed backup.
+{% endif %}
+
+{{site.data.alerts.callout_info}}
+The [service account]({% link cockroachcloud/authorization.md %}#service-accounts) associated with the secret key must have the [Cluster Admin]({% link cockroachcloud/authorization.md %}#cluster-admin) role.
+{{site.data.alerts.end}}