Edit User Permission

PUT

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

Overview

The Edit User Permission endpoint enables administrators or system users to modify the active organization associated with a specific user.
The active organization defines the environment in which the user is authenticated and authorized to perform actions.
This operation is particularly useful when users change projects, or roles that require association with a different organization.

Functionality

Accepts a user_id as a path parameter to identify the user whose active organization needs to be updated.

Requires a request body containing the organization_id of the new organization to which the user should be assigned.

Upon successful update, returns comprehensive details about:

The user (e.g., ID, email, name, privileges, and account status)

The new organization (e.g., name, domain, metadata, creation and modification info)

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "success": true,
    "message": "UserOrganization modified successfully.",
    "data": {
        "id": 191,
        "email": "hz8tester@gmail.com",
        "is_staff": false,
        "is_superuser": false,
        "is_active": false,
        "date_joined": "2025-01-31T16:20:38.357227Z",
        "first_name": "hz08",
        "last_name": "tester",
        "organization": {
            "id": 2,
            "org_name": "Ejento",
            "domain": "ejento.ai",
            "org_logo_url": "",
            "org_icon_url": "",
            "is_deleted": false,
            "created_by": "System",
            "created_on": "2024-03-19T19:10:01.159886Z",
            "modified_by": "System",
            "modified_on": "2024-03-19T19:10:01.159905Z"
        }
    }
}

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successfully updated user organization.

Body

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Get User Permission

Delete User Permission

Edit User Permission

Overview#

Functionality#

Request

Responses

Overview

Functionality