Delete User Permission

DELETE

/v2/api/user/{user_id}/permission

Overview

The Delete User Permission endpoint enables the removal of a user's association with a specific organization.
This operation is used to revoke a user’s access rights or roles within a particular organizational context.
Once deleted, the user will no longer have access to perform actions under that organization's scope.

Functionality

Accepts user_id as a path parameter to identify the user whose permission is to be revoked.

Requires a JSON request body specifying the organization_id from which the user’s permission should be removed.

Validates the existence of both user and organization before proceeding with the deletion.

If successful, returns:

Confirmation message

Details of the deleted user-organization relationship, including:

User ID

Organization details (name, domain)

Permission level removed

Metadata such as who granted the permission and when

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request DELETE 'https:///v2/api/user/0/permission' \
--header 'Ocp-Apim-Subscription-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "organization_id": 1
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "UserOrganization deleted successfully.",
    "data": {
        "id": 230,
        "organization": {
            "id": 2,
            "org_name": "Ejento",
            "domain": "ejento.ai"
        },
        "permission": "User",
        "created_by": "function-app@ejento.ai",
        "created_on": "2025-03-13T17:12:02.630262Z",
        "user": 191
    }
}

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successfully processed the delete request.

Body

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Edit User Permission

Email Authorize

Delete User Permission

Overview#

Functionality#

Request

Responses

Overview

Functionality