MCP
A2ABatch Upsert External Linking Learning Objects
curl --request POST \
--url https://api.stackone.com/unified/lms/content/batch \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'x-account-id: <x-account-id>' \
--data '
{
"items": [
{
"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/batch"
payload = { "items": [
{
"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.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-account-id': '<x-account-id>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
items: [
{
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/batch', 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/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'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/batch"
payload := strings.NewReader("{\n \"items\": [\n {\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 }\n ]\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.stackone.com/unified/lms/content/batch")
.header("x-account-id", "<x-account-id>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\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 }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stackone.com/unified/lms/content/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-account-id"] = '<x-account-id>'
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\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 }\n ]\n}"
response = http.request(request)
puts response.read_body{
"statusCode": 202,
"message": "Batch operation accepted",
"timestamp": "2021-01-01T01:01:01.000Z",
"errors": [
[
"Missing field: name"
],
[],
[]
]
}{
"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"
}Batch Upsert External Linking Learning Objects
Batch upsert multiple external linking learning objects that redirect 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.
POST
/
unified
/
lms
/
content
/
batch
Batch Upsert External Linking Learning Objects
curl --request POST \
--url https://api.stackone.com/unified/lms/content/batch \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'x-account-id: <x-account-id>' \
--data '
{
"items": [
{
"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/batch"
payload = { "items": [
{
"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.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-account-id': '<x-account-id>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
items: [
{
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/batch', 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/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'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/batch"
payload := strings.NewReader("{\n \"items\": [\n {\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 }\n ]\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.stackone.com/unified/lms/content/batch")
.header("x-account-id", "<x-account-id>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\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 }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stackone.com/unified/lms/content/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-account-id"] = '<x-account-id>'
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\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 }\n ]\n}"
response = http.request(request)
puts response.read_body{
"statusCode": 202,
"message": "Batch operation accepted",
"timestamp": "2021-01-01T01:01:01.000Z",
"errors": [
[
"Missing field: name"
],
[],
[]
]
}{
"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 batch of items to upsert
Show child attributes
Show child attributes
Was this page helpful?
⌘I