PUT
/
unified
/
lms
/
courses
curl --request PUT \
  --url https://api.stackone.com/unified/lms/courses \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '{
  "unified_custom_fields": {
    "my_project_custom_field_1": "REF-1236",
    "my_project_custom_field_2": "some other value"
  },
  "external_reference": "SOFTWARE-ENG-LV1-TRAINING-VIDEO-1",
  "title": "Software Engineer Lv 1",
  "description": "This course acts as learning content for software engineers.",
  "languages": [
    {
      "value": "en_GB",
      "source_value": "<string>"
    }
  ],
  "cover_url": "https://www.googledrive.com/?v=16873",
  "url": "https://www.linkedinlearning.com/?v=16873",
  "active": true,
  "duration": "P3Y6M4DT12H30M5S",
  "categories": [
    {
      "id": "16873-IT345",
      "unified_custom_fields": {
        "my_project_custom_field_1": "REF-1236",
        "my_project_custom_field_2": "some other value"
      },
      "name": "Information-Technology",
      "hierarchy": {
        "value": "primary",
        "source_value": "<string>"
      },
      "level": {
        "value": "primary",
        "source_value": "<string>"
      },
      "language": {
        "value": "en_GB",
        "source_value": "<string>"
      }
    }
  ],
  "skills": [
    {
      "id": "16873-IT345",
      "name": "Information-Technology",
      "hierarchy": {
        "value": "primary",
        "source_value": "<string>"
      },
      "proficiency": {
        "value": "1",
        "source_value": "<string>"
      },
      "language": {
        "value": "en_GB",
        "source_value": "<string>"
      },
      "level": {
        "value": "primary",
        "source_value": "<string>"
      }
    }
  ],
  "content": [
    {
      "external_reference": "SOFTWARE-ENG-LV1-TRAINING-VIDEO-1",
      "title": "Software Engineer Lv 1",
      "description": "This video acts as learning content for software engineers.",
      "content_url": "https://www.youtube.com/watch?v=16873",
      "mobile_launch_content_url": "https://www.mobile.youtube.com/watch?v=16873",
      "order": 1
    }
  ],
  "localizations": [
    {
      "title": "Software Engineer Lv 1",
      "description": "This course acts as learning resource for software engineers.",
      "languages": {
        "value": "en-GB",
        "source_value": "string"
      }
    },
    {
      "title": "Software Engineer: A comprehensive guide",
      "description": "This course acts as learning resource for software engineers.",
      "languages": {
        "value": "en-US",
        "source_value": "string"
      }
    }
  ]
}'
{
  "statusCode": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "external_reference": "SOFTWARE-ENG-LV1-TRAINING-VIDEO-1"
  }
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

x-account-id
string
required

The account identifier

Body

application/json
unified_custom_fields
object | null

Custom Unified Fields configured in your StackOne project

Example:
{
  "my_project_custom_field_1": "REF-1236",
  "my_project_custom_field_2": "some other value"
}
external_reference
string | null

The external ID associated with this course

Example:

"SOFTWARE-ENG-LV1-TRAINING-VIDEO-1"

title
string | null

The title of the course

Example:

"Software Engineer Lv 1"

description
string | null

The description of the course

Example:

"This course acts as learning content for software engineers."

languages
object[] | null

The languages associated with this course

cover_url
string | null

The URL of the thumbnail image associated with the course.

Example:

"https://www.googledrive.com/?v=16873"

url
string | null

The redirect URL of the course.

Example:

"https://www.linkedinlearning.com/?v=16873"

active
boolean | null

Whether the course is active and available for users.

Example:

true

duration
string | null

The duration of the course following the ISO8601 standard. If duration_unit is applicable we will derive this from the smallest unit given in the duration string

Example:

"P3Y6M4DT12H30M5S"

categories
object[] | null

The categories associated with this content

skills
object[] | null

The skills associated with this content

content
object[] | null

The content associated with this course

localizations
object[] | null

The localization data for this course

Example:
[
  {
    "title": "Software Engineer Lv 1",
    "description": "This course acts as learning resource for software engineers.",
    "languages": {
      "value": "en-GB",
      "source_value": "string"
    }
  },
  {
    "title": "Software Engineer: A comprehensive guide",
    "description": "This course acts as learning resource for software engineers.",
    "languages": {
      "value": "en-US",
      "source_value": "string"
    }
  }
]

Response

201
application/json
The course was upserted successfully.
statusCode
number
required
Example:

201

message
string
required
Example:

"Record created successfully."

timestamp
string
required
Example:

"2021-01-01T01:01:01.000Z"

data
object
required