2025 Deprecation Guide
In 2025 Pluralsight is deprecating multiple fields across several queries and mutations in the GraphQL API. Pluralsight is also deprecating several REST APIs.
Many of the GraphQL deprecations are for the userId
field in its various forms (e.g. userId
in the planAdmins
query or createdByUserId
in the addChannel
mutation).
The new psUserId
fields contains a UUID which uniquely identifies a user. Each user has a psUserId
which is different than that user's userId
.
Timeline
Notice phase begins - February 10th, 2025
Queries using the deprecated fields will receive a deprecation warning in their responses.
In the API Documentation, all deprecated fields will have a strike through.
No support phase begins - August 10th, 2025
Data integrity issues with deprecated fields and APIs will not be addressed after this phase has begun.
Removal date - November 10th 2025
All deprecated fields and APIs will be removed on November 10th 2025.
Deprecations
REST API
Pluralsight is deprecating the following REST APIs:
Please take a look at the Migrating from REST to GraphQL
APIs
article for more information.
GraphQL API
General
Query / Mutation | Field Name | Replacement Field | Input / Output | Deprecation Reason |
---|
Any query or mutation which can retrieve the User object. | user->id | user->psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
Channel
Query / Mutation | Field Name | Replacement Field | Input / Output | Deprecation Reason |
---|
channels | ownerIds | ownerPsUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
channels | ownerId | ownerPsUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
channelProgress | userId | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
channelProgress | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
channelMembers | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
channelGroup | createdByUserId | createdByPsUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
channelGroup | createdByUserId | createdByPsUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannel | createdByUserId | createdByPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannelContent | actorUserId | actorPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannelGroups | actorUserId | actorPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannelGroups | createdByUserId | createdByPsUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannelMembers | contributorUserIds | contributorPsUserIds | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannelMembers | memberUserIds | memberPsUserIds | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannelMembers | ownerUserId | ownerPsUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannelMembers | actorUserId | actorPsUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addChannelsToChannelGroups | actorUserId | actorPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
addTeamsToChannels | actorUserId | actorPsUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
archiveChannel | actorUserId | actorPsUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
deleteChannelGroup | actorUserId | actorPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
deleteChannelGroupChannels | actorUserId | actorPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
editChannel | actorUserId | actorPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
removeChannelContent | actorUserId | actorPsUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
removeChannelMember | actorUserId | actorPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
removeChannelMember | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
updateChannelGroups | actorUserId | actorPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
Content
Query / Mutation | Field Name | Replacement Field | Input / Output | Deprecation Reason |
---|
projectCatalog | | | | Projects are a retired content type, thus the catalog is no longer relevant. |
Role
Query / Mutation | Field Name | Replacement Field | Input / Output | Deprecation Reason |
---|
roleIqLearnerLevels | userId | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
roleIqLearnerLevels | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
roleIqLearnerLevels | assignedBy | assignedByPsUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
roleIqAssignments | userId | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
roleIqAssignments | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
roleIqAssignments | assignedByUserId | assignedByPsUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addRole | createdByUserId | createdByPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
assignTeamsToRole | assignedByUserId | assignedByPsUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
assignUsersToRole | assignedByUserId | assignedByPsUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
deleteRole | createdByUserId | createdByPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
editRole | editedByUserId | editedByPsUserId | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
Skill
Query / Mutation | Field Name | Replacement Field | Input / Output | Deprecation Reason |
---|
skillAssessmentResults | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
skillAssessmentResults | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
skillAssessmentCatalog | stackOverflowTags | n/a | input | Assessments at Pluralsight no longer support these tags. The filter will be removed. |
skillAssessmentCatalog | stackOverflowTags | n/a | output | Assessments at Pluralsight no longer support these tags. The field will be removed. |
Team
Query / Mutation | Field Name | Replacement Field | Input / Output | Deprecation Reason |
---|
teamManagers | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addTeamManager | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
addTeamMember | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
moveMemberToTeam | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
removeTeamManager | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
removeTeamMember | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
Usage
Query / Mutation | Field Name | Replacement Field | Input / Output | Deprecation Reason |
---|
userCertificationUploads | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
userCertificationUploads | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
programUserProgress | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
programUserProgress | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
programAssessmentUserOptions | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
programAssessmentUserOptions | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
programAssessmentAttempts | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
programAssessmentAttempts | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
priority | createdByUserIds | createdByPsUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
priority | createdByUserId | createdByPsUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
practiceExamQuizProgress | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
practiceExamQuizProgress | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
courseProgress | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
courseProgress | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
courseDailyUsage | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
courseDailyUsage | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
contentProgress | userIds | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
contentProgress | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
User
Query / Mutation | Field Name | Replacement Field | Input / Output | Deprecation Reason |
---|
users | ids | psUserIds | input | Pluralsight is transitioning to a UUID compliant identifier for users. |
users | id | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
planAdmins | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
memberInvites | redeemedByUserId | redeemedByPsUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
createUser | userId | psUserId | output | Pluralsight is transitioning to a UUID compliant identifier for users. |
editUser | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
removeLicense | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |
removeLicense | userId | psUserId | input/output | Pluralsight is transitioning to a UUID compliant identifier for users. |