Object Reference for the Salesforce Platform
j
No Results
Search Tips:
- Please consider misspellings
- Try different search keywords
PermissionSetAssignment
Represents a user’s assignment to a permission set or permission set
group. This object is available in API version 22.0 and later.
Supported Calls
create(), delete(), describeSObjects(), query(), retrieve(), update()
Special Access Rules
As of Summer ’20 and later, only users who have one of these permissions can access this object:
- View Setup and Configuration
- Assign Permission Sets
- Manage User
Fields
Usage
- Finding Permission Set Assignments
- Use the PermissionSetAssignment object to query permission set assignments to find out which permission sets are assigned to which users. Because each user can be assigned to many permission sets and each permission set can be assigned to many users, each PermissionSetAssignment ID represents the association of a single user and single permission set.
- For example, to search for all permission sets assigned to a particular
user:To search for all users assigned to a particular permission set:
SELECT Id, PermissionSetId FROM PermissionSetAssignment WHERE AssigneeId = '005600000017cKt'You can also create a new permission set assignment, or use delete to remove a permission set that's assigned to a user. To update an assignment, delete an existing assignment and insert a new one.SELECT Id, AssigneeId FROM PermissionSetAssignment WHERE PermissionSetId = '0PS30000000000e' - User Licenses
- When assigning a permission set, if the PermissionSet has a UserLicenseId, its UserLicenseId and the Profile UserLicenseId must match. To determine a user's license assignment, query the user's profile and then query the profile's license.
- For example, to find a user's profile
ID:To find a permission set's UserLicenseId:
SELECT Id, ProfileId FROM User WHERE Id = '005D0000001GMAT'If the IDs match, the assignment succeeds.SELECT Id, LicenseId FROM PermissionSet WHERE Id = '0PS30000000000e' - To find all the permission sets with no license that are assigned to any
user:
SELECT Id, Assignee.Name, PermissionSet.Name FROM PermissionSetAssignment WHERE PermissionSet.LicenseId = null