v1

latestOpenAPI 3.0.12026-07-24283883639.5 KB

Content

Get All Content

This endpoint retrieves all content (excluding obsolete content) for the current organization. <br><br>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. <h3>Required Scope</h3>content:read or content:write

get/api/v2/content

Query parameters

nextstring

Retrieves the next batch of content. This value expires after 2 minutes if a request has not been made during that time.

limitinteger

The maximum number of content items to display per page. A maximum of 1000 is allowed.

filter[start_date]string date

Filter criteria that returns content created from this date on. Format yyyy-mm-dd.

filter[end_date]string date

Filter criteria that returns content created before this date. Format yyyy-mm-dd.

filter[modified_before]string date

Filter criteria that returns content modified before this date. Format yyyy-mm-dd.

filter[modified_after]string date

Filter criteria that returns content modified after this date. Format yyyy-mm-dd.

filter[url]string

Filter criteria that only returns content with this URL.

filter[internal_only]boolean

Filter criteria that only returns content internal to the organization.

filter[external_id]string

Filter criteria that only returns content with this external id.

filter[include_restricted]boolean

Filter criteria that returns all content including content restricted to administrative groups.<br><br>Note: When you filter by filter[external_id] or filter[url], the system always returns restricted content. Therefore, filtering by filter[include_restricted] is not useful in these cases.

filter[term]string

Example:keyword

Filter criteria that returns content that contains the keyword in the title, summary, or labels. Results are sorted with more popular and relevant results at the top of the response collection.

filter[skill]string

Example:SQL

Filter criteria that returns content with this associated skill.

filter[visible_to_user]string

Example:R8wVQ

Filter criteria that returns content visible to this user.

filter[language]string

Example:en

Filter criteria that returns content in this language.

filter[content_type]string

Example:course

Filter criteria that only returns content with this content type. Acceptable values are course, event, video, assessment, podcast, book, or task.

filter[is_hosted]boolean

Filter criteria that returns hosted content.

Headers

X-Degreed-Organization-Codestring

Example:tenant_organization_code

For Global Admin Tool Organizations, include this header in your request to retrieve content for the tenant organization. You must provide your organization code as the value. Contact your Degreed technical partner if you are unsure what your organization code is.

Response

Success

Example response

{
  "data": [
    {
      "attributes": {
        "groups-with-access": [],
        "groups-with-access-ids": [],
        "visibility": "Organization"
      },
      "relationships": [
        {
          "Skill": {
            "data": [
              {
                "id": "Test Automation",
                "type": "skill"
              },
              {
                "id": "Software Testing",
                "type": "skill"
              },
              {
                "id": "kyj",
                "type": "skill"
              }
            ]
          }
        }
      ]
    }
  ]
}