/projects/{project_id}/recoverRecover a deleted projectRecovers a deleted project within the 7-day deletion recovery period. Restores branches, endpoints, settings, and connection strings. Some integrations require manual reconfiguration after recovery. To list recoverable projects, use GET /projects?recoverable=true.
Parameters
project_idstringpathrequiredThe Neon project ID
Responses
allOf · 2 options
projectobjectrequiredShow child attributes
active_time_secondsinteger · int64requiredSeconds. Control plane observed endpoints of this project being active this amount of wall-clock time. The value has some lag. The value is reset at the beginning of each billing period.
branch_logical_size_limitinteger · int64requiredThe logical size limit for a branch. The value is in MiB.
branch_logical_size_limit_bytesinteger · int64requiredThe logical size limit for a branch. The value is in B.
compute_last_active_atstring · date-timeThe most recent time when any endpoint of this project was active. Omitted when observed no activity for endpoints of this project.
compute_time_secondsinteger · int64requiredSeconds. The number of CPU seconds used by the project's compute endpoints, including compute endpoints that have been deleted. The value has some lag. The value is reset at the beginning of each billing period. Examples: 1. An endpoint that uses 1 CPU for 1 second is equal to `compute_time=1`. 2. An endpoint that uses 2 CPUs simultaneously for 1 second is equal to `compute_time=2`.
consumption_period_endstring · date-timerequiredA date-time indicating when Neon Cloud plans to stop measuring consumption for current consumption period.
consumption_period_startstring · date-timerequiredA date-time indicating when Neon Cloud started measuring consumption for current consumption period.
cpu_used_secinteger · int64requiredDeprecated. Use `compute_time_seconds` instead.
created_atstring · date-timerequiredA timestamp indicating when the project was created
creation_sourcestringrequiredThe project creation source
data_storage_bytes_hourinteger · int64requiredBytes-Hour. Project consumed that much Postgres storage hourly during the billing period. The value has some lag. The value is reset at the beginning of each billing period.
data_transfer_bytesinteger · int64requiredBytes. Egress traffic from the Neon cloud to the client for given project over the billing period. Includes deleted endpoints. The value has some lag. The value is reset at the beginning of each billing period.
default_endpoint_settingsobjectA collection of settings for a Neon endpoint
Show child attributes
autoscaling_limit_max_cunumberautoscaling_limit_min_cunumberpg_settingsobjectA raw representation of Postgres settings
pgbouncer_settingsobjectDeprecated. A raw representation of PgBouncer settings. Removal scheduled for June 20, 2026.
suspend_timeout_secondsinteger · int64Duration of inactivity in seconds after which the compute endpoint is automatically suspended. The value `0` means use the default value. The value `-1` means never suspend. The default value is `300` seconds (5 minutes). The minimum value is `60` seconds (1 minute). The maximum value is `604800` seconds (1 week). For more information, see [Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).
effective_project_permissionvalueShow child attributes
anyOf · 2 options
allOf · 1 option
The caller's effective permission for a project when per-project permissions are enabled. `VIEWER` grants read access, `EDITOR` adds update access, and `ADMIN` grants full management. Omitted for personal projects, flag-off organizations, and non-user subjects.
hipaa_enabled_atstring · date-timeA timestamp indicating when HIPAA was enabled for this project
history_retention_secondsinteger · int32requiredThe number of seconds to retain the shared history for all branches in this project.
idstringrequiredThe Neon project ID. Use as the `project_id` path parameter in other endpoints.
maintenance_scheduled_forstring · date-timeA timestamp indicating when project update begins. If set, computes might experience a brief restart around this time.
maintenance_starts_atstring · date-timeA timestamp indicating when project maintenance begins. If set, the project is placed into maintenance mode at this time.
namestringrequiredThe project name
org_idstringThe Neon organization ID. Returned as `id` from `GET /users/me/organizations`.
ownerobjectShow child attributes
branches_limitintegerrequiredMaximum number of branches the owner is allowed to create across their projects.
emailstring · emailrequiredEmail address of the project owner.
namestringrequiredDisplay name of the project owner.
subscription_typestringrequiredType of subscription to Neon Cloud. Notice that for users without billing account this will be "UNKNOWN"
owner_idstringrequiredID of the organization that owns the project.
pg_versionintegerrequiredThe major Postgres version number. Supported versions are `14`, `15`, `16`, `17`, and `18`. `19` is rolling out and is accepted only in regions where it is enabled; requesting it elsewhere returns an error.
platform_idstringrequiredThe cloud platform identifier. Currently, only AWS is supported, for which the identifier is `aws`.
provisionerstringrequiredproxy_hoststringrequiredThe proxy host for the project. This value combines the `region_id`, the `platform_id`, and the Neon domain (`neon.tech`).
quota_reset_atstring · date-timeDeprecated. Use the `consumption_period_end` field instead. A timestamp indicating when the project quota resets.
region_idstringrequiredCloud region where the resource's Postgres compute and storage reside (for example, `aws-us-east-1`). Valid values are returned by `GET /regions`.
settingsobjectShow child attributes
allowed_ipsobjectA list of IP addresses that are allowed to connect to the compute endpoint. If the list is empty or not set, all IP addresses are allowed. If protected_branches_only is true, the list will be applied only to protected branches.
Show child attributes
ipsarray of stringA list of IP addresses that are allowed to connect to the endpoint.
Show child attributes
protected_branches_onlybooleanIf true, the list will be applied only to protected branches.
audit_log_levelstringblock_public_connectionsbooleanWhen set, connections from the public internet are disallowed. This supersedes the AllowedIPs list. This parameter is under active development and its semantics may change in the future.
block_vpc_connectionsbooleanWhen set, connections using VPC endpoints are disallowed. This parameter is under active development and its semantics may change in the future.
enable_logical_replicationbooleanSets wal_level=logical for all compute endpoints in this project. All active endpoints will be suspended. Once enabled, logical replication cannot be disabled.
hipaabooleanEnables HIPAA compliance mode for the project, including audit logging.
maintenance_windowobjectA maintenance window is a time period during which Neon may perform maintenance on the project's infrastructure. During this time, the project's compute endpoints may be unavailable and existing connections can be interrupted.
Show child attributes
end_timestringrequiredEnd time of the maintenance window, in the format of "HH:MM". Uses UTC.
start_timestringrequiredStart time of the maintenance window, in the format of "HH:MM". Uses UTC.
weekdaysarray of integerrequiredA list of weekdays when the maintenance window is active. Encoded as ints, where 1 - Monday, and 7 - Sunday.
Show child attributes
preload_librariesobjectThe shared libraries to preload into the project's compute instances.
Show child attributes
enabled_librariesarray of stringNames of shared preload libraries to enable for the project.
Show child attributes
use_defaultsbooleanWhen true, the project's preload libraries include the platform default set in addition to any libraries listed in `enabled_libraries`.
quotaobjectPer-project consumption quotas. If a quota is exceeded, all active computes are automatically suspended and cannot be started via API calls or incoming connections. The exception is `logical_size_bytes`, which is enforced per branch. If a branch exceeds its `logical_size_bytes` quota, computes can still be started, but write operations will fail—allowing data to be deleted to free up space. Computes on other branches are not affected. Setting `logical_size_bytes` overrides any lower value set by the `neon.max_cluster_size` Postgres setting. Quotas are enforced using per-project consumption metrics with the same names. These metrics reset at the start of each billing period. `logical_size_bytes` is also an exception—it reflects the total data stored in a branch and does not reset. A zero or empty quota value means “unlimited.”
Show child attributes
active_time_secondsinteger · int64The total amount of wall-clock time allowed to be spent by the project's compute endpoints.
compute_time_secondsinteger · int64The total amount of CPU seconds allowed to be spent by the project's compute endpoints.
data_transfer_bytesinteger · int64Total amount of data transferred from all of a project's branches using the proxy.
logical_size_bytesinteger · int64Limit on the logical size of every project's branch. If a branch exceeds its `logical_size_bytes` quota, computes can still be started, but write operations will fail—allowing data to be deleted to free up space. Computes on other branches are not affected. Setting `logical_size_bytes` overrides any lower value set by the `neon.max_cluster_size` Postgres setting.
written_data_bytesinteger · int64Total amount of data written to all of a project's branches.
store_passwordsbooleanrequiredWhether or not passwords are stored for roles in the Neon project. Storing passwords facilitates access to Neon features that require authorization.
synthetic_storage_sizeinteger · int64The current space occupied by the project in Postgres storage, in bytes. Synthetic Postgres storage size combines the logical data size and Write-Ahead Log (WAL) size for all branches in a project.
updated_atstring · date-timerequiredA timestamp indicating when the project was last updated
written_data_bytesinteger · int64requiredBytes. Amount of WAL that travelled through Postgres storage for given project across all branches. The value has some lag. The value is reset at the beginning of each billing period.
branchesarray of objectrequiredBranches in the project. Each includes `id`, `name`, `current_state`, and `created_at`.
Show child attributes
Show array items
active_time_secondsinteger · int64requiredTotal time this branch's compute has been active during the current billing period, in seconds (not weighted by compute size). Distinct from `compute_time_seconds`, which is CU-weighted.
compute_time_secondsinteger · int64requiredTotal Postgres compute time consumed by this branch during the current billing period, in CU-seconds (weighted by compute size). Divide by 3600 for CU-hours.
cpu_used_secinteger · int64requiredDeprecated. Use `compute_time_seconds` instead. CPU seconds used by all of the branch's compute endpoints, including deleted ones. This value is reset at the beginning of each billing period.
created_atstring · date-timerequiredA timestamp indicating when the branch was created
created_byobjectThe resolved user model that contains details of the user/org/integration/api_key used for branch creation. This field is filled only in listing/get/create/get/update/delete methods, if it is empty when calling other handlers, it does not mean that it is empty in the system.
Show child attributes
imagestringThe URL to the user's avatar image.
namestringDisplay name of the user who created the branch.
creation_sourcestringrequiredThe branch creation source
current_statestringrequiredThe branch’s state, indicating if it is initializing, ready for use, or archived. * 'init' - the branch is being created but is not available for querying. * 'resetting' - the branch is being reset to a specific point in time or LSN and is not yet available for querying. * 'ready' - the branch is fully operational and ready for querying. Expect normal query response times. * 'archived' - the branch is stored in cost-effective archival Postgres storage. Expect slow query response times.
data_transfer_bytesinteger · int64requiredTotal data transferred out of the branch, in bytes. Used as a consumption metric.
defaultbooleanrequiredWhether the branch is the project's default branch
expires_atstring · date-timeThe timestamp when the branch is scheduled to expire and be automatically deleted. Must be set by the client following the [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6) format with precision up to seconds (such as 2025-06-09T18:02:16Z). Deletion is performed by a background job and may not occur exactly at the specified time. Access to this feature is currently limited to participants in the Early Access Program.
idstringrequiredThe branch ID. This value is generated when a branch is created. A `branch_id` value has a `br` prefix. For example: `br-small-term-683261`.
init_sourcestringSource of initialization for the branch. `parent-data` (default) copies schema and data from the parent. `parent-schema` copies schema only from the parent. `schema-only` creates a root branch with schema only. `import` initializes from an external import.
last_reset_atstring · date-timeA timestamp indicating when the branch was last reset
logical_sizeinteger · int64The logical size of the branch, in bytes
namestringrequiredThe branch name
parent_idstringThe `branch_id` of the parent branch
parent_lsnstringThe Log Sequence Number (LSN) on the parent branch from which this branch was created. When restoring a branch using the `POST /projects/{project_id}/branches/{branch_id}/restore` endpoint, this value isn’t finalized until all operations related to the restore have completed successfully.
parent_timestampstring · date-timeThe point in time on the parent branch from which this branch was created. When restoring a branch using the `POST /projects/{project_id}/branches/{branch_id}/restore` endpoint, this value isn’t finalized until all operations related to the restore have completed successfully. After all the operations completed, this value might stay empty.
pending_statestringThe branch’s state, indicating if it is initializing, ready for use, or archived. * 'init' - the branch is being created but is not available for querying. * 'resetting' - the branch is being reset to a specific point in time or LSN and is not yet available for querying. * 'ready' - the branch is fully operational and ready for querying. Expect normal query response times. * 'archived' - the branch is stored in cost-effective archival Postgres storage. Expect slow query response times.
primarybooleanDeprecated. Use the `default` field. Whether the branch is the project's primary branch.
project_idstringrequiredThe ID of the project this branch belongs to.
protectedbooleanrequiredWhether the branch is protected. Protected branches (and their computes) cannot be deleted, archived, or reset, and block deletion of the project.
recoveryobjectRecovery information for a deleted branch. Only present when listing deleted branches with `include_deleted=true`. This is part of the Branch Recovery feature, which is in preview and not available to all users.
Show child attributes
deleted_atstring · date-timerequiredTimestamp when the branch was deleted
deletion_methodstringrequiredHow the branch was deleted: 'user' for manual deletion, 'ttl' for TTL expiration
recoverable_untilstring · date-timerequiredTimestamp when the recovery window expires and the branch will be permanently deleted
restore_statusstringCould be `restored`, `finalized` or `detaching`. A `restored` branch becomes permanently `finalized` when you call `finalizeRestoreBranch` A `restored` or `finalized` branch may begin `detaching` as a one-time performance optimisation, after which it will continue in its original state
restored_asstringID of the target branch which was replaced when this branch was restored
restored_fromstringID of the snapshot that was the restore source for this branch
restricted_actionsarray of objectA list of actions that are currently restricted for this branch and the reason why.
Show child attributes
Show array items
An action that is currently restricted for the branch and the reason why.
namestringrequiredThe name of a restricted action on a branch. `restore`: the branch cannot be used as a restore target. `delete-rw-endpoint`: the read-write endpoint for the branch cannot be deleted.
reasonstringrequiredA human-readable explanation of why the action is restricted.
state_changed_atstring · date-timerequiredA UTC timestamp indicating when the `current_state` began
ttl_interval_secondsintegerThe time-to-live (TTL) duration originally configured for the branch, in seconds. This read-only value represents the interval between the time `expires_at` was set and the expiration timestamp itself. It is preserved to ensure the same TTL duration is reapplied when resetting the branch from its parent, and only updates when a new `expires_at` value is set. Access to this feature is currently limited to participants in the Early Access Program.
updated_atstring · date-timerequiredA timestamp indicating when the branch was last updated
written_data_bytesinteger · int64requiredData written by this branch during the current billing period, in bytes.
{
"branches": [
{
"active_time_seconds": 922200,
"compute_time_seconds": 823880990,
"cpu_used_sec": 461100,
"created_at": "2022-11-30T19:09:48Z",
"creation_source": "console",
"current_state": "ready",
"data_transfer_bytes": 72911987,
"default": true,
"id": "br-wispy-meadow-118737",
"init_source": "parent-data",
"name": "dev2",
"parent_id": "br-aged-salad-637688",
"parent_lsn": "0/1DE2850",
"project_id": "spring-example-302709",
"protected": false,
"state_changed_at": "2022-11-30T20:09:48Z",
"updated_at": "2022-12-01T19:53:05Z",
"written_data_bytes": 542998300
}
],
"project": {
"active_time_seconds": 621440,
"branch_logical_size_limit": 10,
"branch_logical_size_limit_bytes": 10485760,
"compute_time_seconds": 2485760,
"consumption_period_end": "2022-12-01T00:00:00Z",
"consumption_period_start": "2022-11-01T00:00:00Z",
"cpu_used_sec": 155350,
"created_at": "2022-12-13T01:30:55Z",
"creation_source": "console",
"data_storage_bytes_hour": 2831928,
"data_transfer_bytes": 1000,
"history_retention_seconds": 604800,
"id": "spring-example-302709",
"name": "spring-example-302709",
"org_id": "org-morning-bread-81040908",
"owner": {
"branches_limit": 10,
"email": "some@email.com",
"name": "John Smith",
"subscription_type": "scale"
},
"owner_id": "629982cc-de05-43db-ae16-28f2399c4910",
"pg_version": 15,
"platform_id": "aws",
"provisioner": "k8s-pod",
"proxy_host": "us-east-2.aws.neon.tech",
"region_id": "aws-us-east-2",
"store_passwords": true,
"updated_at": "2022-12-13T01:30:55Z",
"written_data_bytes": 193990002
}
}codestringrequiredmessagestringrequiredError message
request_idstringUnique identifier for the request, useful for debugging. You can set this value manually by including an `X-Request-ID` header in the request. If not provided, the value will be generated automatically.
{
"code": "",
"message": "string",
"request_id": "string"
}