# Degreed API Documentation ## Guides - [Authentication Guide](https://developer.degreed.com/docs/authentication.md) - [Degreed's Direct Data Connector](https://developer.degreed.com/docs/degreeds-direct-data-connector.md) - [Degreed Integrations](https://developer.degreed.com/docs/degreed-integrations.md) - [Content Integration Concepts](https://developer.degreed.com/docs/integrate-content-with-the-api.md) - [Integration Methods](https://developer.degreed.com/docs/integration-methods.md) - [Single Sign-On Authentication](https://developer.degreed.com/docs/single-sign-on-authentication.md) - [External Webhooks in Degreed](https://developer.degreed.com/docs/external-webhooks-in-degreed.md) - [Getting Started with the API](https://developer.degreed.com/docs/getting-started-with-the-api.md) - [Available Statements for GET Operations to Retrieve Degreed Events](https://developer.degreed.com/docs/available-statements-for-get-operations-to-retrieve-degreed-events.md) - [Rate Limiting](https://developer.degreed.com/docs/rate-limiting.md) - [Understanding Degreed IDs](https://developer.degreed.com/docs/understanding-ids-in-the-degreed-api.md) ## API Reference - [Get Detailed Component Status Summary](https://developer.degreed.com/reference/getstatussummary.md): Returns overall system status, component-level statuses, active incidents, and scheduled maintenance. - [Get Current System Status](https://developer.degreed.com/reference/getsystemstatus.md): Returns the current overall status indicator and description for Degreed services. - [Degreed Status](https://developer.degreed.com/reference/degreed-api-status.md) - [Logout](https://developer.degreed.com/reference/delete_oauth-token.md): This endpoint will immediately expire the `access_token` and the `refresh_token` if provided. - [Create a New Access Token](https://developer.degreed.com/reference/post_oauth-token-1.md): This endpoint creates an access token. Access tokens are valid only for the set of operations and resources described in the scope of the token request. For more information, see [Authentication Guide](https://degreed.readme.io/docs/authentication). - [Delete a Specific Accomplishment](https://developer.degreed.com/reference/delete_api-v2-accomplishments-id.md): This endpoint deletes an accomplishment from the system. On a successful delete, it returns a `204 No Content` response.

Required Scope

