Upsert Content

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

Show child attributes

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"

cover_url · string | null

The URL of the thumbnail image associated with the content.

Example:

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

active

Whether the content is active and available for users.

Example:

true

duration · string<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

Show child attributes

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

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"
    }
  }
]

tags · string[] | null

A list of tags associated with the content

Example:

["Sales Techniques", "Customer Service"]

authors · object[] | null

The authors of the content

Show child attributes

Example:

[{ "id": "123", "name": "John Doe" }]

updated_at · string<date-time> | null

The date on which the content was last updated.

Example:

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

created_at · string<date-time> | 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

Show child attributes

additional_data · object[] | null

The additional_data associated with this content

Show child attributes

content_type · object

The type of content

Show child attributes

Response

201

application/json

The content was upserted successfully.

statusCode · number · required

Example:

201

message · string · required

Example:

"Record created successfully."

timestamp · string<date-time> · required

Example:

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

data · object · required

Show child attributes