Delete Organization

Developing

Develop Env

http://localhost:3000/api

DELETE

/orgs/{orgId}

organization

Maintainer:Abdelrhman Moataz

Purpose

Remove an organization (soft-delete). Use only in legal/ops flows.

##Auth / Scope

system:admin only. Deletion must be manually approved.

Headers

Authorization, X-Request-ID, Idempotency-Key recommended.

Query params

hard=false (soft-delete default). hard=true requires special flag & retention hold check.

Soft-delete marks org as deleted; data retention & legal holds still enforced accordingly.

Notes

Deletion creates audit event; if hard=true and org has legal holds, reject with 422.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200Success

application/json

Body

🟠404Not Found

🟠403Forbidden

🔴500Server Error

🟠429Too Many Requests

🟠409Bad Request

🟠422Parameter Error

🟢204No Content

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'http://localhost:3000/api/orgs/?orgId' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "status": "ok",
    "message": "Organiaztion deleted successfully",
    "data": {}
}

Modified at 2025-10-16 11:46:35

update settings

get organization settings

Delete Organization

Purpose#

Headers#