---
title: "What deleting the project does: its previews, attached databases, data on the server and the backup copy kept afterwards"
method: GET
path: "/projects/{projectId}/deletion-impact"
tags: ["Projects"]
---

# What deleting the project does: its previews, attached databases, data on the server and the backup copy kept afterwards

`GET /projects/{projectId}/deletion-impact`

## Request

- Base URL: `https://hostingsurge.com/api/v1`
- URL: `https://hostingsurge.com/api/v1/projects/{projectId}/deletion-impact`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-hs_session`

## Path parameters

- `projectId` string, uuid, required

## Response `200`

Deletion impact

- object
  - `projectId` string, uuid, required
  - `name` string, required
  - `kind` 'app' | 'static' | 'wordpress' | 'service', required
  - `previews` integer, required: active preview deployments, removed with the project
  - `domains` integer, required: domains of the project that are released
  - `volumes` integer, required: persistent volumes of the project
  - `databases` object[], required: databases attached to the project: they stay (detached) unless listed in deleteDatabases
    - `id` string, uuid, required
    - `name` string, required
    - `engine` 'postgresql' | 'mysql' | 'mariadb' | 'redis' | 'mongodb', required
    - `canDelete` boolean, required: the caller may delete it with the project (databases:write)
  - `hasData` boolean, required: the project has data on the server (a one-click app, a WordPress site or volumes)
  - `finalBackup` object, required
    - `enabled` boolean, required: false: no backup copy of the project is kept after deletion (the server has not enabled it)
    - `keptDays` integer, required: how long the single backup copy is kept, for disaster recovery only
    - `includesData` boolean, required: the copy also holds the data of the project (files, volumes, embedded database dumps)

## Other responses

- `400`: Invalid request (code invalid_request)
- `401`: Missing or invalid session/token (code unauthorized)
- `403`: Authenticated but not permitted (code forbidden)
- `404`: Not found or not visible to the caller (code not_found)
- `409`: Conflicting state (code conflict)
- `429`: Too many requests (code rate_limited); see Retry-After
- `503`: Hosting engine unavailable (code provider_unavailable)

---

[API](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api.md) · [All operations](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api/revisions/4d08337cdff1?raw)