Changelog

The following changes to the API are categorized by release. These changes are also reflected in the documentation.

September 2022

Fixed

  • The xAPI formerly reported the Pathway in which a content item was completed. We fixed a bug that stopped that from happening. (PD-77722)

August 2022

Removed

  • The Groups endpoint formerly returned null for modified-at because Degreed does not log this data. This attribute has been removed. This is technically a breaking change. We hope that nobody was using the null value and apologize for any inconvenience. We will not make a habit of breaking changes.

New

  • The /skill-plans endpoint now supports retrieving, adding, and deleting collaborators on a Skill Plan.

Documentation

July 2022

Fixed

  • When a completion POST is executed, the response body correctly notes the time the request was submitted as the resource creation time. (PD-76491)
  • The API now presents the correct skill target ratings when retrieving a Skill Plan. (PD-77149)
  • The error messaging for the Opportunities endpoint is now improved. (PD-77171)

Documentation

  • Added X-Degreed-Organization-Code header to endpoints that work with GAT.
  • Added filter[term]=<keyword> query parameter filter for GET ALL Content endpoints. The filter criteria returns content that contains the keyword in the title, summary, or labels.

June 2022

New

  • The /skill-plans endpoint now supports creating, modifying, and deleting a Skill Plan.
  • The /pathways endpoint now supports creating, modifying, and deleting a Pathway.

Documentation

  • Added duration and date attributes to Event content items.
  • Updated description for daily-logins in Get a Specific User.

May 2022

Fixed

  • We resolved an issue that caused the API’s Skills endpoint to time out unexpectedly. (PD-74126)
  • We resolved an issue that prevented using the API to add Skills to Podcast content items. (PD-73821)
  • We improved the error message that displays when you try to create a completion via the API but do so incorrectly. (PD-73643)
  • We resolved an issue that prevented the date and duration information of an Event from being accessible via the API. This information is now accessible via the API.
    Note: this bug did not pertain to events with specific times of day, which are not yet supported by the API. (PD-74415, PD-75282)

Documentation

March 2022

New

  • New API Developer Portal released.
  • Opportunity endpoint added.

January 2022

New

November 2021

New

Fixed

  • Delete Skills from content returns a 204 on success as documented.
  • Prevent in-active provider's content from being returned in the api for content endpoints.
  • Add collaborators relationship to Get a Specific Skill Plan.
  • On specific content endpoints the filter[internal_only] is applied when using the filter[external_id] query parameter.
  • Allow all completions for provider content to be returned in the api.

Documentation

October 2021

New

  • Allow content restricted to visibility groups to be returned in the content endpoints.

Fixed

  • Update documentation to describe date filters available on content endpoints.

September 2021

New

  • Allow visibility groups to be set when you create content.
  • Allow retrieval or replacement of visibility groups for content items.

August 2021

New

July 2021

New

June 2021

New

  • Added external-id and tags as object extensions to statements in the xAPI.

May 2021

New

  • Create A New Completion and Get a Specific Completion support creating and retrieving completions within the Global Admin Tool organization structure. These endpoints also support content from Native Providers.
  • List Skills endpoint added.
  • Added plan information to grouping context for viewed and completed statements in the xAPI.

April 2021

New

  • The Completions endpoint now supports tasks and podcasts.
  • Expanded completion creation to allow Organization to create a completion for public content Create A New Completion.
  • New disliked content statement for the xAPI.

March 2021

New

Fixed

  • When content is updated, if the PATCH request contains invalid data an error message will be returned. This affects PATCH requests for the following endpoints: Content: Articles, Content: Books, Content: Videos, Content: Courses, Content: Assessments, Content: Podcasts

February 2021

New

  • Create, Update, and Read endpoints for Content: Books now supports the 'url' attribute.
  • Ability to get group memberships by joined date with endpoint Get a List of Group Memberships

January 2021

Fixed