Delete organisation (disabled)

DELETEhttps://app.speybooks.com/api/v1/admin/orgs/{id}

Hard deletion of an organisation is disabled (Item 93). This endpoint refuses and records the attempt.

Within the retention window, deactivate the organisation instead (see deactivateOrg), which is reversible and retains all data. After the window, erasure goes through the sanctioned routine (see eraseOrg), not this endpoint.

The legacy cascade this endpoint once performed deleted a hand-maintained subset of tables and could not complete once the schema grew foreign keys it did not account for. It is closed.

Records an ORG_HARD_DELETE_REFUSED action in the audit log. The organisation is left in place.

Path parameters

idstringrequired

Organisation ID.

Error codes

403Hard delete disabled. Use deactivate within the window, or the sanctioned erasure routine (POST /admin/orgs/:id/erase) after it.

RequestDELETE/v1/admin/orgs/{id}curl

curl -X DELETE https://api.speybooks.com/v1/admin/orgs/00000000-0000-0000-0000-000000000000 \
  -H "Authorization: Bearer <admin-token>"

Response403

{
  "success": false,
  "error": {
    "code": "HARD_DELETE_DISABLED",
    "message": "Hard deletion of an organisation is disabled. Within the retention window, deactivate the organisation (POST /admin/orgs/:id/deactivate). After the window, use the sanctioned erasure routine (POST /admin/orgs/:id/erase)."
  }
}