PUT
/
unified
/
lms
/
content
curl --request PUT \
  --url https://api.stackone.com/unified/lms/content \
  --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 video acts as learning content for software engineers.",
  "languages": [
    {
      "value": "en_GB",
      "source_value": "<string>"
    }
  ],
  "content_url": "https://www.youtube.com/watch?v=16873",
  "mobile_launch_content_url": "https://www.mobile.youtube.com/watch?v=16873",
  "content_type": {
    "value": "video",
    "source_value": "<string>"
  },
  "cover_url": "https://www.googledrive.com/?v=16873",
  "active": true,
  "duration": "P3Y6M4DT12H30M5S",
  "skills": [
    {
      "id": "12345",
      "name": "Sales Techniques"
    }
  ],
  "order": 1,
  "short_description": "This course is a valuable resource and acts as learning content for...",
  "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"
      }
    }
  ],
  "tags": [
    "Sales Techniques",
    "Customer Service"
  ],
  "updated_at": "2021-07-21T14:00:00.000Z",
  "created_at": "2021-07-21T14:00:00.000Z",
  "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>"
      }
    }
  ],
  "additional_data": [
    {
      "id": "learning_outcomes",
      "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "value": "This is additional data"
    }
  ]
}'
{
  "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 content

Example:

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

title
string | null

The title of the content

Example:

"Software Engineer Lv 1"

description
string | null

The description of the content

Example:

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

languages
object[] | null

The languages associated with this content

content_url
string | null

The external URL of the content

Example:

"https://www.youtube.com/watch?v=16873"

mobile_launch_content_url
string | null

The mobile friendly URL of the content

Example:

"https://www.mobile.youtube.com/watch?v=16873"

content_type
object

The type of content

cover_url
string | null

The URL of the thumbnail image associated with the content.

Example:

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

active
boolean | null

Whether the content is active and available for users.

Example:

true

duration
string | null

The duration of the content following the ISO8601 standard. If duration_unit is applicable we will derive this from the smallest unit given in the duration string or the minimum unit accepted by the provider.

Example:

"P3Y6M4DT12H30M5S"

skills
object[] | null

The skills associated with this content

Example:
[
  { "id": "12345", "name": "Sales Techniques" }
]
order
number | null

The order of the individual content within a content grouping. This is not applicable for pushing individual content.

Example:

1

short_description
string | null
deprecated

A short description or summary for the content

Example:

"This course is a valuable resource and acts as learning content for..."

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"
    }
  }
]
tags
string[] | null

A list of tags associated with the content

Example:
["Sales Techniques", "Customer Service"]
updated_at
string | null

The date on which the content was last updated.

Example:

"2021-07-21T14:00:00.000Z"

created_at
string | null

The date on which the content was created.

Example:

"2021-07-21T14:00:00.000Z"

categories
object[] | null

The categories associated with this content

additional_data
object[] | null

The additional_data associated with this content

Response

201
application/json
The content 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