---
title: "Preview project deletion"
method: GET
path: "/api/v1/me/profiles/{profileId}/deletion-preview"
tags: ["Profiles"]
---

# Preview project deletion

`GET /api/v1/me/profiles/{profileId}/deletion-preview`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/me/profiles/{profileId}/deletion-preview`
- Auth: one of:
  - API key in cookie `auth_token`
  - HTTP bearer

What `DELETE /me/profiles/{profileId}` would do — the Delete project dialog's counts and the named successor — or why it is refused (`allowed: false`). Changes nothing.

## Path parameters

- `profileId` string, required: Profile ID

## Response `200`

The counts, the main-project rule, and the successor

- ProjectDeletionPreview
  - `allowed` boolean, required
  - `blocked` object, nullable, required
    - `code` 'last_project', required
    - `message` string, required
  - `project` object, required
    - `id` string, required
    - `name` string, required
    - `is_primary` boolean, required
    - `username` string, nullable, required
  - `counts` object, required
    - `api_keys` integer, required: Live keys that would be revoked.
    - `hitl_own` integer, required: Approval setups provably the project's own — archived.
    - `hitl_default_linked` integer, required: Approval setups linked only because the project was the primary — detached, or archived with `archive_default_linked`.
    - `confirmations_pending` integer, required: Pending confirmations under the setups that would be archived — declined by the system.
    - `authorizations` integer, required: Consents under the setups that would be archived — revoked.
    - `requests_pending_own` integer, required: Pending requests provably the project's own — cancelled.
    - `requests_pending_default_linked` integer, required: Pending requests linked only by default — detached, or cancelled with `archive_default_linked`.
    - `requests_history` integer, required: Finished requests that stay as history, link removed.
    - `verifications` integer, required
    - `domains` integer, required
    - `circles` integer, required
    - `templates` integer, required: Project message templates — deleted.
  - `new_primary` object, nullable, required: Named when the deleted project is (or was) the primary: the OLDEST remaining project takes over, and messages sent without choosing a project carry its name.
    - `id` string, required
    - `name` string, required

## Other responses

- `403`: `account_key_required` — a key bound to one sub-account previews only its own sub-account; what another one holds needs an account-wide key or the dashboard.
- `404`: Profile not found

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/6b8d61ee354f?raw)