--- title: "Update a Specific User" method: PATCH path: "/api/v2/users/{id}" tags: ["User"] --- # Update a Specific User `PATCH /api/v2/users/{id}` This endpoint updates supplied fields for a specific user.

The `PATCH` endpoint does not support the `X-Degreed-Organization-Code` header.

**Note:**

Required Scope

`users:write` ## Path parameters - `id` string, required ## Request body - UsersIdBody - `data` Apiv2usersidData - `type` string - `attributes` Apiv2usersidDataAttributes - `employee-id` string, nullable — The employee ID of the user. - `first-name` string, nullable, required — The first name of the user. `first-name` updates the first name in `full-name` if the string provided for `full-name` is empty. - `last-name` string, nullable, required — The last name of the user. `last-name` updates the last name in `full-name` if the string provided for `full-name` is empty. - `full-name` string, nullable, required — The full name of the user. This field gets updated by `first-name` and `last-name` if the `full-name` string is empty. - `organization-email` string, nullable — Email used within the organization. - `personal-email` string, nullable — The personal email of the user. - `bio` string, nullable — Short biography of the user. The maximum length is 2000 characters. - `location` string, nullable — Location of the user. - `login-disabled` boolean — Ability for the user to login. - `restricted` boolean — Restricts the user from changing certain fields in the user interface, which are primarily related to entering free-text, such as commenting. - `is-active-learner` boolean — Indicates whether the user is an active learner. - `is-managed` boolean — Indicates whether the user is restricted from changing their personal profile settings, specifically First Name, Last Name, Email, and Job Role. - `permission-role` string, nullable — One of `Admin`, `LearningProfessional`, `Manager`, `Member`, `CareerProfessional` or `TechnicalAdmin`. - `job-role` string — The user's job role. You must have the job role setting enabled for your organization to use this parameter. Contact your Degreed Technical Solutions Specialist for assistance. - `real-time-email-notification` boolean, nullable — If the user wants to receive email notifications. - `daily-digest-email` boolean, nullable — If the user wants to sign up for the daily digest email. - `weekly-digest-email` boolean, nullable — If the user wants to sign up for the weekly digest email. - `preferred-language` string, nullable — The preferred language to display content within the user's Degreed experience. This value must be a valid language code. - `display-language` string, nullable — The language that displays on buttons and messages on a user's Degreed experience. This value must be a valid language code. - `relationships` Apiv2usersDataRelationships[] - `manager` Apiv2usersDataManager — The user id of the user's manager. Must be the value of the id key in the relationship object. - `data` Apiv2usersDataManagerData - `id` string - `type` string ## Response `200` Success - DetailedUser - `data` UserData - `type` string, nullable - `id` string, nullable - `attributes` UserDataAttributes - `employee-id` string, nullable — The unique employee identifier. - `first-name` string, nullable — The first name of the user. - `last-name` string, nullable — The last name of the user. - `full-name` string, nullable — The full name of the user. - `organization-email` string, nullable — Email used within the organization. - `personal-email` string, nullable — The personal email address for the user. - `profile-visibility` string, nullable — Visibility of the profile, can be `UseOrganizationDefault`, `Everyone`, `Organization`, or `Private`. - `bio` string, nullable — Short biography of the user. - `location` string, nullable — The location of the user. - `profile-image-url` string, nullable — The user ID. - `login-disabled` boolean — Ability for the user to login. - `restricted` boolean — Indicates whether the user is restricted from changing certain fields in the user interface, which are primarily related to entering free-text, such as commenting. - `is-active-learner` boolean — Indicates whether the user is an active learner. - `is-managed` boolean — Indicates whether the user is restricted from changing their personal profile settings, specifically First Name, Last Name, Email, and Job Role. - `permission-role` string, nullable — One of `Admin`, `LearningProfessional`, `Manager`, `Member`, `CareerProfessional` or `TechnicalAdmin`. - `job-role` string, nullable — The job role of the user. - `alias-uid` string, nullable — Unique alias identifier for the user. - `preferred-language` string, nullable — The preferred language of the user. - `display-language` string, nullable — The language that displays on buttons and messages on a user's Degreed experience. This value must be a valid language code. - `real-time-email-notification` boolean, nullable — Indicates whether the user is set to receive real time email notifications. - `daily-digest-email` boolean, nullable — Indicates whether the user is signed up for the daily digest email. - `weekly-digest-email` boolean, nullable — Indicates whether the user is signed up for the weekly digest email. - `created-at` string, date-time — Date the user was created. (UTC) - `first-login-at` string, date-time, nullable — Date the user first logged into Degreed. (UTC) - `last-login-at` string, date-time, nullable — Date the user last logged into Degreed. (UTC) - `total-points` number, double — The users total learning points. - `daily-logins` integer — The number of unique days that a user has logged in. - `links` SelfLink - `self` string - `relationships` ManagerRelationshipsInner[] - `manager` UserRelationshipsInnerUser - `data` UserRelationshipData - `id` string, nullable - `type` string, nullable --- [API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)