Delete Organization

Deletes the main organization and all its sub-organizations. Only organizations with no members can be deleted. Ensure all members and admins are removed from the organization and its sub-organizations before proceeding. Deletion is irreversible.

HTTP Method and URL

DELETE
{{host}}/api/v2/organizations?user_type=ENTERPRISE_API

Authentication Requirements

Requires a valid user token in the request headers.

Path and Query Parameters

• user_type (query, required): Must be set to ENTERPRISE_API.

Request Body

This endpoint does not require a request body.

Example Request

plaintextDELETE {{host}}/api/v2/organizations?    user_type=ENTERPRISE_APIHeaders:  Authorization: Bearer {USER-TOKEN}

Example Successful Response

json{    "status": "success",    "message": "Organization and all         sub-organizations deleted         successfully."}

Error Responses

• 400 Bad Request: Organization still has members or admins.

• 401 Unauthorized: Authentication failed or missing token.

• 403 Forbidden: User does not have permission to delete the organization.

• 404 Not Found: Organization not found.

Usage Notes

• Deletion is permanent and cannot be undone.

• All sub-organizations will also be deleted.

• Remove all members and admins before attempting deletion.