Remove Users

Remove Users

This page covers how to remove users from projects and companies. User removal is a permanent action that unassigns the user from all records and removes their access, though their historical data is preserved for audit purposes.

Remove User from Project

Remove a user from a specific project while maintaining their company access.

Basic Example

mutation {
  removeProjectUser(
    input: {
      projectId: "project-id"
      userId: "user-id"
    }
  ) {
    success
    operationId
  }
}

Response Example

{
  "data": {
    "removeProjectUser": {
      "success": true,
      "operationId": null
    }
  }
}

Note: The operationId field is currently not populated by this mutation and will return null.

Remove User from Company

Remove a user from the entire company, which cascades to all projects.

Basic Example

mutation {
  removeCompanyUser(
    input: {
      companyId: "company-id"
      userId: "user-id"
    }
  )
}

Response Example

{
  "data": {
    "removeCompanyUser": true
  }
}

Input Parameters

RemoveProjectUserInput

RemoveCompanyUserInput

Response Fields

RemoveProjectUser Response

RemoveCompanyUser Response

The removeCompanyUser mutation returns a simple Boolean value:

• true - User was successfully removed

Required Permissions

Project User Removal

Important Notes:

• You cannot remove users with OWNER role from a project
• The system prevents removal of project owners to maintain project ownership integrity

Company User Removal

Note: Only company owners can remove users from the company. The resolver enforces strict OWNER-only access for company user removal operations.

Side Effects

Project Removal

• Removes all todo assignments for the user in that project
• Deletes user’s project folders
• Removes project user relationship
• Sends real-time updates to notify other users
• Creates audit log entry

Company Removal

• Cascading deletion across all projects:
  • Removes all todo assignments in all company projects
  • Removes all project user folders
  • Removes user from all company projects
• Removes company user folders
• Removes user from company
• Sends removal notification email to the removed user
• Creates audit log entry

Error Responses

Project Not Found

{
  "errors": [{
    "message": "Project was not found.",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

User Not Found

{
  "errors": [{
    "message": "User was not found.",
    "extensions": {
      "code": "USER_NOT_FOUND"
    }
  }]
}

Unauthorized Error

{
  "errors": [{
    "message": "You are not authorized.",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

Company Not Found (removeCompanyUser only)

{
  "errors": [{
    "message": "Company was not found.",
    "extensions": {
      "code": "COMPANY_NOT_FOUND"
    }
  }]
}

This error occurs when:

• You lack the required role (OWNER/ADMIN for projects, OWNER for company)
• You attempt to remove a project OWNER
• The user is not part of the project/company

Important Considerations

• Data Preservation: User removal is not reversible. While the user loses access, their historical data (comments, activity logs, etc.) is preserved for audit purposes.
• Owner Protection: Project owners cannot be removed from projects. Transfer ownership first if needed.
• Email Notification: Company removal sends a notification email to the removed user.
• Cascade Effect: Company removal affects all projects, while project removal is isolated to that specific project.

Related Operations

• List Users - View users before removal
• Retrieve Custom Role - Check user permissions
• Create Project - Add users to new projects