`accomplishments:write` - [Get a Specific Accomplishment](https://developer.degreed.com/reference/get_api-v2-accomplishments-id.md): This endpoint retrieves a specific accomplishment.

Required Scope

`accomplishments:read` or `accomplishments:write` - [Get All Accomplishments](https://developer.degreed.com/reference/get_api-v2-accomplishments.md): This endpoint retrieves all accomplishments for the organization.

Required Scope

`accomplishments:read` or `accomplishments:write` - [Update a Specific Accomplishment](https://developer.degreed.com/reference/patch_api-v2-accomplishments-id.md): This endpoint updates supplied fields for a specific accomplishment.

Required Scope

`accomplishments:write` - [Create a New Accomplishment](https://developer.degreed.com/reference/post_api-v2-accomplishments.md): This endpoint creates a new accomplishment in the system.

Required Scope

`accomplishments:write` - [Delete A Specific User Award](https://developer.degreed.com/reference/delete_api-v2-awards-id.md): This endpoint deletes a specific award.

Required Scope

`awards:write` - [Get A Specific User Award](https://developer.degreed.com/reference/get_api-v2-awards-id.md): This endpoint retrieves the details of a specific award that has been awarded to a particular user.

Required Scope

`awards:read` or `awards:write` - [Get All User Awards](https://developer.degreed.com/reference/get_api-v2-awards.md): This endpoint retrieves all awards for the current organization.

Required Scope

`awards:read` or `awards:write` - [Update a Specific User Award](https://developer.degreed.com/reference/patch_api-v2-awards-id.md): This endpoint updates the supplied fields for a specific award.

Required Scope

`awards:write` - [Create a New User Award](https://developer.degreed.com/reference/post_api-v2-awards.md): This endpoint creates a new award for the specified user.

Required Scope

`awards:write` - [Delete A Specific User Badge](https://developer.degreed.com/reference/delete_api-v2-user-badges-id.md): This endpoint deletes a specific badge.

Required Scope

`user_badges:write` - [Get A Specific User Badge](https://developer.degreed.com/reference/get_api-v2-user-badges-id.md): This endpoint retrieves the details of a specific badge that has been awarded to a particular user.

Required Scope

`user_badges:read` or `user_badges:write` - [Get All User Badges](https://developer.degreed.com/reference/get_api-v2-user-badges.md): This endpoint retrieves all badges for the current organization.

Required Scope

`user_badges:read` or `user_badges:write` - [Badges](https://developer.degreed.com/reference/badges.md) - [Update a Specific User Badge](https://developer.degreed.com/reference/patch_api-v2-user-badges-id.md): This endpoint updates the supplied fields for a specific badge.

Required Scope

`user_badges:write` - [Create a New User Badge](https://developer.degreed.com/reference/post_api-v2-user-badges.md): This endpoint creates a new badge for the specified user.

Required Scope

`user_badges:write` - [Create a New Bulk Upload of Opportunities](https://developer.degreed.com/reference/post_api-v2-opportunities-bulk.md): This endpoint creates a new bulk upload for opportunities. A maximum of 200 records is allowed.

Required Scope

`opportunity:write` - [Delete Resources in a Bundle](https://developer.degreed.com/reference/delete_api-v2-bundles-id-relationships-resources.md): This endpoint deletes the specified resources in a role of an existing bundle. On a successful delete it returns a `204 No Content` response.

Required Scope

`bundles:write` - [Delete a Specific Bundle](https://developer.degreed.com/reference/delete_api-v2-bundles-id.md): This endpoint deletes a bundle from the Degreed system. On a successful delete, it returns a `204 No Content` response.

Required Scope

`bundles:write` - [Get a List of Resources for a Specific Bundle](https://developer.degreed.com/reference/get_api-v2-bundles-id-relationships-resources.md): This endpoint retrieves a list of resources that belong to this bundle.

Required Scope

`bundles:read` or `bundles:write` - [Get a Specific Bundle](https://developer.degreed.com/reference/get_api-v2-bundles-id.md): This endpoint retrieves a specific bundle for the current organization.

Required Scope

`bundles:read` or `bundles:write` - [Get All Bundles](https://developer.degreed.com/reference/get_api-v2-bundles.md): This endpoint retrieves all bundles for the current organization.

Required Scope

`bundles:read` or `bundles:write` - [Bundle](https://developer.degreed.com/reference/bundle.md) - [Replace Resources in a Bundle](https://developer.degreed.com/reference/patch_api-v2-bundles-id-relationships-resources.md): This endpoint replaces all resources in an existing bundle with the newly supplied resources. On a successful add, it returns a `201 Created` response.

Required Scope

`bundles:write` - [Update a Specific Bundle](https://developer.degreed.com/reference/patch_api-v2-bundles-id.md): This endpoint updates the supplied fields for a specific bundle.

Required Scope

`bundles:write` - [Add Resources to a Bundle](https://developer.degreed.com/reference/post_api-v2-bundles-id-relationships-resources.md): This endpoint adds resources to an existing bundle. On a successful add, it returns a `201 Created` response.

Required Scope

`bundles:write` - [Create a New Bundle](https://developer.degreed.com/reference/post_api-v2-bundles.md): This endpoint creates a new bundle in the system.

Required Scope

`bundles:write` - [Delete a Specific Certificate](https://developer.degreed.com/reference/delete_api-v2-certificates-id.md): This endpoint deletes a certificate from the system. On a successful delete, it returns a `204 No Content` response.

Required Scope

`certificates:write` - [Get a Specific Certificate](https://developer.degreed.com/reference/get_api-v2-certificates-id.md): This endpoint retrieves a specific certificate.

Required Scope

`certificates:read` or `certificates:write` - [Get All Certificates](https://developer.degreed.com/reference/get_api-v2-certificates.md): This endpoint retrieves all certificates for the organization.

Required Scope

`certificates:read` or `certificates:write` - [Update a Specific Certificate](https://developer.degreed.com/reference/patch_api-v2-certificates-id.md): This endpoint updates supplied fields for a specific certificate.

Required Scope

`certificates:write` - [Create a New Certificate](https://developer.degreed.com/reference/post_api-v2-certificates.md): This endpoint creates a new certificate in the system.

Required Scope

`certificates:write` - [Delete a Specific Completion](https://developer.degreed.com/reference/delete_api-v2-completions-id.md): This endpoint deletes a completion from the system. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`completions:write` - [Get a Specific Completion](https://developer.degreed.com/reference/get_api-v2-completions-id.md): This endpoint retrieves a specific completion for the organization. If the organization is a Global Admin Tool Organization or a provider requesting on behalf of the organization, completions will be returned for Tenant Organizations.

For Global Admin Tool Organizations, if the user of the completion belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header can be provided, but is no longer necessary.

Required Scope

`completions:read` or `completions:write` - [Get All Completions](https://developer.degreed.com/reference/get_api-v2-completions.md): This endpoint retrieves all completions for the organization. To retrieve results, you must use either both added filters, or both completed filters. The filters require a start and end date, with a maximum range of 7 days.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return completions for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`completions:read` or `completions:write` - [Update a Specific Completion](https://developer.degreed.com/reference/patch_api-v2-completions-id.md): This endpoint updates supplied fields for a specific completion.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`completions:write` - [Create A New Completion](https://developer.degreed.com/reference/post_api-v2-completions.md): This endpoint creates a new completion for the user in the organization and content available to the organization. If the organization is a Global Admin Tool Organization or a provider requesting on behalf of the organization, completions can be created for Tenant Organization users and content available within the organization structure. Global Admin Tool Organization should exercise caution when indicating which content the user has completed.

For Global Admin Tool Organizations, if the user of the completion belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header can be provided, but is no longer necessary and may limit the content for which the completion can be created.

Required Scope

`completions:write` - [Delete a Specific Article](https://developer.degreed.com/reference/delete_api-v2-content-articles-id.md): This endpoint marks an article as obsolete from the Degreed catalog. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:write` - [Get a Specific Article](https://developer.degreed.com/reference/get_api-v2-content-articles-id.md): This endpoint retrieves a specific article for the current organization.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:read` or `content:write` - [Get All Articles](https://developer.degreed.com/reference/get_api-v2-content-articles.md): This endpoint retrieves all articles for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Update a Specific Article](https://developer.degreed.com/reference/patch_api-v2-content-articles-id.md): This endpoint updates supplied fields for a specific article. The PATCH request does not support the `X-Degreed-Organization-Code` header.

Required Scope

`content:write` - [Create a New Article](https://developer.degreed.com/reference/post_api-v2-content-articles.md): This endpoint creates a new article in the system and optionally creates visibility group relationships.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will create content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:write` - [Delete a Specific Assessment](https://developer.degreed.com/reference/delete_api-v2-content-assessments-id.md): This endpoint marks an assessment as obsolete from the Degreed catalog. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:write` - [Get a Specific Assessment](https://developer.degreed.com/reference/get_api-v2-content-assessments-id.md): This endpoint retrieves a specific assessment for the current organization.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:read` or `content:write` - [Get All Assessments](https://developer.degreed.com/reference/get_api-v2-content-assessments.md): This endpoint retrieves all assessments for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Update a Specific Assessment](https://developer.degreed.com/reference/patch_api-v2-content-assessments-id.md): This endpoint updates supplied fields for a specific assessment. The `PATCH` request does not support the `X-Degreed-Organization-Code` header.

Required Scope

`content:write` - [Create a New Assessment](https://developer.degreed.com/reference/post_api-v2-content-assessments.md): This endpoint creates a new assessment in the system and optionally creates visibility group relationships.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will create content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

**Note:** When visibility groups are set for content, the groups must either be (a) all of privacy level `Administrative` or (b) all of a non- `Administrative` privacy level. Non- `Administrative` privacy levels include `Open`, `Closed` and `Private`. Content in `Administrative` groups is only visible to users in the `Administrative` groups. If the content is not associated with any Administrative groups, the content is visible to all users in the organization. A group's privacy level can be retrieved from the [Get a Specific Group]() endpoint.

Required Scope

`content:write` - [Delete a Specific Book](https://developer.degreed.com/reference/delete_api-v2-content-books-id.md): This endpoint marks a book as obsolete from the Degreed catalog. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:write` - [Get a Specific Book](https://developer.degreed.com/reference/get_api-v2-content-books-id.md): This endpoint retrieves a specific book for the current organization.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:read` or `content:write` - [Get All Books](https://developer.degreed.com/reference/get_api-v2-content-books.md): This endpoint retrieves all books for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Update a Specific Book](https://developer.degreed.com/reference/patch_api-v2-content-books-id.md): This endpoint updates the supplied fields for a specific book.

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

Required Scope

`content:write` - [Create a New Book](https://developer.degreed.com/reference/post_api-v2-content-books.md): This endpoint creates a new book in the system.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will create content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:write` - [Delete a Specific Course](https://developer.degreed.com/reference/delete_api-v2-content-courses-id.md): This endpoint marks a course as obsolete from the Degreed catalog. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:write` - [Get a Specific Course](https://developer.degreed.com/reference/get_api-v2-content-courses-id.md): This endpoint retrieves a specific course for the current organization.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:read` or `content:write` - [Get All Courses](https://developer.degreed.com/reference/get_api-v2-content-courses.md): This endpoint retrieves all courses for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Update a Specific Course](https://developer.degreed.com/reference/patch_api-v2-content-courses-id.md): This endpoint updates supplied fields for a specific course. The `PATCH` request does not support the `X-Degreed-Organization-Code` header.

Required Scope

`content:write` - [Create a New Course](https://developer.degreed.com/reference/post_api-v2-content-courses.md): This endpoint creates a new course in the system and optionally creates visibility group relationships.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will create content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

**Note:** When visibility groups are set for content, the groups must either be (a) all of privacy level `Administrative` or (b) all of a non- `Administrative` privacy level. Non- `Administrative` privacy levels include `Open`, `Closed` and `Private`. Content in `Administrative` groups is only visible to users in the `Administrative` groups. If the content is not associated with any Administrative groups, the content is visible to all users in the organization. A group's privacy level can be retrieved from the [Get a Specific Group]() endpoint.

Required Scope

`content:write` - [Delete a Specific Event](https://developer.degreed.com/reference/delete_api-v2-content-events-id.md): This endpoint marks an event as obsolete from the Degreed catalog. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:write` - [Get a Specific Event](https://developer.degreed.com/reference/get_api-v2-content-events-id.md): This endpoint retrieves a specific event for the current organization.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:read` or `content:write` - [Get All Events](https://developer.degreed.com/reference/get_api-v2-content-events.md): This endpoint retrieves all events for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Update a Specific Event](https://developer.degreed.com/reference/patch_api-v2-content-events-id.md): This endpoint updates supplied fields for a specific event. The `PATCH` request does not support the `X-Degreed-Organization-Code` header.

Required Scope

`content:write` - [Create a New Event](https://developer.degreed.com/reference/post_api-v2-content-events.md): This endpoint creates a new event in the system and optionally creates visibility group relationships.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will create content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

**Note:** When visibility groups are set for content, the groups must either be (a) all of privacy level `Administrative` or (b) all of a non- `Administrative` privacy level. Non- `Administrative` privacy levels include `Open`, `Closed` and `Private`. Content in `Administrative` groups is only visible to users in the `Administrative` groups. If the content is not associated with any Administrative groups, the content is visible to all users in the organization. A group's privacy level can be retrieved from the [Get a Specific Group]() endpoint.

Required Scope

`content:write` - [Delete a Specific Live Event](https://developer.degreed.com/reference/delete_api-v2-content-id-relationships-sessions-session-id.md): This endpoint deletes a specific live event for a specific course or event.

Required Scope

`content:write` - [Get a Specific Live Event](https://developer.degreed.com/reference/get_api-v2-content-id-relationships-sessions-session-id.md): This endpoint retrieves a specific live event for a specific course or event.

Required Scope

`content:read` or `content:write` - [Get All Live Events](https://developer.degreed.com/reference/get_api-v2-content-id-relationships-sessions.md): This endpoint retrieves all live events for a specific course or event.

Required Scope

`content:read` or `content:write` - [Update a Specific Live Event](https://developer.degreed.com/reference/patch_api-v2-content-id-relationships-sessions-session-id.md): This endpoint updates a live event for a specific course or event.

Required Scope

`content:write` - [Create a Live Event](https://developer.degreed.com/reference/post_api-v2-content-id-relationships-sessions.md): This endpoint creates a live event for a specific course or event. Live events can only be created for courses or event content types.

Required Scope

`content:write` - [Delete a Specific Podcast](https://developer.degreed.com/reference/delete_api-v2-content-podcasts-id.md): This endpoint marks a podcast (also referred to as episode) as obsolete from the Degreed catalog. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:write` - [Get a Specific Podcast](https://developer.degreed.com/reference/get_api-v2-content-podcasts-id.md): This endpoint retrieves a specific podcast (also referred to as episode) for the current organization.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:read` or `content:write` - [Get All Podcasts](https://developer.degreed.com/reference/get_api-v2-content-podcasts.md): This endpoint retrieves all podcasts (also referred to as episodes) for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Update a Specific Podcast](https://developer.degreed.com/reference/patch_api-v2-content-podcasts-id.md): This endpoint updates supplied fields for a specific podcast (also referred to as episode). The `PATCH` request does not support the `X-Degreed-Organization-Code` header.

Required Scope

`content:write` - [Create a New Podcast](https://developer.degreed.com/reference/post_api-v2-content-podcasts.md): This endpoint creates a new podcast (also referred to as episode) in the system and optionally creates visibility group relationships.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will create content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

**Note:** When visibility groups are set for content, the groups must either be (a) all of privacy level `Administrative` or (b) all of a non- `Administrative` privacy level. Non- `Administrative` privacy levels include `Open`, `Closed` and `Private`. Content in `Administrative` groups is only visible to users in the `Administrative` groups. If the content is not associated with any Administrative groups, the content is visible to all users in the organization. A group's privacy level can be retrieved from the [Get a Specific Group]() endpoint.

Required Scope

`content:write` - [Delete a Specific Post](https://developer.degreed.com/reference/delete_api-v2-content-posts-id.md): This endpoint deletes a specific post.

Required Scope

`content:write` - [Get a Specific Post](https://developer.degreed.com/reference/get_api-v2-content-posts-id.md): This endpoint retrieves all posts.

Required Scope

`content:read` or `content:write` - [Get All Posts](https://developer.degreed.com/reference/get_api-v2-content-posts.md): This endpoint retrieves all posts.

Required Scope

`content:read` or `content:write` - [Update a Specific Post](https://developer.degreed.com/reference/patch_api-v2-content-posts-id.md): This endpoint updates a specific post.

Required Scope

`content:write` - [Create a Post](https://developer.degreed.com/reference/post_api-v2-content-posts.md): This endpoint creates a post.

Required Scope

`content:write` - [Delete a Specific Task](https://developer.degreed.com/reference/delete_api-v2-content-tasks-id.md): This endpoint deletes a specific task.

Required Scope

`content:write` - [Get a Specific Task](https://developer.degreed.com/reference/get_api-v2-content-tasks-id.md): This endpoint retrieves all tasks.

Required Scope

`content:read` or `content:write` - [Get All Tasks](https://developer.degreed.com/reference/get_api-v2-content-tasks.md): This endpoint retrieves all tasks.

Required Scope

`content:read` or `content:write` - [Update a Specific Task](https://developer.degreed.com/reference/patch_api-v2-content-tasks-id.md): This endpoint updates a specific task.

Required Scope

`content:write` - [Create a Task](https://developer.degreed.com/reference/post_api-v2-content-tasks.md): This endpoint creates a task.

Required Scope

`content:write` - [Delete a Specific Video](https://developer.degreed.com/reference/delete_api-v2-content-videos-id.md): This endpoint marks a video as obsolete from the Degreed catalog. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:write` - [Get a Specific Video](https://developer.degreed.com/reference/get_api-v2-content-videos-id.md): This endpoint retrieves a specific video for the current organization.

For Global Admin Tool Organizations, if the content belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`content:read` or `content:write` - [Get All Videos](https://developer.degreed.com/reference/get_api-v2-content-videos.md): This endpoint retrieves all videos for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Update a Specific Video](https://developer.degreed.com/reference/patch_api-v2-content-videos-id.md): This endpoint updates supplied fields for a specific video. The `PATCH` request does not support the `X-Degreed-Organization-Code` header.

Required Scope

`content:write` - [Create A New Video](https://developer.degreed.com/reference/post_api-v2-content-videos.md): This endpoint creates a new video in the system and optionally creates visibility group relationships.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will create content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

**Note:** When visibility groups are set for content, the groups must either be (a) all of privacy level `Administrative` or (b) all of a non- `Administrative` privacy level. Non- `Administrative` privacy levels include `Open`, `Closed` and `Private`. Content in `Administrative` groups is only visible to users in the `Administrative` groups. If the content is not associated with any Administrative groups, the content is visible to all users in the organization. A group's privacy level can be retrieved from the [Get a Specific Group]() endpoint.

Required Scope

`content:write` - [Delete Skills from Content](https://developer.degreed.com/reference/delete_api-v2-content-contentid-relationships-skills.md): This endpoint deletes the specified skills in content. On a successful delete, it returns a `204 No Content` response.

Required Scope

`content:write` - [Get Skills for a Specific Content Item](https://developer.degreed.com/reference/get_api-v2-content-contentid-skills.md): This endpoint retrieves all skills for a specific content item.

Required Scope

`content:read` - [Get Visibility Groups for a Specific Content Item](https://developer.degreed.com/reference/get_api-v2-content-contentid-visibility-groups.md): This endpoint retrieves visibility groups for a specific content item.

Required Scope

`content:read` or `content:write` - [Get a Specific Content Item](https://developer.degreed.com/reference/get_api-v2-content-id.md): This endpoint retrieves a specific content item for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Get All Content](https://developer.degreed.com/reference/get_api-v2-content.md): This endpoint retrieves all content (excluding obsolete content) for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`content:read` or `content:write` - [Content](https://developer.degreed.com/reference/content.md) - [Replace Skills in Content](https://developer.degreed.com/reference/patch_api-v2-content-contentid-relationships-skills.md): This endpoint replaces all skills in existing content with the newly supplied skills. On a successful add, it returns a `201 Created` response.

Required Scope

`content:write` - [Replace Visibility Groups for a specific Content Item](https://developer.degreed.com/reference/patch_api-v2-content-contentid-relationships-visibility-groups.md): This endpoint replaces all content's visibility groups. On a successful replacement, it returns a `201 Created` response. If the patch is set with an empty list, the content will not be shared in any groups.

**Note:** When visibility groups are set for content, the groups must either be (a) all of privacy level `Administrative` or (b) all of a non- `Administrative` privacy level. Non- `Administrative` privacy levels include `Open`, `Closed` and `Private`. Content in `Administrative` groups is only visible to users in the `Administrative` groups. If the content has one or more `Administrative` visibility groups set, and you send the body with an empty list of groups, the content will be visible to any users in the organization. A group's privacy level can be retrieved from the [Get a Specific Group]() endpoint.

Required Scope

`content:write` - [Assign Skills to Content](https://developer.degreed.com/reference/post_api-v2-content-contentid-relationships-skills.md): This endpoint adds one or more skills to existing content. On a successful add, it returns a `201 Created` response.

Required Scope

`content:write` - [Delete a Custom Attribute](https://developer.degreed.com/reference/delete_api-v2-custom-attributes-id.md): This endpoint deletes the specified custom attribute for the current organization.

Required Scope

`custom_attribute:write` - [Get A Specific Custom Attribute](https://developer.degreed.com/reference/get_api-v2-custom-attributes-id.md): This endpoint retrieves the specified custom attribute for the current organization.

Required Scope

`custom_attribute:write` or `custom_attribute:read` - [Get All Custom Attributes](https://developer.degreed.com/reference/get_api-v2-custom-attributes.md): This endpoint retrieves all custom attributes for the current organization.

Required Scope

`custom_attribute:write` or `custom_attribute:read` - [Custom Attributes](https://developer.degreed.com/reference/custom-attributes.md) - [Update a Custom Attribute](https://developer.degreed.com/reference/patch_api-v2-custom-attributes-id.md): This endpoint updates the specified custom attribute for the current organization.

Required Scope

`custom_attribute:write` - [Create a New Custom Attribute](https://developer.degreed.com/reference/post_api-v2-custom-attributes.md): This endpoint creates a new custom attribute for the current organization. Your organization must register custom attributes before values can be assigned to users associated with the attribute. A maximum of 50 custom attributes can be added.

Required Scope

`custom_attribute:write` - [Delete A Specific User Degree](https://developer.degreed.com/reference/delete_api-v2-degrees-id.md): This endpoint deletes a specific degree.

Required Scope

`degrees:write` - [Get A Specific User Degree](https://developer.degreed.com/reference/get_api-v2-degrees-id.md): This endpoint retrieves the details of a specific degree that has been awarded to a particular user.

Required Scope

`degrees:read` or `degrees:write` - [Get All User Degrees](https://developer.degreed.com/reference/get_api-v2-degrees.md): This endpoint retrieves all degrees for the current organization.

Required Scope

`degrees:read` or `degrees:write` - [Update a Specific User Degree](https://developer.degreed.com/reference/patch_api-v2-degrees-id.md): This endpoint updates the supplied fields for a specific degree.

Required Scope

`degrees:write` - [Create a New User Degree](https://developer.degreed.com/reference/post_api-v2-degrees.md): This endpoint creates a new degree for the specified user.

Required Scope

`degrees:write` - [Delete a Specific Experience](https://developer.degreed.com/reference/delete_api-v2-experiences-id.md): This endpoint deletes the experience specified.

Required Scope

`experiences:write` - [Get a Specific Experience](https://developer.degreed.com/reference/get_api-v2-experiences-id.md): This endpoint retrieves a specific experience.

Required Scope

`experiences:write` or `experiences:read` - [Get All Experiences](https://developer.degreed.com/reference/get_api-v2-experiences.md): This endpoint retrieves all experiences.

Required Scope

`experiences:write` or `experiences:read` - [Experiences](https://developer.degreed.com/reference/experiences.md) - [Update a Specific Experience](https://developer.degreed.com/reference/patch_api-v2-experiences-id.md): This endpoint updates the specified experience.

Required Scope

`experiences:write` - [Create a New Experience](https://developer.degreed.com/reference/post_api-v2-experiences.md): This endpoint creates a new experience in the system.

Required Scope

`experiences:write` - [Delete Users in a Group](https://developer.degreed.com/reference/delete_api-v2-groups-groupid-relationships-roleid.md): This endpoint deletes the specified users in a role of an existing group. On a successful delete, it returns a `204 No Content` response.

Scope Required

`groups:write` - [Delete Organizations in a Group](https://developer.degreed.com/reference/delete_api-v2-groups-id-relationships-organizations.md): This endpoint deletes the specified organizations in a group. It returns a `204 No Content` response. This endpoint is only accessible to Global Admin Tool Organizations.

Required Scope

`groups:write` - [Delete a Specific Group](https://developer.degreed.com/reference/delete_api-v2-groups-id.md): This endpoint deletes a group from the Degreed system. On a successful delete, it returns a `204 No Content` response.

Scope Required

`groups:write` - [Get a List of Group Memberships](https://developer.degreed.com/reference/get_api-v2-group-memberships.md): This endpoint retrieves a list of users who joined a group within the specified date range. The maximum range between date filters is 7 days.

Required Scope

`users:read` or `users:write` - [Get Organizations for a Specific Group](https://developer.degreed.com/reference/get_api-v2-groups-id-relationships-organizations.md): This endpoint retrieves a list of organizations that belong to this group. This endpoint is only accessible to Global Admin Tool Organizations.

Required Scope

`groups:read` or `groups:write` - [Get a List of Users for a Specific Group](https://developer.degreed.com/reference/get_api-v2-groups-id-users.md): This endpoint retrieves a list of users who belong to this group.

Required Scope

`users:read` or `users:write` - [Get a Specific Group](https://developer.degreed.com/reference/get_api-v2-groups-id.md): This endpoint retrieves a specific group for the current organization.

Required Scope

`groups:read` or `groups:write` - [Get All Groups](https://developer.degreed.com/reference/get_api-v2-groups.md): This endpoint retrieves all groups for the current organization.

Required Scope

`groups:read` or `groups:write` - [Group](https://developer.degreed.com/reference/group.md) - [Replace Users in a Group](https://developer.degreed.com/reference/patch_api-v2-groups-groupid-relationships-roleid.md): This endpoint replaces all users in an existing group with the newly supplied users. On a successful add, it returns a `201 Created` response with no body.

Required Scope

`groups:write` - [Replace Organizations in a Group](https://developer.degreed.com/reference/patch_api-v2-groups-id-relationships-organizations.md): This endpoint replaces all organizations in an existing group with the newly supplied organizations. On a successful add, it returns a `201 Created` response with no body. This endpoint is only accessible to Global Admin Tool Organizations.

Required Scope

`groups:write` - [Update a Specific Group](https://developer.degreed.com/reference/patch_api-v2-groups-id.md): This endpoint updates supplied fields for a specific group.

Required Scope

`groups:write` - [Add Users to a Group](https://developer.degreed.com/reference/post_api-v2-groups-groupid-relationships-roleid.md): This endpoint adds users to an existing group. On a successful add, it returns a `201 Created` response with no body.

Required Scope

`groups:write` - [Add Organizations to a Group](https://developer.degreed.com/reference/post_api-v2-groups-id-relationships-organizations.md): This endpoint adds organizations to an existing group. On a successful add, it returns a `201 Created` response with no body. This endpoint is only accessible to Global Admin Tool Organizations.

Required Scope

`groups:write` - [Create a New Group](https://developer.degreed.com/reference/post_api-v2-groups.md): This endpoint creates a new group in the system.

Scope Required

`groups:write` - [Delete A Specific Job Role](https://developer.degreed.com/reference/delete_api-v2-job-roles-id.md): This endpoint deletes a specific job role.

Required Scope

`job_roles:write` - [Remove Skill from Job Role](https://developer.degreed.com/reference/delete_api-v2-job-roles-remove-skill.md): This endpoint removes a skill from a job role.

Required Scope

`job_roles:write` - [Get A Specific Job Role](https://developer.degreed.com/reference/get_api-v2-job-roles-id.md): This endpoint retrieves a specific job role.

Required Scope

`job_roles:read` or `job_roles:write` - [Get All Job Roles](https://developer.degreed.com/reference/get_api-v2-job-roles.md): This endpoint retrieves a list of job roles.

Required Scope

`job_roles:read` or `job_roles:write` - [Update A Specific Job Role](https://developer.degreed.com/reference/patch_api-v2-job-roles-id.md): This endpoint updates a specific job role.

Required Scope

`job_roles:write` - [Add a Skill to a Job Role](https://developer.degreed.com/reference/post_api-v2-job-roles-add-skills.md): This endpoint adds skills to a job role.

Required Scope

`job_roles:write` - [Create a New Job Role](https://developer.degreed.com/reference/post_api-v2-job-roles.md): This endpoint creates a new job role.

Required Scope

`job_roles:write` - [Get All Logins](https://developer.degreed.com/reference/get_api-v2-logins.md): This endpoint retrieves all logins for the current organization. Logins requires you to send a `start_date` and `end_date`, which are limited to a 7 day range.

Required Scope

`logins:read` - [Delete a Specific Opportunity](https://developer.degreed.com/reference/delete_api-v2-opportunities-id.md): This endpoint deletes an opportunity. On a successful delete, it returns a `204 No Content` response.

Required Scope

`opportunity:write` - [Delete a Pathway from an Opportunity](https://developer.degreed.com/reference/delete_api-v2-opportunities-opportunityid-relationships-suggested-pathways.md): This endpoint deletes the specified suggested pathway in an opportunity.

Required Scope

`opportunity:write` - [Delete a Plan from an Opportunity](https://developer.degreed.com/reference/delete_api-v2-opportunities-opportunityid-relationships-suggested-plans.md): This endpoint deletes the specified suggested plan in an opportunity.

Required Scope

`opportunity:write` - [Get a Specific Opportunity](https://developer.degreed.com/reference/get_api-v2-opportunities-id.md): This endpoint retrieves a specific opportunity.

Required Scope

`opportunity:read` or `opportunity:write` - [Get All Opportunities](https://developer.degreed.com/reference/get_api-v2-opportunities.md): This endpoint retrieves all opportunities for the current organization.

Required Scope

`opportunity:read` or `opportunity:write` - [Opportunity](https://developer.degreed.com/reference/opportunity.md) - [Update a Specific Opportunity](https://developer.degreed.com/reference/patch_api-v2-opportunities-id.md): This endpoint updates supplied fields for a specific opportunity. Any attribute, including `matched-skills`, that is included in the request body will completely replace and override existing data. For example, if you patch the `matched-skills` array attribute, the skills included in the PATCH will completely replace all previous skills associated with the opportunity.

Required Scope

`opportunity:write` - [Replace a Pathway in an Opportunity](https://developer.degreed.com/reference/patch_api-v2-opportunities-opportunityid-relationships-suggested-pathways.md): This endpoint replaces all suggested pathways in an existing opportunity with the newly supplied suggested pathways.

Required Scope

`opportunity:write` - [Replace a Plan in an Opportunity](https://developer.degreed.com/reference/patch_api-v2-opportunities-opportunityid-relationships-suggested-plans.md): This endpoint replaces all suggested plans in an existing opportunity with the newly supplied suggested plans.

Required Scope

`opportunity:write` - [Add a Pathway to an Opportunity](https://developer.degreed.com/reference/post_api-v2-opportunities-opportunityid-relationships-suggested-pathways.md): This endpoint adds a suggested pathway to an existing opportunity.

Required Scope

`opportunity:write` - [Add a Plan to an Opportunity](https://developer.degreed.com/reference/post_api-v2-opportunities-opportunityid-relationships-suggested-plans.md): This endpoint adds a suggested plan to an existing opportunity.

Required Scope

`opportunity:write` - [Create a New Opportunity](https://developer.degreed.com/reference/post_api-v2-opportunities.md): This endpoint creates a new opportunity.

Required Scope

`opportunity:write` - [Delete Associated Skills for a Specific Skill](https://developer.degreed.com/reference/delete_api-v2-organization-skills-id-relationships-associated-skills.md): This endpoint deletes the list of associated skills for the specified skill.

Required Scope

`skill:write` - [Delete Skill Review Groups for a Specific Skill](https://developer.degreed.com/reference/delete_api-v2-organization-skills-id-relationships-skill-review-groups.md): This endpoint deletes the list of Skill Review groups for the specified skill.

Required Scope

`skill:write` - [Delete a Specific Skill](https://developer.degreed.com/reference/delete_api-v2-organization-skills-id.md): This endpoint deletes a skill from the organization. On a successful delete, it returns a `204 No Content` response.

Required Scope

`skill:write` - [Get Associated Skills for a Specific Skill](https://developer.degreed.com/reference/get_api-v2-organization-skills-id-relationships-associated-skills.md): This endpoint retrieves a list of associated skills for the specified skill.

Required Scope

`skill:write` or `skill:read` - [Get Skill Review Groups for a Specific Skill](https://developer.degreed.com/reference/get_api-v2-organization-skills-id-relationships-skill-review-groups.md): This endpoint retrieves a list of Skill Review groups for the specified skill.

Required Scope

`skill:write` or `skill:read` - [Get A Specific Skill](https://developer.degreed.com/reference/get_api-v2-organization-skills-id.md): This endpoint retrieves a specific skill for the current organization.

Required Scope

`skill:read` - [Get All Skills](https://developer.degreed.com/reference/get_api-v2-organization-skills.md): This endpoint retrieves all skills (including their id) for the current organization.

Required Scope

`skill:read` - [Update a Specific Skill](https://developer.degreed.com/reference/patch_api-v2-organization-skills-id.md): This endpoint updates a specific skill for the current organization.

Required Scope

`skill:write` - [Create A Skill Association](https://developer.degreed.com/reference/post_api-v2-organization-skills-id-relationships-associated-skills.md): This endpoint creates an association between skills for the current organization.

Required Scope

`skill:write` - [Add Skill Review Groups to a Skill](https://developer.degreed.com/reference/post_api-v2-organization-skills-id-relationships-skill-review-groups.md): This endpoint adds Skill Review groups to a skill in the current organization. When you add Skill Review groups to a skill, the Skill Review-enabled skill will only be visible to the specified groups.

Required Scope

`skill:write` - [Create a New Skill](https://developer.degreed.com/reference/post_api-v2-organization-skills.md): This endpoint creates a new skill for the current organization.

Required Scope

`skill:write` - [Delete Collaborators in a Pathway](https://developer.degreed.com/reference/delete_api-v2-pathways-id-relationships-collaborators.md): This endpoint deletes the specified collaborators in a pathway. It returns a `204 No Content` response.

**Note:** This endpoint accepts up to 100 tags.

Required Scope

`pathways:write` - [Delete Followers from a Pathway](https://developer.degreed.com/reference/delete_api-v2-pathways-id-relationships-followers.md): This endpoint deletes the specified followers from a pathway. It returns a `204 No Content` response.

**Note:** This endpoint accepts up to 100 followers.

Required Scope

`pathways:write` - [Delete Groups in a Pathway](https://developer.degreed.com/reference/delete_api-v2-pathways-id-relationships-groups.md): This endpoint deletes the specified groups in a pathway. It returns a `204 No Content` response.

**Note:** This endpoint accepts up to 100 groups.

Required Scope

`pathways:write` - [Delete Tags in a Pathway](https://developer.degreed.com/reference/delete_api-v2-pathways-id-relationships-tags.md): This endpoint deletes the specified tags in a pathway. It returns a `204 No Content` response.

**Note:** This endpoint accepts up to 100 tags.

Required Scope

`pathways:write` - [Delete Resources in a Subsection of a Pathway](https://developer.degreed.com/reference/delete_api-v2-pathways-id-sections-section-id-lessons-lesson-id-relationships-resources.md): This endpoint deletes the entire existing collection of resources within the identified section of an existing Pathway. On a successful delete, a `204 No Content` response is returned.

Required Scope

`pathways:write` - [Delete a Section in a Pathway](https://developer.degreed.com/reference/delete_api-v2-pathways-id-sections-section-id.md): This endpoint deletes the specified section and any nested resources in an existing Pathway. On a successful deletion, it returns a `204 No Content` response.

Required Scope

`pathways:write` - [Delete a Specific Pathway](https://developer.degreed.com/reference/delete_api-v2-pathways-id.md): This endpoint removes a pathway from the organization. On a successful delete, it returns a `204 No Content` response.

Required Scope

`pathways:write` - [Get All Collaborators for a Pathway](https://developer.degreed.com/reference/get_api-v2-pathways-id-collaborators.md): This endpoint retrieves all collaborators for the selected pathway.

Required Scope

`pathways:read` - [Get All Completions for a Pathway](https://developer.degreed.com/reference/get_api-v2-pathways-id-completions.md): This endpoint retrieves all completions for the specified pathway. To retrieve results, you must enter a created before and created after date to the required filters, with a maximum range of 7 days.

Required Scope

`pathways:read` - [Get All Followers for a Pathway](https://developer.degreed.com/reference/get_api-v2-pathways-id-followers.md): This endpoint retrieves all followers for the selected pathway.

Required Scope

`pathways:read` - [Get All Groups for a Pathway](https://developer.degreed.com/reference/get_api-v2-pathways-id-groups.md): This endpoint retrieves all groups for the selected pathway.

Required Scope

`pathways:read` - [Get a Subsection of a Pathway](https://developer.degreed.com/reference/get_api-v2-pathways-id-sections-section-id-lessons-lesson-id.md): This endpoint retrieves the subsection (lesson) and all its resources in an existing Pathway.

Required Scope

`pathways:write` or `pathways:read`. - [Get a Section of a Pathway](https://developer.degreed.com/reference/get_api-v2-pathways-id-sections-section-id.md): This endpoint returns all section details for the specified section of an existing Pathway.

Required Scope

`pathways:read` or `pathways:write` - [Get All Tags for a Pathway](https://developer.degreed.com/reference/get_api-v2-pathways-id-tags.md): This endpoint retrieves all tags for the selected pathway.

Required Scope

`pathways:read` - [Get a Specific Pathway](https://developer.degreed.com/reference/get_api-v2-pathways-id.md): This endpoint retrieves all data on a specific pathway.

Required Scope

`pathways:read` or `pathways:write` - [Get All Pathways](https://developer.degreed.com/reference/get_api-v2-pathways.md): This endpoint retrieves all pathways for the current organization.

Required Scope

`pathways:read` or `pathways:write` - [Pathway](https://developer.degreed.com/reference/pathway.md) - [Update Resources in a Subsection of a Pathway](https://developer.degreed.com/reference/patch_api-v2-pathways-id-sections-section-id-lessons-lesson-id-relationships-resources.md): This endpoint replaces the entire existing collection of resources within the identified section of an existing Pathway. The sequence will be in the order they appear in the array. All new resources added will default to `Required`. If all resources are successfully updated, a `200 OK` response is returned. Any resources that could not be updated will be identified in the response.

Required Scope

`pathways:write` - [Update a Section in a Pathway](https://developer.degreed.com/reference/patch_api-v2-pathways-id-sections-section-id.md): This endpoint updates the specified section in an existing Pathway.

Required Scope

`pathways:write` - [Update a Specific Pathway](https://developer.degreed.com/reference/patch_api-v2-pathways-id.md): This endpoint updates supplied fields for a specific pathway.

**Note:** The 'PATCH' endpoint does not support updating the 'sections' attribute of a Pathway with more than a 250 combined total of sections, subsections (lessons), and resources. If the 'sections' attribute is included in the 'PATCH', the entire sections array will be replaced for the Pathway.

Required Scope

`pathways:write` - [Add Collaborators to a Pathway](https://developer.degreed.com/reference/post_api-v2-pathways-id-relationships-collaborators.md): This endpoint adds collaborators to an existing pathway. On a successful add, it returns a `201 Created` response with no body.

**Note:** This endpoint accepts up to 100 collaborators.

Required Scope

`pathways:write` - [Add Followers to a Pathway](https://developer.degreed.com/reference/post_api-v2-pathways-id-relationships-followers.md): This endpoint adds followers to an existing pathway. On a successful add, it returns a `201 Created` response with no body.

**Note:** This endpoint accepts up to 100 followers.

Required Scope

`pathways:write` - [Add Groups to a Pathway](https://developer.degreed.com/reference/post_api-v2-pathways-id-relationships-groups.md): This endpoint adds groups to an existing pathway. On a successful add, it returns a `201 Created` response with no body.

**Note:** This endpoint accepts up to 100 groups.

Required Scope

`pathways:write` - [Add Tags to a Pathway](https://developer.degreed.com/reference/post_api-v2-pathways-id-relationships-tags.md): This endpoint adds tags to an existing pathway. On a successful add, it returns a `201 Created` response with no body.

**Note:** This endpoint accepts up to 100 tags.

Required Scope

`pathways:write` - [Add Resources to a Subsection in a Pathway](https://developer.degreed.com/reference/post_api-v2-pathways-id-sections-section-id-lessons-lesson-id-relationships-resources.md): This endpoint adds resources to a subsection of an existing Pathway. The resources will append to the end of the existing sequence in the order they appear in the array. All new resources added will default to `Required`. If all resources are successfully added to the section, a `200 OK` response is returned. Any resources that could not be added will be identified in the response.

Required Scope

`pathways:write`. - [Add a Subsection to a Pathway](https://developer.degreed.com/reference/post_api-v2-pathways-id-sections-section-id-lessons.md): This endpoint adds a subsection (lesson) to an existing section in a Pathway.

Required Scope

`pathways:write` - [Add a Section to a Pathway](https://developer.degreed.com/reference/post_api-v2-pathways-id-sections.md): This endpoint adds a new section to an existing Pathway.

Required Scope

`pathways:write` - [Create a New Pathway](https://developer.degreed.com/reference/post_api-v2-pathways.md): This endpoint creates a new pathway in the system.

Required Scope

`pathways:write` - [Delete a Provider License for a User](https://developer.degreed.com/reference/delete_api-v2-providers-id-relationships-license-holders.md): This endpoint deletes a license-holder relationship between the provider and the users listed in the body.

Required Scope

`provider_users:write` - [Get All Content for a Provider](https://developer.degreed.com/reference/get_api-v2-providers-id-content.md): This endpoint retrieves content for a specific provider. Use `filter[catalog]` to specify the type of content to retrieve. For example, public content, organization provider content, or shared content.

Required Scope

`content:read` or `content:write` - [Get All Provider Licenses](https://developer.degreed.com/reference/get_api-v2-providers-id-licenses.md): This endpoint retrieves all provider licenses for a specific provider.

Required Scope

`providers:read` - [Get a Specific Provider](https://developer.degreed.com/reference/get_api-v2-providers-id.md): This endpoint retrieves a specific provider.

Required Scope

`providers:read` - [Get All Providers](https://developer.degreed.com/reference/get_api-v2-providers.md): This endpoint retrieves all providers for the current organization.

Required Scope

`providers:read` - [Provider](https://developer.degreed.com/reference/provider.md) - [Create a Provider License for a User](https://developer.degreed.com/reference/post_api-v2-providers-id-relationships-license-holders.md): This endpoint creates a license-holder for a specific provider.

Required Scope

`provider_users:write` - [Delete a Specific Recommended Learning Item](https://developer.degreed.com/reference/delete_api-v2-recommended-learning-id.md): This endpoint deletes a recommended learning item from Degreed. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the recommended learning item belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`recommended_learning:write` - [Get a Specific Recommended Learning Item](https://developer.degreed.com/reference/get_api-v2-recommended-learning-id.md): This endpoint retrieves a specific recommended learning item.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return recommended learning items for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`recommended_learning:read` or `recommended_learning:write` - [Get All Recommended Learning Items](https://developer.degreed.com/reference/get_api-v2-recommended-learning.md): This endpoint retrieves all recommended learning items for the current organization. The recommended learning endpoint requires a start and end date, with a maximum range of 7 days.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return learning items for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`recommended_learning:read` or `recommended_learning:write` - [Update a Specific Recommended Learning Item](https://developer.degreed.com/reference/patch_api-v2-recommended-learning-id.md): This endpoint updates supplied fields for a specific recommended learning.

Required Scope

`recommended_learning:write` - [Create a New Recommended Learning Item](https://developer.degreed.com/reference/post_api-v2-recommended-learning.md): This endpoint creates a new recommended learning item.

For Global Admin Tool Organizations, the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`recommended_learning:write` - [Delete a Specific Required Learning](https://developer.degreed.com/reference/delete_api-v2-required-learning-id.md): This endpoint deletes a required learning item from Degreed. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the required learning item belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`required_learning:write` - [Get a Specific Required Learning](https://developer.degreed.com/reference/get_api-v2-required-learning-id.md): This endpoint retrieves a specific required learning item.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return required learning items for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`required_learning:read` or `required_learning:write` - [Get All Required Learning Items](https://developer.degreed.com/reference/get_api-v2-required-learning.md): This endpoint retrieves all required learning items for the current organization. The required learning endpoint requires a start and end date, with a maximum range of 7 days.

**Note:** Information on completed items is not retrieved unless you use the `filter[status]` URL parameter.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return required learning items for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`required_learning:read` - [RequiredLearning](https://developer.degreed.com/reference/requiredlearning.md) - [Update a Specific Required Learning](https://developer.degreed.com/reference/patch_api-v2-required-learning-id.md): This endpoint updates supplied fields for a specific required learning.

Required Scope

`required_learning:write` - [Create a New Required Learning](https://developer.degreed.com/reference/post_api-v2-required-learning.md): This endpoint creates a new required learning item.

For Global Admin Tool Organizations, the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`required_learning:write` - [Get All Search Terms](https://developer.degreed.com/reference/get_api-v2-search-terms.md): This endpoint retrieves (up to) the top 100 search terms for the current organization.

**Note:** The total number of records returned may vary because some search terms have been searched the same quantity.

Required Scope

`search_terms:read` - [Delete a Specific Self-Enrolled Learning Item](https://developer.degreed.com/reference/delete_api-v2-self-enrolled-learning-id.md): This endpoint deletes a specific self-enrolled learning item from Degreed. On a successful delete, it returns a `204 No Content` response.

Required Scope

`self_enrolled_learning:write` - [Get a Specific Self-Enrolled Learning Item](https://developer.degreed.com/reference/get_api-v2-self-enrolled-learning-id.md): This endpoint retrieves a specific self-enrolled learning item.

Required Scope

`self_enrolled_learning:write` or `self_enrolled_learning:read` - [Get All Self-Enrolled Learning Items](https://developer.degreed.com/reference/get_api-v2-self-enrolled-learning.md): This endpoint retrieves all self-enrolled learning items. This endpoint requires a start and end date, with a maximum range of 7 days.

Required Scope

`self_enrolled_learning:write` or `self_enrolled_learning:read` - [Update a Self-Enrolled Learning Item](https://developer.degreed.com/reference/patch_api-v2-self-enrolled-learning-id.md): This endpoint updates supplied fields for a specific self-enrolled learning item.

Required Scope

`self_enrolled_learning:write` - [Create a New Self-Enrolled Learning Item](https://developer.degreed.com/reference/post_api-v2-self-enrolled-learning.md): This endpoint creates a new self-enrolled learning item.

Required Scope

`self_enrolled_learning:write` - [Get a Specific Shared Item](https://developer.degreed.com/reference/get_api-v2-shared-items-id.md): This endpoint retrieves all information on a specific shared item.

Required Scope

`shared_items:read` - [Get All Shared Items](https://developer.degreed.com/reference/get_api-v2-shared-items.md): This endpoint retrieves all shared items (previously known as `recommendations`) for the current organization. Shared Items requires a start and end date, where the maximum range is 7 days.

Required Scope

`shared_items:read` - [SharedItem](https://developer.degreed.com/reference/shareditem.md) - [Get All Skills (Deprecated)](https://developer.degreed.com/reference/get_api-v2-skills.md): This endpoint retrieves all skills for the current organization. This is a legacy endpoint. Please use /organization-skills instead.

Required Scope

`skill:read` - [Skill](https://developer.degreed.com/reference/skill.md) - [Delete Collaborators from a Skill Plan](https://developer.degreed.com/reference/delete_api-v2-skill-plans-id-relationships-collaborators.md): This endpoint deletes the specified collaborators from a skill plan. It returns a `204 No Content` response.

**Note:** This endpoint accepts up to 100 collaborators.

Required Scope

`skill_plans:write` - [Delete Followers from a Skill Plan](https://developer.degreed.com/reference/delete_api-v2-skill-plans-id-relationships-followers.md): This endpoint deletes the specified followers from a skill plan. It returns a `204 No Content` response.

**Note:** This endpoint accepts up to 100 followers.

Required Scope

`skill_plans:write` - [Delete Resources in a Section of a Skill Plan](https://developer.degreed.com/reference/delete_api-v2-skill-plans-id-sections-section-id-relationships-resources.md): This endpoint deletes the entire existing collection of resources within the identified section of an existing Skill Plan. On a successful delete, a `204 No Content` response is returned.

Required Scope

`skill_plans:write` - [Delete a Section in a Skill Plan](https://developer.degreed.com/reference/delete_api-v2-skill-plans-id-sections-section-id.md): This endpoint deletes the specified section and any nested resources in an existing skill plan. On a successful deletion, it returns a `204 No Content` response.

Required Scope

`skill_plans:write` - [Delete a Specific Skill Plan](https://developer.degreed.com/reference/delete_api-v2-skill-plans-id.md): This endpoint removes a skill plan from the organization. On a successful delete, it returns a `204 No Content` response.

Required Scope

`skill_plans:write` - [Get All Collaborators of a Skill Plan](https://developer.degreed.com/reference/get_api-v2-skill-plans-id-collaborators.md): This endpoint retrieves all collaborators for a specific skill plan.

Required Scope

`skill_plans:read` or `skill_plans:write` - [Get All Followers of a Skill Plan](https://developer.degreed.com/reference/get_api-v2-skill-plans-id-followers.md): This endpoint retrieves all followers for a specific skill plan.

Required Scope

`skill_plans:read` or `skill_plans:write` - [Get a Section of a Skill Plan](https://developer.degreed.com/reference/get_api-v2-skill-plans-id-sections-section-id.md): This endpoint returns all section details for the specified section of an existing skill plan.

Required Scope

`skill_plans:read` or `skill_plans:write` - [Get a Specific Skill Plan](https://developer.degreed.com/reference/get_api-v2-skill-plans-id.md): This endpoint retrieves all information on a specific skill plan.

**Note:** The `collaborators` attribute will be removed from this resource in a future release. Please use the `collaborators` relationship and `included` object instead.

Required Scope

`skill_plans:read` or `skill_plans:write` - [Get All Skill Plans](https://developer.degreed.com/reference/get_api-v2-skill-plans.md): This endpoint retrieves all skill plans for the current organization.

Required Scope

`skill_plans:read` or `skill_plans:write` - [SkillPlan](https://developer.degreed.com/reference/skillplan.md) - [Update Resources in a Section of a Skill Plan](https://developer.degreed.com/reference/patch_api-v2-skill-plans-id-sections-section-id-relationships-resources.md): This endpoint replaces the entire existing collection of resources within the identified section of an existing Skill Plan. The sequence will be in the order they appear in the array. If all resources are successfully updated, a `200 OK` response is returned. Any resources that could not be updated will be identified in the response.

Required Scope

`skill_plans:write` - [Update a Section in a Skill Plan](https://developer.degreed.com/reference/patch_api-v2-skill-plans-id-sections-section-id.md): This endpoint updates the specified section in an existing skill plan. On a successful update, it returns a `200 OK` response.

Required Scope

`skill_plans:write` - [Update a Specific Skill Plan](https://developer.degreed.com/reference/patch_api-v2-skill-plans-id.md): This endpoint updates supplied fields for a specific skill plan.

**Note:** The 'PATCH' endpoint does not support updating the 'sections' attribute of a Skill Plan with more than a 250 combined total of sections and resources. If the 'sections' attribute is included in the 'PATCH', the entire sections array will be replaced for the Skill Plan.

Required Scope

`skill_plans:write` - [Add Collaborators to a Skill Plan](https://developer.degreed.com/reference/post_api-v2-skill-plans-id-relationships-collaborators.md): This endpoint adds collaborators to an existing skill plan. On a successful add, it returns a `201 Created` response with no body.

**Note:** This endpoint accepts up to 100 collaborators.

Required Scope

`skill_plans:write` - [Add Followers to a Skill Plan](https://developer.degreed.com/reference/post_api-v2-skill-plans-id-relationships-followers.md): This endpoint adds followers to an existing skill plan. On a successful add, it returns a `201 Created` response with no body.

**Note:** This endpoint accepts up to 100 followers.

Required Scope

`skill_plans:write` - [Add Resources to a Section in a Skill Plan](https://developer.degreed.com/reference/post_api-v2-skill-plans-id-sections-section-id-relationships-resources.md): This endpoint adds resources to a section of an existing Skill Plan. The resources will append to the end of the existing sequence in the order they appear in the array. If all resources are successfully added to the section, a `200 OK` response is returned. Any resources that could not be added will be identified in the response.

Required Scope

`skill_plans:write`. - [Add a Section to a Skill Plan](https://developer.degreed.com/reference/post_api-v2-skill-plans-id-sections.md): This endpoint adds a new section to an existing skill plan. On a successful add, it returns a `201 Created` response.

Required Scope

`skill_plans:write` - [Create a New Skill Plan](https://developer.degreed.com/reference/post_api-v2-skill-plans.md): This endpoint creates a new skill plan in the system.

Required Scope

`skill_plans:write` - [Delete a Specific Skill Rating](https://developer.degreed.com/reference/delete_api-v2-skill-ratings-userskillratingid.md): This endpoint deletes a skill rating from Degreed. On a successful delete, it returns a `204 No Content` response.

Required Scope

`skill_ratings:write` - [Get a Specific Skill Rating](https://developer.degreed.com/reference/get_api-v2-skill-ratings-userskillratingid.md): This endpoint retrieves a specific skill rating for the current organization.

Required Scope

`skill_ratings:read` or `skill_ratings:write` - [Get All Skill Ratings](https://developer.degreed.com/reference/get_api-v2-skill-ratings.md): This endpoint retrieves all skill ratings for the current organization.

Required Scope

`skill_ratings:read` or `skill_ratings:write` - [Create a New Skill Rating](https://developer.degreed.com/reference/post_api-v2-skill-ratings.md): This endpoint creates a new skill rating for a user.

Required Scope

`skill_ratings:write` - [Remove Skills from a Category](https://developer.degreed.com/reference/delete_api-v2-skill-categories-id-relationships-skills.md): Removes the association between a specific skill and a skill category in Skills+.

Required Scope

`skill:write` - [Delete a Specific Skill Category](https://developer.degreed.com/reference/delete_api-v2-skill-categories-id.md): This endpoint deletes a specific skill category in Skills+.

Required Scope

`skill:write` - [Delete a Skill Suggestion](https://developer.degreed.com/reference/delete_api-v2-skill-suggestions-id.md): This endpoint deletes a skill suggestion. Your organization must have Skills+ enabled to use this endpoint.

Required Scope

`skill_suggestions:write` - [Get a Specific Skill Category](https://developer.degreed.com/reference/get_api-v2-skill-categories-id.md): This endpoint retrives a specific skill category.

Required Scope

`skill:read` - [Get All Skill Categories](https://developer.degreed.com/reference/get_api-v2-skill-categories.md): This endpoint retrieves a list of all skill categories in Skills+ for the current organization.

Required Scope

`skill:read` or `skill:write` - [Get A Specific Skill](https://developer.degreed.com/reference/get_api-v2-skills-plus-skills-id.md): This endpoint retrieves a specific skill in Skills+ for your organization.

Required Scope

`skill:read` - [Get All Skills](https://developer.degreed.com/reference/get_api-v2-skills-plus-skills.md): This endpoint retrieves all skills in Skills+ for your organization.

Required Scope

`skill:read` - [Get All Skill Sources](https://developer.degreed.com/reference/get_api-v2-skillsources.md): This endpoint retrieves all skill sources in Skills+ for your organization.

Required Scope

`skill:read` - [Skills+](https://developer.degreed.com/reference/skills.md) - [Update a Skill Category](https://developer.degreed.com/reference/patch_api-v2-skill-categories-id.md): This endpoint updates a specific skill category in Skills+.

Required Scope

`skill:write` - [Update a Skill](https://developer.degreed.com/reference/patch_api-v2-skills-plus-skills-id.md): This endpoint updates a specific skill in Skills+.

Required Scope

`skill:write` - [Add Skills to a Category](https://developer.degreed.com/reference/post_api-v2-skill-categories-id-relationships-skills.md): Associate one or more skills to a Skill Category in Skills+ for your organization.

Required Scope

`skill:write` - [Create a Skill Category](https://developer.degreed.com/reference/post_api-v2-skill-categories.md): This endpoint creates a new skill category in Skills+. Categories may align to job roles, skill sets, or be defined by company/industry best practices.

Required Scope

`skill:write` - [Create a Skill Suggestion](https://developer.degreed.com/reference/post_api-v2-skill-suggestions.md): This endpoint creates a skill suggestion. Your organization must have Skills+ enabled to use this endpoint.

Required Scope

`skill_suggestions:write` - [Create A Skill](https://developer.degreed.com/reference/post_api-v2-skills-plus-skills.md): This endpoint creates a skill in Skills+ for your organization.

Required Scope

`skill:write` - [Delete Custom Attributes for a User](https://developer.degreed.com/reference/delete_api-v2-user-custom-attributes-id.md): This endpoint deletes custom attributes for the specified user.

Required Scope

`custom_attribute:write` - [Get A Specific User Custom Attribute](https://developer.degreed.com/reference/get_api-v2-user-custom-attributes-id.md): This endpoint retrieves a specific user custom attribute for the current organization.

Required Scope

`custom_attribute:write` or `custom_attribute:read` - [Get All User Custom Attributes](https://developer.degreed.com/reference/get_api-v2-user-custom-attributes.md): This endpoint retrieves all user custom attributes for the current organization.

Required Scope

`custom_attribute:write` or `custom_attribute:read` - [User Custom Attributes](https://developer.degreed.com/reference/user-custom-attributes.md) - [Update User Custom Attributes](https://developer.degreed.com/reference/patch_api-v2-user-custom-attributes-id.md): This endpoint updates the collection of custom attributes for a user within the organization.

Required Scope

`custom_attribute:write` - [Create a New User Custom Attribute](https://developer.degreed.com/reference/post_api-v2-user-custom-attributes.md): This endpoint creates a collection of custom attributes for a user within the organization. You must register a custom attribute using the POST endpoint for custom attributes in order to assign values to users associated with the attribute. For more information, see [User Custom Attributes](https://developer.degreed.com/reference/user-custom-attributes).

Required Scope

`custom_attribute:write` - [Delete a Specific User](https://developer.degreed.com/reference/delete_api-v2-users-id.md): This endpoint removes a user from the organization. On a successful delete, it returns a `204 No Content` response.

For Global Admin Tool Organizations, if the user belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`users:write` - [Get Accomplishments for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-accomplishments.md): This endpoint retrieves all accomplishments for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//accomplishments?identifier=email`

Required Scope

`users:read`, `users:write`, `accomplishments:read` or `accomplishments:write` - [Get Certificates for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-certificates.md): This endpoint retrieves all certificates for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//certificates?identifier=email`

Required Scope

`users:read`, `users:write`, `certificates:read` or `certificates:write` - [Get Completions for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-completions.md): This endpoint retrieves all completions for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//completions?identifier=email`

For Global Admin Tool Organizations, if the user belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`users:read`, `users:write`, `completions:read` or `completions:write` - [Get All Experiences for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-experiences.md): This endpoint retrieves all experiences for a specific user.

Required Scope

`experiences:read` or `experiences:write` - [Get Groups for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-groups.md): This endpoint retrieves all groups for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//groups?identifier=email`

Required Scope

`users:read`, `users:write`, `groups:read` or `groups:write` - [Get All Provider Licenses by User](https://developer.degreed.com/reference/get_api-v2-users-id-license-issuers.md): This endpoint retrieves all providers that issued a license for a specific user.

Required Scope

`provider_users:read` - [Get Opportunities for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-opportunities.md): This endpoint retrieves all opportunites for the specified user.

Required Scope

`opportunity:read` or `opportunity:write` - [Get Resources for a Specific User and a Specific Pathway](https://developer.degreed.com/reference/get_api-v2-users-id-pathways-pathway-id-resources.md): This endpoint retrieves all resources for a specific user and a specific pathway. You can retrieve the resources by specifying the User ID as a path parameter and the Pathway ID as a path parameter. For example, `https://api.betatest.degreed.com/api/v2/users//pathways/resources?`

Required Scope

`users:read`, `users:write` - [Get Pathways for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-pathways.md): This endpoint retrieves all pathways for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//pathways?identifier=email`

Required Scope

`users:read`, `users:write`, `pathways:read` - [Get Recommended Learning for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-recommended-learning.md): This endpoint retrieves all recommended learning for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//recommended-learning?identifier=email`

Required Scope

`users:read`, or `users:write` - [Get Required Learning for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-required-learning.md): This endpoint retrieves all required learning for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//required-learning?identifier=email`

For Global Admin Tool Organizations, if the user belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`users:read`, `users:write`, `required_learning:read` or `required_learning:write` - [Get All Self-Enrolled Learning for Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-self-enrolled.md): This endpoint retrieves all self-enrolled learning for a specific user.

Required Scope

`self-enrolled-learning:read` or `self-enrolled-learning:write` - [Get Shared Items for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-shared-items.md): This endpoint retrieves all items shared by a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//shared-items?identifier=email`

Required Scope

`users:read`, `users:write`, `shared-items:read` `shared-items:write`, or `recommendations:read` - [Get Skill Plans for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-skill-plans.md): This endpoint retrieves all skill plans for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//skill-plans?identifier=email`

Required Scope

`users:read`, `users:write`, `skill_plans:read` - [Get Skill Ratings for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-skill-ratings.md): This endpoint retrieves all skill ratings for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//skill-ratings?identifier=email`

Required Scope

`users:read`, `users:write`, `skill_ratings:read` or `skill_ratings:write` - [Get Skill Suggestions for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-skill-suggestions.md): This endpoint retrieves all skill suggestions for a specific user. Your organization must have Skills+ enabled to use this endpoint.

Required Scope

`skill_suggestions:read` or `skill_suggestions:write` - [Get Today's Learning for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-todays-learning.md): This endpoint retrieves all of today's learning for a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//todays-learning?identifier=email`

**Note:** This endpoint retrieves user data that is refreshed when a user logs into Degreed through the UI. Users must have Daily Digest Emails or Weekly Digest Emails enabled or log in to Degreed every 48 hours to return updated results.

Required Scope

`users:read`, `users:write` or `todays_learning:read` - [Get All Badges for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-user-badges.md): This endpoint retrieves all badges for a specific user.

Required Scope

`badges_users:read` - [Get User Custom Attributes for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-user-custom-attributes.md): This endpoint retrieves the user custom attributes for a specific user in the current organization.

Required Scope

`custom_attribute:write` or `custom_attribute:read` - [Get User Skills for a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id-user-skills.md): This endpoint retrieves all user skills for a specific user. The ID can be any of the ID as shown in the API, employee ID, or email address. You can use the identifier URL parameter to switch between types. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users//user-skills?identifier=email`

Required Scope

`users:read`, `users:write` or `user_skills:read` - [Get a Specific User](https://developer.degreed.com/reference/get_api-v2-users-id.md): This endpoint retrieves a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, `https://api.betatest.degreed.com/api/v2/users/?identifier=email`

For Global Admin Tool Organizations, if the user belongs to a Tenant Organization, then the `X-Degreed-Organization-Code` header must be provided.

Required Scope

`users:read` or `users:write` - [Get All Users](https://developer.degreed.com/reference/get_api-v2-users.md): This endpoint retrieves all users for the current organization.

For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will return users for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

`users:read` or `users:write` - [User](https://developer.degreed.com/reference/user.md) - [Update a Specific User](https://developer.degreed.com/reference/patch_api-v2-users-id.md): This endpoint updates supplied fields for a specific user.

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

**Note:**
  • The manager assigned to the user must have an employee id to be valid.
  • In order to use the `job-role` parameter, you must have the job role setting enabled for your organization. Contact your Degreed Technical Solutions Specialist for assistance.
  • `profile-visibility` cannot be modified using `PATCH`.

Required Scope

`users:write` - [Create a New User](https://developer.degreed.com/reference/post_api-v2-users.md): This endpoint creates a new user in the system.

For Global Admin Tool Organizations, if the user is to be created in a Tenant Organization, the `X-Degreed-Organization-Code` header must be provided.

**Note:** The manager assigned to the user must have an employee id to be valid.

In order to use the `job-role` parameter, you must have the job role setting enabled for your organization. Contact your Degreed Technical Solutions Specialist for assistance.

Required Scope

`users:write` - [Get All User Followers](https://developer.degreed.com/reference/get_api-v2-user-followers.md): This endpoint retrieves all followers of a user for the current organization.

Required Scope

`users:read` - [Delete a Specific User Skill](https://developer.degreed.com/reference/delete_api-v2-user-skills-userskillid.md): This endpoint deletes a user skill from Degreed. On a successful delete, it returns a `204 No Content response`.

Required Scope

`user_skills:write` - [Get a Specific User Skill](https://developer.degreed.com/reference/get_api-v2-user-skills-userskillid.md): This endpoint retrieves a specific user skill.

Required Scope

`user_skills:read` - [Get All User Skills](https://developer.degreed.com/reference/get_api-v2-user-skills.md): This endpoint retrieves all user skills for the current organization.

Required Scope

`user_skills:read` - [Update a Specific User Skill](https://developer.degreed.com/reference/patch_api-v2-user-skills-userskillid.md): This endpoint updates a specific user skill.

Required Scope

`user_skills:read` - [Create a New User Skill](https://developer.degreed.com/reference/post_api-v2-user-skills.md): This endpoint creates a new relationship between a user and a skill. If the skill doesn't exist yet, the system creates it. To identify the user you can either supply the `UserId`, `Email` or `EmployeeId`.

Required Scope

`user_skills:write` - [Get All Views](https://developer.degreed.com/reference/get_api-v2-views.md): This endpoint retrieves all views within the current organization. You must specify a start and end date with a maximum range of 7 days.

Required Scope

`views:read` - [Get All Statements](https://developer.degreed.com/reference/get_xapi-statements.md): This endpoint retrieves all xAPI statements for the current organization.

Required Scope

`xapi:read` or `xapi:write` - [xAPI](https://developer.degreed.com/reference/xapi.md) - [Sending Statements](https://developer.degreed.com/reference/post_xapi-statements.md): This endpoint creates a new statement.

Required Scope

`xapi:write` ## Recipes - [Get Details for All Content Items](https://developer.degreed.com/recipes/get-details-for-all-content-items.md) - [Make Your First API Call](https://developer.degreed.com/recipes/make-your-first-api-call.md) ## Pages - [Degreed Developers Blog](https://developer.degreed.com/apis-the-blog-at-degreed.md) - [Authentication](https://developer.degreed.com/athentication.md) - [Rate Limiting](https://developer.degreed.com/rate-limiting.md) ## Changelog - [June 2026](https://developer.degreed.com/changelog/june-2026.md) - [March 2026](https://developer.degreed.com/changelog/march-2026.md) - [February 2026](https://developer.degreed.com/changelog/february-2026.md) - [January 2026](https://developer.degreed.com/changelog/january-2026.md) - [December 2025](https://developer.degreed.com/changelog/december-2025.md)