Skip to main content
POST /api/v1/account-deletion Requires org.delete permission. The request is recorded and scheduled for processing — data is not removed immediately.
This action is irreversible once the request is processed. All organization data, including projects, environments, flags, and rules, will be permanently deleted on the scheduled date.

​
Request body

​
reason
string | null
Optional reason for the deletion request.

​
Response

​
request
object
required
The created deletion request.

​
Errors

StatusWhen
401Missing or invalid Bearer token
403Caller lacks org.delete permission

​
Example

curl -X POST http://localhost:8080/api/v1/account-deletion \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Switching to a different provider"}'

{
  "request": {
    "id": "d1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "organization_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "requested_by": "u1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "reason": "Switching to a different provider",
    "scheduled_for": "2026-04-21T00:00:00Z",
    "processed_at": null,
    "status": "requested",
    "created_at": "2026-03-21T10:00:00Z",
    "updated_at": "2026-03-21T10:00:00Z"
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us