# Bulk update user roles across all tenants

Endpoint: PATCH /resources/vendor-only/users/v1/{userId}/roles/bulk
Version: 1.0
Security: bearer

## Path parameters:

  - `userId` (string, required)

## Request fields (application/json):

  - `addRoleIds` (array)
    Role IDs to add across tenants
    Example: ["role-uuid-1","role-uuid-2"]

  - `removeRoleIds` (array)
    Role IDs to remove across tenants
    Example: ["role-uuid-3"]

  - `tenantIds` (array)
    Specific tenant IDs to update. If not provided, all tenants the user belongs to will be updated.
    Example: ["tenant-uuid-1","tenant-uuid-2"]

## Response 200 fields (application/json):

  - `userId` (string, required)
    The user ID that was updated
    Example: "user-uuid"

  - `affectedTenants` (number, required)
    Number of tenants affected by the update
    Example: 15

  - `rolesAdded` (array, required)
    Role IDs that were added
    Example: ["role-uuid-1"]

  - `rolesRemoved` (array, required)
    Role IDs that were removed
    Example: ["role-uuid-2"]