Skip to content
Create Learning Content logo

Create Learning Content

Creates new learning content for a specific learning provider. Adds a course, module, or other learning resource to the provider's catalog.

SKILL.md

Full skill instructions

Create Learning Content

Creates new learning content for a specific learning provider. Adds a course, module, or other learning resource to the provider's catalog.

API Details

  • API: Microsoft Teams API
  • Method: POST
  • Path: /​employeeExperience/​learningProviders/​{learningProvider-id}/​learningContents
  • Operation ID: createLearningContent
  • Tag: EmployeeLearning
  • OpenAPI: microsoft-teams-openapi.yaml

Sandbox

Mock server URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0/employeeExperience/learningProviders/{learningProvider-id}/learningContents

Required Headers

  • Authorization: Bearer {access-token}
  • Content-Type: application/​json

Parameters

NameInTypeRequiredDescription
learningProvider-idpathstringYesThe unique identifier of the learning provider

Request Body

FieldTypeRequiredDescription
externalIdstringYesThe external identifier for the content
titlestringYesThe title of the learning content
descriptionstringNoA description of the learning content
contentWebUrlstringNoThe URL to access the content
languageTagstringNoThe language tag (e.g., en-US)
durationstringNoThe duration in ISO 8601 format
formatstringNoThe content format (e.g., video, document)
levelstringNoThe difficulty level (e.g., Beginner, Intermediate, Advanced)
isActivebooleanNoWhether the content is active
isSearchablebooleanNoWhether the content is searchable
{
  "externalId": "course-python-101",
  "title": "Introduction to Python",
  "description": "Learn the basics of Python programming",
  "contentWebUrl": "https://learning.example.com/courses/python-101",
  "languageTag": "en-US",
  "duration": "PT2H30M",
  "format": "video",
  "level": "Beginner",
  "isActive": true,
  "isSearchable": true
}

Example Request

curl -s -X POST \
  "http://localhost:8080/rest/microsoft-teams-api/1.0.0/employeeExperience/learningProviders/provider-001/learningContents" \
  -H "Authorization: Bearer {access-token}" \
  -H "Content-Type: application/​json" \
  -d '{
    "externalId": "course-python-101",
    "title": "Introduction to Python",
    "description": "Learn the basics of Python programming",
    "contentWebUrl": "https://learning.example.com/courses/python-101",
    "languageTag": "en-US",
    "duration": "PT2H30M",
    "format": "video",
    "level": "Beginner",
    "isActive": true,
    "isSearchable": true
  }'

Example Response

{
  "id": "content-001",
  "externalId": "course-python-101",
  "title": "Introduction to Python",
  "description": "Learn the basics of Python programming",
  "contentWebUrl": "https://learning.example.com/courses/python-101",
  "languageTag": "en-US",
  "duration": "PT2H30M",
  "format": "video",
  "level": "Beginner",
  "isActive": true,
  "isSearchable": true
}

Instructions

When the user wants to create or add new learning content to a learning provider, use this operation. Provide the learning provider ID as a path parameter and include the content details such as title, description, URL, format, and level in the request body. The response returns the created learning content with a 201 status code.