Sign in

9e3fcdb7f087

latestOpenAPI 3.0.1Apache 2.02026-08-1198173136.1 KB
Postgres Clusters

Restore Backup or Point in Time to New Cluster

Restore a backup, or a point in time within the cluster's PITR recovery window, into a new Managed Postgres cluster. The source cluster is left unchanged, and a new cluster is provisioned asynchronously.

post/postgres/{postgres_cluster_id}/restore

Path parameters

postgres_cluster_idstring required

Managed Postgres Cluster ID

Request body

backup_idstring

Backup label to restore from, as returned by the backups list. Mutually exclusive with pitr_time.

namestring

Name for the restored cluster. Defaults to a generated name derived from the source cluster and backup/point in time when omitted or blank.

pitr_timestring

Point in time to restore to, as an RFC3339 timestamp with an explicit offset from UTC (e.g. Z or +02:00). Normalized to UTC and must fall within the cluster's PITR recovery window. Mutually exclusive with backup_id.

Response

New cluster provisioned from the backup or point in time

Example response

{
  "data": {
    "cpu_kind": "shared",
    "cpus": 2,
    "disk_size_gb": 10,
    "memory_mb": 1024,
    "pg_major_version": "17",
    "plan": "basic",
    "region": "iad",
    "replicas": 1,
    "status": "ready"
  }
}