v1

latestOpenAPI 3.0.12026-07-24283883639.5 KB
Recommended Learning

Get a Specific Recommended Learning Item

This endpoint retrieves a specific recommended learning item. <br><br>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. <h3>Required Scope</h3>recommended_learning:read or recommended_learning:write

get/api/v2/recommended-learning/{id}

Path parameters

idstring required
Example:Yxjak6

The ID of the recommended learning item to retrieve.

Headers

X-Degreed-Organization-Codestring
Example:tenant_organization_code

For Global Admin Tool Organizations, this header can be included in your request to get recommended learning items for the tenant organization, but it is not required. 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": {
    "type": "recommended-learning",
    "id": "Yxjak6",
    "attributes": {
      "employee-id": "info@example.com",
      "assignment-type": "RecommendedLearning",
      "status": "Pending",
      "assigner-employee-id": "info@example.com"
    },
    "links": {
      "self": "https://api.staging.degreed.com/api/v2/recommended-learning/Yxjak6"
    },
    "relationships": [
      {
        "user": {
          "data": {
            "id": "yj9kj",
            "type": "users"
          }
        },
        "content": {
          "data": {
            "id": "nNmwVAgd",
            "type": "content"
          }
        },
        "provider": {
          "data": {
            "id": "degreedopenlibrary",
            "type": "providers"
          }
        },
        "assigner": {
          "data": {
            "id": "yj9kj",
            "type": "users"
          }
        }
      }
    ],
    "included": [
      {
        "type": "content",
        "id": "nNmwVAgd",
        "attributes": {
          "content-type": "Video",
          "url": "https://www.youtube.com/watch?v=D33PakstpjI",
          "title": "The Learning Algorithm Using AI to Expand Workforce Learning",
          "provider": "degreedopenlibrary"
        },
        "links": {
          "self": "/content/nNmwVAgd"
        }
      }
    ]
  }
}