MCP
A2AUpsert External Linking Learning Objects
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 '
{
"external_reference": "SOFTWARE-ENG-LV1-TRAINING-VIDEO-1",
"unified_custom_fields": {
"my_project_custom_field_1": "REF-1236",
"my_project_custom_field_2": "some other value"
},
"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",
"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"
],
"authors": [
{
"id": "123",
"name": "John Doe"
}
],
"updated_at": "2021-07-21T14:00:00.000Z",
"created_at": "2021-07-21T14:00:00.000Z",
"passthrough": {
"other_known_names": "John Doe"
},
"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": {
"source_value": "<string>"
},
"level": {
"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"
}
],
"content_type": {
"source_value": "<string>"
}
}
'import requests
url = "https://api.stackone.com/unified/lms/content"
payload = {
"external_reference": "SOFTWARE-ENG-LV1-TRAINING-VIDEO-1",
"unified_custom_fields": {
"my_project_custom_field_1": "REF-1236",
"my_project_custom_field_2": "some other value"
},
"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",
"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"],
"authors": [
{
"id": "123",
"name": "John Doe"
}
],
"updated_at": "2021-07-21T14:00:00.000Z",
"created_at": "2021-07-21T14:00:00.000Z",
"passthrough": { "other_known_names": "John Doe" },
"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": { "source_value": "<string>" },
"level": { "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"
}
],
"content_type": { "source_value": "<string>" }
}
headers = {
"x-account-id": "<x-account-id>",
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'x-account-id': '<x-account-id>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
external_reference: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1',
unified_custom_fields: {
my_project_custom_field_1: 'REF-1236',
my_project_custom_field_2: 'some other value'
},
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',
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'],
authors: [{id: '123', name: 'John Doe'}],
updated_at: '2021-07-21T14:00:00.000Z',
created_at: '2021-07-21T14:00:00.000Z',
passthrough: {other_known_names: 'John Doe'},
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: {source_value: '<string>'},
level: {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'
}
],
content_type: {source_value: '<string>'}
})
};
fetch('https://api.stackone.com/unified/lms/content', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stackone.com/unified/lms/content",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'external_reference' => 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1',
'unified_custom_fields' => [
'my_project_custom_field_1' => 'REF-1236',
'my_project_custom_field_2' => 'some other value'
],
'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',
'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'
],
'authors' => [
[
'id' => '123',
'name' => 'John Doe'
]
],
'updated_at' => '2021-07-21T14:00:00.000Z',
'created_at' => '2021-07-21T14:00:00.000Z',
'passthrough' => [
'other_known_names' => 'John Doe'
],
'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' => [
'source_value' => '<string>'
],
'level' => [
'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'
]
],
'content_type' => [
'source_value' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"x-account-id: <x-account-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.stackone.com/unified/lms/content"
payload := strings.NewReader("{\n \"external_reference\": \"SOFTWARE-ENG-LV1-TRAINING-VIDEO-1\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This video acts as learning content for software engineers.\",\n \"languages\": [\n {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n ],\n \"content_url\": \"https://www.youtube.com/watch?v=16873\",\n \"mobile_launch_content_url\": \"https://www.mobile.youtube.com/watch?v=16873\",\n \"cover_url\": \"https://www.googledrive.com/?v=16873\",\n \"active\": true,\n \"duration\": \"P3Y6M4DT12H30M5S\",\n \"skills\": [\n {\n \"id\": \"12345\",\n \"name\": \"Sales Techniques\"\n }\n ],\n \"order\": 1,\n \"short_description\": \"This course is a valuable resource and acts as learning content for...\",\n \"localizations\": [\n {\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-GB\",\n \"source_value\": \"string\"\n }\n },\n {\n \"title\": \"Software Engineer: A comprehensive guide\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-US\",\n \"source_value\": \"string\"\n }\n }\n ],\n \"tags\": [\n \"Sales Techniques\",\n \"Customer Service\"\n ],\n \"authors\": [\n {\n \"id\": \"123\",\n \"name\": \"John Doe\"\n }\n ],\n \"updated_at\": \"2021-07-21T14:00:00.000Z\",\n \"created_at\": \"2021-07-21T14:00:00.000Z\",\n \"passthrough\": {\n \"other_known_names\": \"John Doe\"\n },\n \"categories\": [\n {\n \"id\": \"16873-IT345\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"name\": \"Information-Technology\",\n \"hierarchy\": {\n \"source_value\": \"<string>\"\n },\n \"level\": {\n \"source_value\": \"<string>\"\n },\n \"language\": {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n }\n ],\n \"additional_data\": [\n {\n \"id\": \"learning_outcomes\",\n \"remote_id\": \"8187e5da-dc77-475e-9949-af0f1fa4e4e3\",\n \"value\": \"This is additional data\"\n }\n ],\n \"content_type\": {\n \"source_value\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-account-id", "<x-account-id>")
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.stackone.com/unified/lms/content")
.header("x-account-id", "<x-account-id>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"external_reference\": \"SOFTWARE-ENG-LV1-TRAINING-VIDEO-1\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This video acts as learning content for software engineers.\",\n \"languages\": [\n {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n ],\n \"content_url\": \"https://www.youtube.com/watch?v=16873\",\n \"mobile_launch_content_url\": \"https://www.mobile.youtube.com/watch?v=16873\",\n \"cover_url\": \"https://www.googledrive.com/?v=16873\",\n \"active\": true,\n \"duration\": \"P3Y6M4DT12H30M5S\",\n \"skills\": [\n {\n \"id\": \"12345\",\n \"name\": \"Sales Techniques\"\n }\n ],\n \"order\": 1,\n \"short_description\": \"This course is a valuable resource and acts as learning content for...\",\n \"localizations\": [\n {\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-GB\",\n \"source_value\": \"string\"\n }\n },\n {\n \"title\": \"Software Engineer: A comprehensive guide\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-US\",\n \"source_value\": \"string\"\n }\n }\n ],\n \"tags\": [\n \"Sales Techniques\",\n \"Customer Service\"\n ],\n \"authors\": [\n {\n \"id\": \"123\",\n \"name\": \"John Doe\"\n }\n ],\n \"updated_at\": \"2021-07-21T14:00:00.000Z\",\n \"created_at\": \"2021-07-21T14:00:00.000Z\",\n \"passthrough\": {\n \"other_known_names\": \"John Doe\"\n },\n \"categories\": [\n {\n \"id\": \"16873-IT345\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"name\": \"Information-Technology\",\n \"hierarchy\": {\n \"source_value\": \"<string>\"\n },\n \"level\": {\n \"source_value\": \"<string>\"\n },\n \"language\": {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n }\n ],\n \"additional_data\": [\n {\n \"id\": \"learning_outcomes\",\n \"remote_id\": \"8187e5da-dc77-475e-9949-af0f1fa4e4e3\",\n \"value\": \"This is additional data\"\n }\n ],\n \"content_type\": {\n \"source_value\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stackone.com/unified/lms/content")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-account-id"] = '<x-account-id>'
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_reference\": \"SOFTWARE-ENG-LV1-TRAINING-VIDEO-1\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This video acts as learning content for software engineers.\",\n \"languages\": [\n {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n ],\n \"content_url\": \"https://www.youtube.com/watch?v=16873\",\n \"mobile_launch_content_url\": \"https://www.mobile.youtube.com/watch?v=16873\",\n \"cover_url\": \"https://www.googledrive.com/?v=16873\",\n \"active\": true,\n \"duration\": \"P3Y6M4DT12H30M5S\",\n \"skills\": [\n {\n \"id\": \"12345\",\n \"name\": \"Sales Techniques\"\n }\n ],\n \"order\": 1,\n \"short_description\": \"This course is a valuable resource and acts as learning content for...\",\n \"localizations\": [\n {\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-GB\",\n \"source_value\": \"string\"\n }\n },\n {\n \"title\": \"Software Engineer: A comprehensive guide\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-US\",\n \"source_value\": \"string\"\n }\n }\n ],\n \"tags\": [\n \"Sales Techniques\",\n \"Customer Service\"\n ],\n \"authors\": [\n {\n \"id\": \"123\",\n \"name\": \"John Doe\"\n }\n ],\n \"updated_at\": \"2021-07-21T14:00:00.000Z\",\n \"created_at\": \"2021-07-21T14:00:00.000Z\",\n \"passthrough\": {\n \"other_known_names\": \"John Doe\"\n },\n \"categories\": [\n {\n \"id\": \"16873-IT345\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"name\": \"Information-Technology\",\n \"hierarchy\": {\n \"source_value\": \"<string>\"\n },\n \"level\": {\n \"source_value\": \"<string>\"\n },\n \"language\": {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n }\n ],\n \"additional_data\": [\n {\n \"id\": \"learning_outcomes\",\n \"remote_id\": \"8187e5da-dc77-475e-9949-af0f1fa4e4e3\",\n \"value\": \"This is additional data\"\n }\n ],\n \"content_type\": {\n \"source_value\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"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"
}
}{
"statusCode": 400,
"message": "Bad Request",
"timestamp": "2023-05-30T00:00:00.000Z",
"data": {
"statusCode": 400,
"message": "Bad Request",
"headers": {
"content-type": "application/json",
"x-request-id": "5678c28b211dace4e0a0f9171e6b88c5"
}
},
"provider_errors": [
{
"status": 400,
"url": "https://api.provider.com/v1/resource",
"raw": {
"message": "Invalid input parameters"
},
"headers": {
"content-type": "application/json",
"x-request-id": "5678c28b211dace4e0a0f9171e6b88c5"
}
}
]
}{
"statusCode": 401,
"message": "Unauthorized",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 403,
"message": "Forbidden resource",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 404,
"message": "Not Found",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 408,
"message": "Request timed out",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 409,
"message": "Conflict",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 412,
"message": "Precondition failed",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 422,
"message": "Unprocessable Entity",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 429,
"message": "Too many requests",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 500,
"message": "Internal server error",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 501,
"message": "Not Implemented",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 502,
"message": "Bad Gateway",
"timestamp": "2023-05-30T00:00:00.000Z"
}Upsert External Linking Learning Objects
Create or update an external linking learning object that redirects users to a provider platform for consumption and progress tracking.
Note: Partial updates are not supported. When updating content, you must provide all the same fields that are required when creating content.
See here for more information about external linking learning objects.
PUT
/
unified
/
lms
/
content
Upsert External Linking Learning Objects
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 '
{
"external_reference": "SOFTWARE-ENG-LV1-TRAINING-VIDEO-1",
"unified_custom_fields": {
"my_project_custom_field_1": "REF-1236",
"my_project_custom_field_2": "some other value"
},
"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",
"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"
],
"authors": [
{
"id": "123",
"name": "John Doe"
}
],
"updated_at": "2021-07-21T14:00:00.000Z",
"created_at": "2021-07-21T14:00:00.000Z",
"passthrough": {
"other_known_names": "John Doe"
},
"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": {
"source_value": "<string>"
},
"level": {
"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"
}
],
"content_type": {
"source_value": "<string>"
}
}
'import requests
url = "https://api.stackone.com/unified/lms/content"
payload = {
"external_reference": "SOFTWARE-ENG-LV1-TRAINING-VIDEO-1",
"unified_custom_fields": {
"my_project_custom_field_1": "REF-1236",
"my_project_custom_field_2": "some other value"
},
"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",
"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"],
"authors": [
{
"id": "123",
"name": "John Doe"
}
],
"updated_at": "2021-07-21T14:00:00.000Z",
"created_at": "2021-07-21T14:00:00.000Z",
"passthrough": { "other_known_names": "John Doe" },
"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": { "source_value": "<string>" },
"level": { "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"
}
],
"content_type": { "source_value": "<string>" }
}
headers = {
"x-account-id": "<x-account-id>",
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'x-account-id': '<x-account-id>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
external_reference: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1',
unified_custom_fields: {
my_project_custom_field_1: 'REF-1236',
my_project_custom_field_2: 'some other value'
},
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',
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'],
authors: [{id: '123', name: 'John Doe'}],
updated_at: '2021-07-21T14:00:00.000Z',
created_at: '2021-07-21T14:00:00.000Z',
passthrough: {other_known_names: 'John Doe'},
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: {source_value: '<string>'},
level: {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'
}
],
content_type: {source_value: '<string>'}
})
};
fetch('https://api.stackone.com/unified/lms/content', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stackone.com/unified/lms/content",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'external_reference' => 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1',
'unified_custom_fields' => [
'my_project_custom_field_1' => 'REF-1236',
'my_project_custom_field_2' => 'some other value'
],
'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',
'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'
],
'authors' => [
[
'id' => '123',
'name' => 'John Doe'
]
],
'updated_at' => '2021-07-21T14:00:00.000Z',
'created_at' => '2021-07-21T14:00:00.000Z',
'passthrough' => [
'other_known_names' => 'John Doe'
],
'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' => [
'source_value' => '<string>'
],
'level' => [
'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'
]
],
'content_type' => [
'source_value' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"x-account-id: <x-account-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.stackone.com/unified/lms/content"
payload := strings.NewReader("{\n \"external_reference\": \"SOFTWARE-ENG-LV1-TRAINING-VIDEO-1\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This video acts as learning content for software engineers.\",\n \"languages\": [\n {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n ],\n \"content_url\": \"https://www.youtube.com/watch?v=16873\",\n \"mobile_launch_content_url\": \"https://www.mobile.youtube.com/watch?v=16873\",\n \"cover_url\": \"https://www.googledrive.com/?v=16873\",\n \"active\": true,\n \"duration\": \"P3Y6M4DT12H30M5S\",\n \"skills\": [\n {\n \"id\": \"12345\",\n \"name\": \"Sales Techniques\"\n }\n ],\n \"order\": 1,\n \"short_description\": \"This course is a valuable resource and acts as learning content for...\",\n \"localizations\": [\n {\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-GB\",\n \"source_value\": \"string\"\n }\n },\n {\n \"title\": \"Software Engineer: A comprehensive guide\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-US\",\n \"source_value\": \"string\"\n }\n }\n ],\n \"tags\": [\n \"Sales Techniques\",\n \"Customer Service\"\n ],\n \"authors\": [\n {\n \"id\": \"123\",\n \"name\": \"John Doe\"\n }\n ],\n \"updated_at\": \"2021-07-21T14:00:00.000Z\",\n \"created_at\": \"2021-07-21T14:00:00.000Z\",\n \"passthrough\": {\n \"other_known_names\": \"John Doe\"\n },\n \"categories\": [\n {\n \"id\": \"16873-IT345\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"name\": \"Information-Technology\",\n \"hierarchy\": {\n \"source_value\": \"<string>\"\n },\n \"level\": {\n \"source_value\": \"<string>\"\n },\n \"language\": {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n }\n ],\n \"additional_data\": [\n {\n \"id\": \"learning_outcomes\",\n \"remote_id\": \"8187e5da-dc77-475e-9949-af0f1fa4e4e3\",\n \"value\": \"This is additional data\"\n }\n ],\n \"content_type\": {\n \"source_value\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-account-id", "<x-account-id>")
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.stackone.com/unified/lms/content")
.header("x-account-id", "<x-account-id>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"external_reference\": \"SOFTWARE-ENG-LV1-TRAINING-VIDEO-1\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This video acts as learning content for software engineers.\",\n \"languages\": [\n {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n ],\n \"content_url\": \"https://www.youtube.com/watch?v=16873\",\n \"mobile_launch_content_url\": \"https://www.mobile.youtube.com/watch?v=16873\",\n \"cover_url\": \"https://www.googledrive.com/?v=16873\",\n \"active\": true,\n \"duration\": \"P3Y6M4DT12H30M5S\",\n \"skills\": [\n {\n \"id\": \"12345\",\n \"name\": \"Sales Techniques\"\n }\n ],\n \"order\": 1,\n \"short_description\": \"This course is a valuable resource and acts as learning content for...\",\n \"localizations\": [\n {\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-GB\",\n \"source_value\": \"string\"\n }\n },\n {\n \"title\": \"Software Engineer: A comprehensive guide\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-US\",\n \"source_value\": \"string\"\n }\n }\n ],\n \"tags\": [\n \"Sales Techniques\",\n \"Customer Service\"\n ],\n \"authors\": [\n {\n \"id\": \"123\",\n \"name\": \"John Doe\"\n }\n ],\n \"updated_at\": \"2021-07-21T14:00:00.000Z\",\n \"created_at\": \"2021-07-21T14:00:00.000Z\",\n \"passthrough\": {\n \"other_known_names\": \"John Doe\"\n },\n \"categories\": [\n {\n \"id\": \"16873-IT345\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"name\": \"Information-Technology\",\n \"hierarchy\": {\n \"source_value\": \"<string>\"\n },\n \"level\": {\n \"source_value\": \"<string>\"\n },\n \"language\": {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n }\n ],\n \"additional_data\": [\n {\n \"id\": \"learning_outcomes\",\n \"remote_id\": \"8187e5da-dc77-475e-9949-af0f1fa4e4e3\",\n \"value\": \"This is additional data\"\n }\n ],\n \"content_type\": {\n \"source_value\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stackone.com/unified/lms/content")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-account-id"] = '<x-account-id>'
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_reference\": \"SOFTWARE-ENG-LV1-TRAINING-VIDEO-1\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This video acts as learning content for software engineers.\",\n \"languages\": [\n {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n ],\n \"content_url\": \"https://www.youtube.com/watch?v=16873\",\n \"mobile_launch_content_url\": \"https://www.mobile.youtube.com/watch?v=16873\",\n \"cover_url\": \"https://www.googledrive.com/?v=16873\",\n \"active\": true,\n \"duration\": \"P3Y6M4DT12H30M5S\",\n \"skills\": [\n {\n \"id\": \"12345\",\n \"name\": \"Sales Techniques\"\n }\n ],\n \"order\": 1,\n \"short_description\": \"This course is a valuable resource and acts as learning content for...\",\n \"localizations\": [\n {\n \"title\": \"Software Engineer Lv 1\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-GB\",\n \"source_value\": \"string\"\n }\n },\n {\n \"title\": \"Software Engineer: A comprehensive guide\",\n \"description\": \"This course acts as learning resource for software engineers.\",\n \"languages\": {\n \"value\": \"en-US\",\n \"source_value\": \"string\"\n }\n }\n ],\n \"tags\": [\n \"Sales Techniques\",\n \"Customer Service\"\n ],\n \"authors\": [\n {\n \"id\": \"123\",\n \"name\": \"John Doe\"\n }\n ],\n \"updated_at\": \"2021-07-21T14:00:00.000Z\",\n \"created_at\": \"2021-07-21T14:00:00.000Z\",\n \"passthrough\": {\n \"other_known_names\": \"John Doe\"\n },\n \"categories\": [\n {\n \"id\": \"16873-IT345\",\n \"unified_custom_fields\": {\n \"my_project_custom_field_1\": \"REF-1236\",\n \"my_project_custom_field_2\": \"some other value\"\n },\n \"name\": \"Information-Technology\",\n \"hierarchy\": {\n \"source_value\": \"<string>\"\n },\n \"level\": {\n \"source_value\": \"<string>\"\n },\n \"language\": {\n \"value\": \"en_GB\",\n \"source_value\": \"<string>\"\n }\n }\n ],\n \"additional_data\": [\n {\n \"id\": \"learning_outcomes\",\n \"remote_id\": \"8187e5da-dc77-475e-9949-af0f1fa4e4e3\",\n \"value\": \"This is additional data\"\n }\n ],\n \"content_type\": {\n \"source_value\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"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"
}
}{
"statusCode": 400,
"message": "Bad Request",
"timestamp": "2023-05-30T00:00:00.000Z",
"data": {
"statusCode": 400,
"message": "Bad Request",
"headers": {
"content-type": "application/json",
"x-request-id": "5678c28b211dace4e0a0f9171e6b88c5"
}
},
"provider_errors": [
{
"status": 400,
"url": "https://api.provider.com/v1/resource",
"raw": {
"message": "Invalid input parameters"
},
"headers": {
"content-type": "application/json",
"x-request-id": "5678c28b211dace4e0a0f9171e6b88c5"
}
}
]
}{
"statusCode": 401,
"message": "Unauthorized",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 403,
"message": "Forbidden resource",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 404,
"message": "Not Found",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 408,
"message": "Request timed out",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 409,
"message": "Conflict",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 412,
"message": "Precondition failed",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 422,
"message": "Unprocessable Entity",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 429,
"message": "Too many requests",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 500,
"message": "Internal server error",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 501,
"message": "Not Implemented",
"timestamp": "2023-05-30T00:00:00.000Z"
}{
"statusCode": 502,
"message": "Bad Gateway",
"timestamp": "2023-05-30T00:00:00.000Z"
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Headers
The account identifier
Set to "heartbeat" to enable keep-alive newline heartbeats during long-running requests. Response includes Preference-Applied: heartbeat header when honored. (RFC 7240)
Example:
"heartbeat"
Body
application/json
The external ID associated with this content
Example:
"SOFTWARE-ENG-LV1-TRAINING-VIDEO-1"
Custom Unified Fields configured in your StackOne project
Example:
{
"my_project_custom_field_1": "REF-1236",
"my_project_custom_field_2": "some other value"
}
The title of the content
Example:
"Software Engineer Lv 1"
The description of the content
Example:
"This video acts as learning content for software engineers."
The languages associated with this content
Show child attributes
Show child attributes
The external URL of the content
Example:
"https://www.youtube.com/watch?v=16873"
The mobile friendly URL of the content
Example:
"https://www.mobile.youtube.com/watch?v=16873"
The URL of the thumbnail image associated with the content.
Example:
"https://www.googledrive.com/?v=16873"
Whether the content is active and available for users.
Example:
true
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"
The skills associated with this content
Show child attributes
Show child attributes
Example:
[
{ "id": "12345", "name": "Sales Techniques" }
]
The order of the individual content within a content grouping. This is not applicable for pushing individual content.
Example:
1
A short description or summary for the content
Example:
"This course is a valuable resource and acts as learning content for..."
The localization data for this course
Show child attributes
Show child attributes
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"
}
}
]
A list of tags associated with the content
Example:
["Sales Techniques", "Customer Service"]
The authors of the content
Show child attributes
Show child attributes
Example:
[{ "id": "123", "name": "John Doe" }]
The date on which the content was last updated.
Example:
"2021-07-21T14:00:00.000Z"
The date on which the content was created.
Example:
"2021-07-21T14:00:00.000Z"
Value to pass through to the provider
Example:
{ "other_known_names": "John Doe" }
The categories associated with this content
Show child attributes
Show child attributes
The additional_data associated with this content
Show child attributes
Show child attributes
The type of content
Show child attributes
Show child attributes
Was this page helpful?
⌘I