---
title: "Delete User Account"
method: DELETE
path: "/api/v1/profile/delete"
tags: ["Profile"]
---

# Delete User Account

`DELETE /api/v1/profile/delete`

## Request

- Base URL: `https://api.gemstoneaiapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemstoneaiapp.com/api/v1/profile/delete`
- Auth: HTTP bearer

DELETE /api/v1/profile/delete
Permanently delete user account and ALL associated data (HARD DELETE).

This endpoint performs a complete deletion of:
- User account
- All gemstones and their images
- Physical image files from storage
- Subscription rows are detached, not deleted: user_id goes NULL and only
  store/billing facts and the numeric RevenueCat id remain (LNK-SUBKEEP)
- All OTP records

⚠️ WARNING: This action is IRREVERSIBLE. All data will be permanently deleted.

Returns:
    UserDeletionResponse with deletion statistics

Raises:
    HTTPException 404: User not found
    HTTPException 500: Deletion failed

## Headers

- `X-Apple-Authorization-Code` string, nullable

## Response `200`

Successful Response

- UserDeletionResponse: Response for user data deletion
  - `success` boolean, required
  - `message` string, required
  - `user_id` integer, required
  - `stats_before_deletion` object, required
  - `deleted_counts` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api.md) · [All operations](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/revisions/fcb441f55161?raw)