How to use the pivotBy field

General questions
1

What are the available dimensions to use for the pivotBy field?

Would i be able to join UserIds and Events?

2

Hi, I would like to know what are the available dimensions to use with pivotBy field in API too… Any news?