Skip to content
/
Remove user
Last updated

Remove user

Remove a user from an organization, cleaning up all role and department assignments.

DELETEhttps://api.aitronos.com/v1/organizations/{organization_id}/users/{user_id}

Removes the user from the organization. All role assignments and department memberships are deleted, and the organization membership is soft-deleted. Optionally, you can transfer the user's resources to a target department. The request body requires confirm: true to proceed.

Path Parameters

organization_id string required

The unique identifier of the organization (format: org_*).

user_id string required

The unique identifier of the user to remove (format: usr_*).

Request Body

confirm boolean optional · Defaults to false

Set to true to confirm the removal. If false or omitted, the request will be rejected.

transfer_resources_to_department_id string optional

The ID of the department to transfer the user's resources to (format: dept_*).

Returns

An empty response with a 204 No Content status code.

cURL
curl -X DELETE https://api.aitronos.com/v1/organizations/org_xyz789/users/usr_abc123 \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "confirm": true,
    "transfer_resources_to_department_id": "dept_eng001"
  }'
Previous page
Next page