Skip to main content
API docs by Redocly

5app REST API (1.0.0)

Download OpenAPI specification:Download

Documentation for the 5app endpoints defined in the Hub within hub/api/routes.
The main router for the endpoints is found under hub/api/app.js.
This API is documented in OpenAPI format and utilises Swagger version 3.0.0.

Assets

Operations for assets via Admin routes.

Get reset Mark As Done assets count

Get count of assets to reset Mark As Done mode for

Responses

Reset Mark As Done mode for assets

Bulk reset Mark as Done mode for all assets in a hub

Responses

Get stats for an asset

Returns the stats for an asset by id

path Parameters
assetId
required
string
query Parameters
duration
string

Responses

Content

Operations for content (e.g. playlists, assets, sections) via Admin routes.

Fetch or download content audit

Returns the audit for all content (playlist, assets, folders) with pagination or downloads the content audit as a csv file.

query Parameters
format
string (CSVFormat)
Value: "csv"

If passed through, the requested data will be downloaded as a csv file. Also determines the format of the downloaded file.

attachment
string (Attachment)
Example: attachment=1

The name given to the file to be downloaded

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

search
object

Search term to filter the content audit results by.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Get content featured for teams

Get content featured for a list of teams

path Parameters
teamIds
required
string

Responses

Add content featured for teams

Add content featured for a list of teams

path Parameters
teamIds
required
string
Request Body schema: application/json
contentIds
any

Responses

Request samples

Content type
application/json
{
  • "contentIds": "any"
}

Delete content featured for teams

Delete content featured for a list of teams

path Parameters
teamIds
required
string
Request Body schema: application/json
contentIds
any

Responses

Request samples

Content type
application/json
{
  • "contentIds": "any"
}

Update content featured for teams

Update content featured for a list of teams

path Parameters
teamIds
required
string
contentId
required
string
Request Body schema: application/json
rank
any

Responses

Request samples

Content type
application/json
{
  • "rank": "any"
}

Email Templates

Operations for email templates via Admin routes.

Get email template

Get the preview for an email template.

path Parameters
id
required
string

Responses

Get email template fields

Get the fields for an email template in a specific locale.

path Parameters
type
required
string
locale
required
string

Responses

Imports - Users

Operations for user imports via Admin routes.

Integrations - MS Teams

Operations for MS teams integration via Admin routes.

Block MS Teams for a user

Block MS Teams for a user.

Request Body schema: application/json
email
any

Responses

Request samples

Content type
application/json
{
  • "email": "any"
}

Connect the hub to a tenant in MS Teams

Connect the hub to a tenant in MS Teams.

header Parameters
host
string
Request Body schema: application/json
token
any

Responses

Request samples

Content type
application/json
{
  • "token": "any"
}

Add a tenant to MS Teams

Add a tenant (organization) to MS Teams.

Request Body schema: application/json
tenantId
any

Responses

Request samples

Content type
application/json
{
  • "tenantId": "any"
}

Add a user to MS Teams

Add a user to MS Teams.

Request Body schema: application/json
aadObjectId
any
email
any

Responses

Request samples

Content type
application/json
{
  • "aadObjectId": "any",
  • "email": "any"
}

Delete users from MS Teams

Delete users from MS Teams.

Request Body schema: application/json
emails
any

Responses

Request samples

Content type
application/json
{
  • "emails": "any"
}

Nudges

Operations for nudges via Admin routes.

Create a nudge

Creates a nudge and accordingly its nudgeActions, nudgeContents and nudgeTeams.

Request Body schema:
required
isEnabled
required
boolean
name
required
string
locale
string (Locale)
Enum: "da-DK" "de-DE" "de-DE-Sie" "en-GB" "en-US" "es-ES" "fi-FI" "fr-FR" "hu-HU" "it-IT" "ja-JP" "ko-KR" "nl-NL" "no-NO" "pl-PL" "pt-PT" "ro-RO" "ru-RU" "sv-SE" "th-TH" "zh-CN" "zh-TW"

Locale supported by the hub

timezone
required
string (Timezone)
Default: null

IANA time zone name in the format Area/Location

goalType
required
string (NudgeGoalType)
Enum: "completeContent" "openContent" "logInFirstTime" "logInAgain"

Goal type of the nudge, belonging to the two categories content nudge (goalType is either completeContent or openContent) or login nudge (goalType is either logInFirstTime or logInAgain).
Content nudges can only have nudgeActions with the nudgeActions[i].type of share and remind.
Nudges with goalType logInFirstTime can only have nudgeActions with the nudgeActions[i].type of invite.
Nudges with goalType logInAgain can only have nudgeActions with the nudgeActions[i].type of remind.

object (NudgeTarget)
object (NudgeRepetition)
teamIds
Array of numbers (TeamIds)
contentIds
Array of numbers (ContentIds)
Array of objects (NudgeActionsPostPayload)

Responses

Request samples

Content type
{
  • "isEnabled": true,
  • "name": "Nudge name",
  • "locale": "da-DK",
  • "timezone": "Europe/Berlin",
  • "goalType": "completeContent",
  • "target": {
    },
  • "repetition": {
    },
  • "teamIds": [
    ],
  • "contentIds": [
    ],
  • "nudgeActions": [
    ]
}

Response samples

Content type
{
  • "id": 1
}

Update nudges

Update one or multiple nudges. For multi updates, the audience, nudgeTeams and enabled state of the nudges can be updated. For single nudges, all nudge details, nudgeActions, nudgeContents and nudgeTeams can be updated.

Request Body schema:
required
ids
required
Array of numbers (NudgeId)
isEnabled
boolean
isDeleted
boolean (NudgePatchIsDeleted)

Can be used to restore a deleted nudge by passing through false. Deletion of a nudge via PATCH is not supported and thus the value for isDeleted cannot be true. Use DELETE instead.

name
string
locale
string (Locale)
Enum: "da-DK" "de-DE" "de-DE-Sie" "en-GB" "en-US" "es-ES" "fi-FI" "fr-FR" "hu-HU" "it-IT" "ja-JP" "ko-KR" "nl-NL" "no-NO" "pl-PL" "pt-PT" "ro-RO" "ru-RU" "sv-SE" "th-TH" "zh-CN" "zh-TW"

Locale supported by the hub

timezone
string (Timezone)
Default: null

IANA time zone name in the format Area/Location

goalType
string (NudgeGoalType)
Enum: "completeContent" "openContent" "logInFirstTime" "logInAgain"

Goal type of the nudge, belonging to the two categories content nudge (goalType is either completeContent or openContent) or login nudge (goalType is either logInFirstTime or logInAgain).
Content nudges can only have nudgeActions with the nudgeActions[i].type of share and remind.
Nudges with goalType logInFirstTime can only have nudgeActions with the nudgeActions[i].type of invite.
Nudges with goalType logInAgain can only have nudgeActions with the nudgeActions[i].type of remind.

object (NudgeTarget)
object (NudgeRepetition)
teamIdsToAdd
Array of numbers (TeamIds)
teamIdsToRemove
Array of numbers (TeamIds)
contentIds
Array of numbers (ContentIds)
Array of objects (NudgeActionsPatchPayload)

Responses

Request samples

Content type
{
  • "ids": [
    ],
  • "isEnabled": true,
  • "isDeleted": false,
  • "name": "Nudge name",
  • "locale": "da-DK",
  • "timezone": "Europe/Berlin",
  • "goalType": "completeContent",
  • "target": {
    },
  • "repetition": {
    },
  • "teamIdsToAdd": [
    ],
  • "teamIdsToRemove": [
    ],
  • "contentIds": [
    ],
  • "nudgeActions": [
    ]
}

Response samples

Content type
{
  • "success": true
}

Delete nudges

Soft deletes one or multiple nudges. The ids of nudges to be deleted are passed via the query.filter.

query Parameters
object

Takes an array with the ids of nudges to be deleted

Responses

Response samples

Content type
{
  • "success": true
}

Fetch all nudges

Returns all nudges with pagination.

query Parameters
offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

search
string (Search)
Example: search=playlistName

Search terms to filter the result by.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Duplicate nudges

Duplicate one or more nudges.

Request Body schema:
required
any

Responses

Request samples

Content type
null

Response samples

Content type
{
  • "success": true
}

Fetch or download nudges audit

Returns the audit for all nudges with pagination or downloads the nudges audit as a csv file.

query Parameters
format
string (CSVFormat)
Value: "csv"

If passed through, the requested data will be downloaded as a csv file. Also determines the format of the downloaded file.

attachment
string (Attachment)
Example: attachment=1

The name given to the file to be downloaded

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

search
object

Search term to filter the nudges audit results by.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Fetch a nudge

Fetch a nudge with its nudgeActions, nudgeContents and nudgeTeams.

path Parameters
nudgeId
required
string

Responses

Response samples

Content type
{
  • "id": 1,
  • "name": "Nudge name",
  • "audience": "all",
  • "locale": "en-GB",
  • "timezone": "Europe/Berlin",
  • "goalType": "completeContent",
  • "isEnabled": true,
  • "target": {
    },
  • "repetition": {
    },
  • "nudgeTeams": [
    ],
  • "nudgeContents": [
    ],
  • "nudgeActions": [
    ]
}

Fetch stats for a nudge

Returns the stats for a nudge, depending on its goalType.

path Parameters
nudgeId
required
number (NudgeId)
Example: 1

Nudge id

query Parameters
startDate
string (StartDate)
Example: startDate=2023-05-16

The start date of the date range to filter by. Must be in ISO 8601 format.

endDate
string (EndDate)
Example: endDate=2023-05-16

The end date of the date range to filter by. Must be in ISO 8601 format.

Responses

Response samples

Content type
Example
{
  • "nudgedUsersCount": 1,
  • "actionsSentCount": 1,
  • "loggedInAfterNudgeCount": 1,
  • "analyticsType": "logInFirstTime"
}

Fetch report for a nudge

Returns the report for a nudge with pagination or downloads the nudge's report as a csv file. All dates are shown within the nudge's timezone.

path Parameters
nudgeId
required
number (NudgeId)
Example: 1

Nudge id

query Parameters
search
object

Search term to filter the nudges report results by. Searches for matching user names and emails.

progress
string (NudgeCompletionProgress)
Enum: "achievedAll" "unachievedAll" "achievedLate" "unachievedLate" "achievedOnTime" "unachievedOnTime"

Filter the result set based on the users' completion status of the nudge goal. Login nudges can only be filtered for achievedAll and unachievedAll

startDate
string (StartDate)
Example: startDate=2023-05-16

The start date of the date range to filter by. Must be in ISO 8601 format.

endDate
string (EndDate)
Example: endDate=2023-05-16

The end date of the date range to filter by. Must be in ISO 8601 format.

format
string (CSVFormat)
Value: "csv"

If passed through, the requested data will be downloaded as a csv file. Also determines the format of the downloaded file.

attachment
string (Attachment)
Example: attachment=1

The name given to the file to be downloaded

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

Responses

Response samples

Content type
Example
{
  • "items": [
    ],
  • "analyticsType": "logInAgain",
  • "total": 100,
  • "nextOffset": 1
}

Playlists

Operations for playlists and team playlists via Admin routes.

Get stats for a playlist

Returns the stats for a playlist by id

path Parameters
playlistId
required
string
query Parameters
duration
string

Responses

Duplicate playlists

Duplicate one or more playlists.

Request Body schema: application/json
playlistIds
any
withIndex
any
selectedTopicId
any

Responses

Request samples

Content type
application/json
{
  • "playlistIds": "any",
  • "withIndex": "any",
  • "selectedTopicId": "any"
}

Delete topics for a playlist

Deletes topics for a playlist by id

Request Body schema: application/json
idsToRemove
any

Responses

Request samples

Content type
application/json
{
  • "idsToRemove": "any"
}

Pin playlists

Pin playlists to the Browse page or pin playlists to a topic

Request Body schema:
required
playlistIds
required
Array of numbers (ContentIds)
topicId
number (TopicId)

Topic id

Responses

Request samples

Content type
{
  • "playlistIds": [
    ],
  • "topicId": 1
}

Response samples

Content type
{
  • "success": true
}

Unpin playlists

Unpin playlists from the Browse page or unpin playlists from a topic

Request Body schema:
required
playlistIds
required
Array of numbers (ContentIds)
topicId
number (TopicId)

Topic id

Responses

Request samples

Content type
{
  • "playlistIds": [
    ],
  • "topicId": 1
}

Response samples

Content type
{
  • "success": true
}

Update pin rank of a playlist

Update the pinned rank of a playlist on the Browse page or within a topic

Request Body schema:
required
index
required
number

0-based index to pin the playlist to

playlistId
required
number (ContentId)

Content id

topicId
number (TopicId)

Topic id

Responses

Request samples

Content type
{
  • "index": 0,
  • "playlistId": 1,
  • "topicId": 1
}

Response samples

Content type
{
  • "success": true
}

skills

Operations for Helix skills via Admin routes.

Get skill contents

Get all contents linked to a skill for a specific user.

path Parameters
skillId
required
number (SkillId)
Example: 1

Helix skill id

query Parameters
userId
number (UserId)
Example: userId=1

User id

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

in
string
schema
string
nextOffset
string
total
string

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "nextOffset": 1,
  • "total": 100
}

Get a list of skills

Get a list of skills based on the search query

query Parameters
search
string (Search)
Example: search=playlistName

Search terms to filter the result by.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

in
string
schema
string
name
string
parentId
string
total
string

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "nextOffset": 1,
  • "total": 100
}

Fetch or download skills audit

Returns the audit for all skills and skill sets with pagination or downloads the skills audit as a csv file.

query Parameters
format
string (CSVFormat)
Value: "csv"

If passed through, the requested data will be downloaded as a csv file. Also determines the format of the downloaded file.

attachment
string (Attachment)
Example: attachment=1

The name given to the file to be downloaded

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

search
object

Search term to filter the audit results by.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Get a skill

Get a skill by id

path Parameters
skillId
required
number (SkillId)
Example: 1

Helix skill id

Responses

Response samples

Content type
{
  • "id": 1,
  • "name": "Skill name",
  • "updatedTime": "2023-02-21T10:52:09.000Z",
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "description": "Skill description",
  • "sets": [
    ],
  • "linkedContent": [
    ],
  • "parentId": 1,
  • "parentName": "Parent skill name",
  • "parentLinkedContent": [
    ]
}

Get a skill set

Get a skill set by id

path Parameters
skillSetId
required
number (SkillSetId)
Example: 1

Helix skill set id

Responses

Response samples

Content type
{
  • "id": 1,
  • "name": "Skill set name",
  • "description": "Skill set description",
  • "updatedTime": "2023-02-21T10:52:09.000Z",
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "audience": "all",
  • "skills": [
    ],
  • "teams": [
    ]
}

Stats

Operations for admin home stats via Admin routes.

Get user session stats

Get user session stats for the last 30 days, 12 months or 7 days.

query Parameters
period
string

Responses

Get unique user stats

Get unique user stats for the last 30 days, 12 months or 7 days.

query Parameters
period
string

Responses

Get asset open stats

Get asset open stats for the last 30 days, 12 months or 7 days.

query Parameters
period
string

Responses

Get overview stats

Get overview stats for the admin home dashboard, including user, asset, asset open, playlist and playlist completion counts.

Responses

Subtitles

Operations for subtitles via Admin routes.

Update a subtitle

Update a subtitle for a specific language and asset.

path Parameters
id
required
string
Request Body schema: application/json
language
any

Responses

Request samples

Content type
application/json
{
  • "language": "any"
}

Delete a subtitle

Delete a subtitle for an asset.

path Parameters
id
required
string

Responses

Teams

Operations for teams via Admin routes.

Fetch a team's asset history

Returns an activity summary for actions performed by a team on assets.

path Parameters
teamId
required
string
query Parameters
duration
string

Responses

Fetch or download teams audit

Returns the audit for all teams with pagination or downloads the teams audit as a csv file.

query Parameters
format
string
search
string

Responses

Team Types

Operations for team types via Admin routes.

Update team type rank

Update a team type's rank.

path Parameters
teamTypeId
required
string
rank
required
string

Responses

Topics

Operations for topics via Admin routes.

Post topic rank

Update the ranking of topics.

path Parameters
topicId
required
string
query Parameters
index
string
parentTopicId
string

Responses

Reset topic ranks

Reset welcome topic ranks. If parentTopicId is provided then only reset the ranks of the topics that are children of the parent topic.

query Parameters
parentTopicId
string

Responses

Users

Operations for users via Admin routes.

Get hubs a user belongs too

Fetch hubs a user belongs too

path Parameters
userId
required
string
query Parameters
limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Add users

Add users to a hub. If teams are specified, the users will be added to the userTeams. Utilised by the Zapier integration.

header Parameters
host
string
Request Body schema: application/json
password
any
send_email
any
teamId
any
users
any

Responses

Request samples

Content type
application/json
{
  • "password": "any",
  • "send_email": "any",
  • "teamId": "any",
  • "users": "any"
}

Get users audit

Get the audit information for users.

query Parameters
format
string
search
string
userId
string

Responses

Invite users

Send invitations to users.

Request Body schema: application/json
ids
any

Responses

Request samples

Content type
application/json
{
  • "ids": "any"
}

Get users with team roles

Get users with team roles (member or manager role)

query Parameters
search
string
team
string
role
string

Responses

Update a user

Update a user's information by id.

path Parameters
userId
required
number (UserId)
Example: 1

User id

header Parameters
host
string
Request Body schema:
required
any

Responses

Request samples

Content type
null

Response samples

Content type
{
  • "success": true
}

Update a user

Update a user's information by id.

path Parameters
userId
required
number (UserId)
Example: 1

User id

header Parameters
host
string
Request Body schema:
required
any

Responses

Request samples

Content type
null

Response samples

Content type
{
  • "success": true
}

Get a user's asset stats

Get a user's asset stats for a given duration.

path Parameters
userId
required
string
query Parameters
duration
string

Responses

Welcome Views

Operations for welcome views via Admin routes.

Reset welcome views

Reset welcome views for all users in the domain.

Responses

Assets

Operations for assets via Store routes.

Create assets

Creates assets and assigns them to a owner team, if provided

Request Body schema: application/json
map(asset
any
length
any

Responses

Request samples

Content type
application/json
{
  • "map(asset": "any",
  • "length": "any"
}

Updates an asset

Updates an asset, including changing the owner team if provided

path Parameters
assetId
required
number (ContentId)
Example: 1

Content id

Request Body schema:
required
name
string or null

Asset name. Optional unless webUrl is not defined

webUrl
string or null

WebUrl. Optional unless name if not defined (the asset is a web link). Can only be updated if type === web

published
boolean or null

Will need to be set to true to publish the asset

type
string (AssetContentType)
Enum: "upload" "zip" "web" "scorm"

All asset content types. See types in content table.

fileFormat
string (FileFormat)
Default: null

Format of a file

customType
string (AssetCustomType)
Default: null

Custom type for an asset. See types in content table.

ownerTeamId
number (OwnerTeamId)

Team id of the content owning team

description
string or null
locale
string (Locale)
Enum: "da-DK" "de-DE" "de-DE-Sie" "en-GB" "en-US" "es-ES" "fi-FI" "fr-FR" "hu-HU" "it-IT" "ja-JP" "ko-KR" "nl-NL" "no-NO" "pl-PL" "pt-PT" "ro-RO" "ru-RU" "sv-SE" "th-TH" "zh-CN" "zh-TW"

Locale supported by the hub

tags
Array of numbers (TagIds)
subtitles
Array of numbers (FileId)

Optional list of Subtitles IDs. If present, this list of subtitles IDs will replace all video subtitles

fileId
number (FileId)

File id

thumbnailId
number (ContentCompletionTime)
Default: null

The completion time for a playlist or an asset in minutes.

alternativeText
string or null
download
string (AssetDownload)
Enum: "disabled" "enabled" "required"

Whether an asset must or can be downloaded.

openInIframe
boolean or null
scormAdvancedSettings
object or null

If present, it will replace the scorm_settings of the asset

markAsDoneMode
string (AssetMarkAsDoneMode)
Enum: "automatic" "manual"

Mark as done mode of the asset

refid
string or null

A reference used to identify this asset in the future

externalRefId
string or null

Custom data of an asset

parent_id
number or null

id of a folder/ topic a content belongs to

optional
boolean (ContentOptional)
Default: false

Whether the content has been marked as 'optional' by the user within the specified playlist

parentPlaylistId
number (ContentId)

Content id

Responses

Request samples

Content type
{
  • "name": "Asset name",
  • "webUrl": "https://www.5app.com",
  • "published": true,
  • "type": "upload",
  • "fileFormat": null,
  • "customType": "video",
  • "ownerTeamId": 1,
  • "description": "Asset description",
  • "locale": "da-DK",
  • "tags": [
    ],
  • "subtitles": [
    ],
  • "fileId": 1,
  • "thumbnailId": 30,
  • "alternativeText": "string",
  • "download": "disabled",
  • "openInIframe": true,
  • "scormAdvancedSettings": { },
  • "markAsDoneMode": "automatic",
  • "refid": "string",
  • "externalRefId": "string",
  • "parent_id": 0,
  • "optional": false,
  • "parentPlaylistId": 1
}

Response samples

Content type
{
  • "alternativeText": "Asset alternative text",
  • "author": {
    },
  • "brightcoveVideoId": 1,
  • "brightcoveAccountId": 1,
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "completionTime": 30,
  • "convertedFileType": "mp3",
  • "converted": false,
  • "convertedUrl": "/api/asset/1/file",
  • "customType": "video",
  • "collection_id": 1,
  • "commentCount": 0,
  • "commentCountUser": 0,
  • "duration": "The actual duration of an asset in minutes if available. E.g. the length of the video or of the audio file.",
  • "domain_id": 1,
  • "downloadUrl": "/api/asset/1/file",
  • "description": "Asset description",
  • "download": "disabled",
  • "excludeFromAi": false,
  • "fileId": 1,
  • "fileSize": 1560,
  • "fileStatus": "draft",
  • "fileFormat": null,
  • "fileUploadedTime": "2023-02-21T10:52:09.000Z",
  • "goal": {
    },
  • "id": 1,
  • "is_read": true,
  • "isDeleted": false,
  • "isSaved": false,
  • "insightsEnabled": true,
  • "name": "Asset name",
  • "openInIframe": true,
  • "original_file_name": "original_file_name",
  • "originatingId": 1,
  • "ownerTeamId": 1,
  • "pictureUrl": "`/api/content/1/thumb`",
  • "parentId": 1,
  • "parentPlaylists": [
    ],
  • "published": true,
  • "locale": "da-DK",
  • "lastUpdated": "2023-02-21T10:52:09.000Z",
  • "markAsDoneMode": "automatic",
  • "rank": "1.2.04",
  • "rating_count": 1,
  • "scormSettings": "Parsed JSON SCORM settings",
  • "sharers": [
    ],
  • "sourceDomain": {},
  • "subtitles": [
    ],
  • "tags": [
    ],
  • "type": "upload",
  • "url": "www.5app.com",
  • "uploadErrorCode": "404",
  • "userContentStatus": "notstarted",
  • "user_rated_like": "Whether the content has been 'liked' by the user.",
  • "userScormAssetStatus": "completed"
}

Deletes an asset

Soft deletes an asset

path Parameters
assetId
required
string
Request Body schema: application/json
optional
any
excludeFromAi
any

Responses

Request samples

Content type
application/json
{
  • "optional": "any",
  • "excludeFromAi": "any"
}

Badges

Operations for badges via Store routes. Can only be used if the "Badges" feature flag is enabled.

Fetch all badges

Returns all badges with pagination. Can be accessed by Admins with "Playlist Write" permission and by team managers, if the "Team Playlists" feature flag is enabled.

Responses

Create a badge

Creates a badge for a playlist, assigning the badge to badgeRequirements. Can be accessed by Admins with "Playlist Write" permission and by team managers of the playlist owning team, if the "Team Playlists" feature flag is enabled.

Request Body schema: application/json
contentIds
any
imageId
any

Responses

Request samples

Content type
application/json
{
  • "contentIds": "any",
  • "imageId": "any"
}

Update a badge

Updates a badge for a playlist and undeletes it if previously deleted. Can be accessed by Admins with "Playlist Write" permission and by team managers of the playlist owning team, if the "Team Playlists" feature flag is enabled.

path Parameters
badgeId
required
string
Request Body schema: application/json
contentIds
any
imageId
any

Responses

Request samples

Content type
application/json
{
  • "contentIds": "any",
  • "imageId": "any"
}

Delete a badge

Soft deletes a badge for a playlist. Can be accessed by Admins with "Playlist Write" permission and by team managers of the playlist owning team, if the "Team Playlists" feature flag is enabled.

path Parameters
badgeId
required
string
Request Body schema: application/json
contentIds
any

Responses

Request samples

Content type
application/json
{
  • "contentIds": "any"
}

Badge Images

Operations for badge images via Store routes. Can only be used if the "Badges" feature flag is enabled.

Fetch all badge images

Returns all system and custom badge images with pagination. Can be accessed by Admins with "Playlist Write" permission and by team managers, if the "Team Playlists" feature flag is enabled.

query Parameters
search
string

Responses

Fetch a badge image URL

Returns a badge image URL. Can be accessed by any logged in user.

path Parameters
imageId
required
string
query Parameters
size
string

Responses

Update a custom badge image

Updates a badge image with the type custom. Can be accessed by Admins with "Playlist Write" permission.

path Parameters
imageId
required
string
Request Body schema: application/json
alternativeText
any
style
any

Responses

Request samples

Content type
application/json
{
  • "alternativeText": "any",
  • "style": "any"
}

Delete a custom badge image

Soft deletes a badge image with the type custom. Can be accessed by Admins with "Playlist Write" permission.

path Parameters
imageId
required
string
Request Body schema: application/json
replacementImageId
any

Responses

Request samples

Content type
application/json
{
  • "replacementImageId": "any"
}

Fetch playlists with same badge images

Returns all playlists which use the same badge image. Can be accessed by any logged in user.

path Parameters
imageId
required
string

Responses

Content

Operations for content (e.g. playlists, assets, sections) via Store routes.

Get content list

Get content which is is used in the report filter, Asset/Playlist/Topic pickers etc.

query Parameters
audience
string (ContentListAudience)
Enum: "all" "noadmin"

Audience to filter content by for content list

teamIds
Array of numbers (TeamIds)
Example: teamIds=1
type
string (ContentType)
Enum: "playlist" "folder" "section" "topic" "upload" "zip" "web" "scorm" "section"

All content types

search
string (Search)
Example: search=playlistName

Search terms to filter the result by.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

start
number (Offset)
Example: start=1

The number used to identify the starting point to return rows from a result set.

privilege
string (Privilege)
Enum: "settings_read" "settings_write" "user_write" "user_read" "report_write" "report_read" "nudge_write" "nudge_read" "playlist_write" "playlist_read" "asset_write" "asset_read"
Example: privilege=admin

User privilege level

playlistIdForCircularReferenceCheck
number (PlaylistIdForCircularReferenceCheck)
Example: playlistIdForCircularReferenceCheck=1

Only applicable for playlists. Pass through a content Id to check whether the playlist could create a circular reference

getFullData
boolean (ContentGetFullData)
Example: getFullData=true

Whether to return the full data of the content

id
number (ContentId)
Example: id=1

Content id

owner
string (ContentListOwner)
Default: "common"
Enum: "local" "local_and_common" "common"
Example: owner=common

Owner of content. Does this include assets which are: common (default) (belong to a playlist which is available on hub), local * NOT IMPLEMENTED * (created just for this hub, might not be in a playlist) or local_and_common (both)

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "nextOffset": 1
}

Get content for content cards

Get very basic metadata surrounding a bit of content (assets and playlists), usually to fill components such as cards

query Parameters
content_id
string

Responses

Update content status

Updates the status of assets or assets within select playlists for users and shares the assets where required.

Request Body schema:
required
contentIds
required
Array of numbers (ContentIds)
userIds
Array of numbers (UserIds)
teamIds
Array of numbers (TeamIds)
updateEveryone
boolean
newStatus
required
string (UpdatedContentUserStatus)
Enum: "notstarted" "completed"

The updated user completion status of the content.

updateOptionalContent
boolean
completionDateTime
string <date-time> (ContentCompletionDateTime)

The completion datetime of the content in UTC. Is required when updating the content status to completed

share
boolean
shareWithEveryone
boolean
shareSubject
string
shareMessage
string
session_token
string

Responses

Request samples

Content type
{
  • "contentIds": [
    ],
  • "userIds": [
    ],
  • "teamIds": [
    ],
  • "updateEveryone": false,
  • "newStatus": "notstarted",
  • "updateOptionalContent": false,
  • "completionDateTime": "2025-01-16T13:31:12.838Z",
  • "share": false,
  • "shareWithEveryone": false,
  • "shareSubject": "Share subject",
  • "shareMessage": "Share message",
  • "session_token": "1738583466047.14df6ca6-315b-4b54-860"
}

Response samples

Content type
{
  • "success": true
}

Get users affected by content status change

Get the paginated list of users who match the users filters and who will be impacted by the status change

query Parameters
contentIds
required
Array of numbers (ContentIds)
Example: contentIds=1
userIds
Array of numbers (UserIds)
Example: userIds=1
teamIds
Array of numbers (TeamIds)
Example: teamIds=1
updateEveryone
boolean
updateOptionalContent
boolean
newStatus
required
string (UpdatedContentUserStatus)
Enum: "notstarted" "completed"

The updated user completion status of the content.

shareWithEveryone
boolean
share
boolean
offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

search
string (Search)
Example: search=playlistName

Search terms to filter the result by.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "totalUserShares": 100,
  • "total": 100,
  • "nextOffset": 1
}

Me - Assets

User specific operations for assets via Store routes.

Fetch all store assets available to a user

Fetch all of the user's assets available in the store with pagination. Can be filtered by asset completion status.

query Parameters
search
string (AssetSearch)
Enum: "completed" "uncompleted" "saved"

Search terms to filter the query by.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
[
  • {
    }
]

Fetch store assets by id

Fetch an asset available in the store by id. If a playlistId is provided in the path, the asset must be in that collection.

path Parameters
assetId
required
string

Responses

Response samples

Content type
{
  • "alternativeText": "Asset alternative text",
  • "author": {
    },
  • "brightcoveVideoId": 1,
  • "brightcoveAccountId": 1,
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "completionTime": 30,
  • "convertedFileType": "mp3",
  • "converted": false,
  • "convertedUrl": "/api/asset/1/file",
  • "customType": "video",
  • "collection_id": 1,
  • "commentCount": 0,
  • "commentCountUser": 0,
  • "duration": "The actual duration of an asset in minutes if available. E.g. the length of the video or of the audio file.",
  • "domain_id": 1,
  • "downloadUrl": "/api/asset/1/file",
  • "description": "Asset description",
  • "download": "disabled",
  • "excludeFromAi": false,
  • "fileId": 1,
  • "fileSize": 1560,
  • "fileStatus": "draft",
  • "fileFormat": null,
  • "fileUploadedTime": "2023-02-21T10:52:09.000Z",
  • "goal": {
    },
  • "id": 1,
  • "is_read": true,
  • "isDeleted": false,
  • "isSaved": false,
  • "insightsEnabled": true,
  • "name": "Asset name",
  • "openInIframe": true,
  • "original_file_name": "original_file_name",
  • "originatingId": 1,
  • "ownerTeamId": 1,
  • "pictureUrl": "`/api/content/1/thumb`",
  • "parentId": 1,
  • "parentPlaylists": [
    ],
  • "published": true,
  • "locale": "da-DK",
  • "lastUpdated": "2023-02-21T10:52:09.000Z",
  • "markAsDoneMode": "automatic",
  • "rank": "1.2.04",
  • "rating_count": 1,
  • "scormSettings": "Parsed JSON SCORM settings",
  • "sharers": [
    ],
  • "sourceDomain": {},
  • "subtitles": [
    ],
  • "tags": [
    ],
  • "type": "upload",
  • "url": "www.5app.com",
  • "uploadErrorCode": "404",
  • "userContentStatus": "notstarted",
  • "user_rated_like": "Whether the content has been 'liked' by the user.",
  • "userScormAssetStatus": "completed"
}

Fetch store assets by id

Fetch an asset available in the store by id. If a playlistId is provided in the path, the asset must be in that collection.

path Parameters
assetId
required
string
playlistId
required
string

Responses

Response samples

Content type
{
  • "alternativeText": "Asset alternative text",
  • "author": {
    },
  • "brightcoveVideoId": 1,
  • "brightcoveAccountId": 1,
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "completionTime": 30,
  • "convertedFileType": "mp3",
  • "converted": false,
  • "convertedUrl": "/api/asset/1/file",
  • "customType": "video",
  • "collection_id": 1,
  • "commentCount": 0,
  • "commentCountUser": 0,
  • "duration": "The actual duration of an asset in minutes if available. E.g. the length of the video or of the audio file.",
  • "domain_id": 1,
  • "downloadUrl": "/api/asset/1/file",
  • "description": "Asset description",
  • "download": "disabled",
  • "excludeFromAi": false,
  • "fileId": 1,
  • "fileSize": 1560,
  • "fileStatus": "draft",
  • "fileFormat": null,
  • "fileUploadedTime": "2023-02-21T10:52:09.000Z",
  • "goal": {
    },
  • "id": 1,
  • "is_read": true,
  • "isDeleted": false,
  • "isSaved": false,
  • "insightsEnabled": true,
  • "name": "Asset name",
  • "openInIframe": true,
  • "original_file_name": "original_file_name",
  • "originatingId": 1,
  • "ownerTeamId": 1,
  • "pictureUrl": "`/api/content/1/thumb`",
  • "parentId": 1,
  • "parentPlaylists": [
    ],
  • "published": true,
  • "locale": "da-DK",
  • "lastUpdated": "2023-02-21T10:52:09.000Z",
  • "markAsDoneMode": "automatic",
  • "rank": "1.2.04",
  • "rating_count": 1,
  • "scormSettings": "Parsed JSON SCORM settings",
  • "sharers": [
    ],
  • "sourceDomain": {},
  • "subtitles": [
    ],
  • "tags": [
    ],
  • "type": "upload",
  • "url": "www.5app.com",
  • "uploadErrorCode": "404",
  • "userContentStatus": "notstarted",
  • "user_rated_like": "Whether the content has been 'liked' by the user.",
  • "userScormAssetStatus": "completed"
}

Fetch a user's asset status

Fetch the status of assets and scorm assets for a user to be displayed in the store

path Parameters
assetId
required
string
header Parameters
host
string

Responses

Put the status of an asset to read

Set the status of an asset to read, thereby marking it as done

path Parameters
assetId
required
string

Responses

Put the status of an asset to unread

Set the status of an asset to unread, thereby unmarking it as done

path Parameters
assetId
required
string

Responses

Set an asset as saved ("favourite")

Set an asset as saved ("favourite") by adding an entry for assetFavourites

path Parameters
assetId
required
string

Responses

Set an asset as no longer saved ("favourite")

Remove an asset as saved ("favourite") by deleting the entry for assetFavourites

path Parameters
assetId
required
string

Responses

Rate an asset as liked and give feedback

Put the rating (like) and feedback for an asset

path Parameters
assetId
required
string
Request Body schema: application/json
message
any
rating
any
rated_like
any

Responses

Request samples

Content type
application/json
{
  • "message": "any",
  • "rating": "any",
  • "rated_like": "any"
}

Me - Calendar

User specific operations for calendars via Store routes.

Fetch the data for a user's calendar integration

Fetch the calendar integration status and auto-join settings for a user

Responses

Response samples

Content type
{
  • "provider": "google",
  • "hasAccountLinked": true,
  • "hasActiveSubscription": true,
  • "isAutoJoinEnabled": true,
  • "autoJoinSettings": {
    }
}

Update the auto-join settings for a user's calendar integration

Enable or disable auto-join and update the auto-join settings for a user's calendar integration

Request Body schema:
required
isAutoJoinEnabled
boolean
object (CalendarAutoJoinSettings)

Responses

Request samples

Content type
{
  • "isAutoJoinEnabled": true,
  • "autoJoinSettings": {
    }
}

Response samples

Content type
{
  • "success": true
}

Handle Google calendar OAuth callback

Handle the OAuth callback from Google, exchange the authorization code for tokens, create a calendar watch channel, and store the relevant information in the database.

query Parameters
required
object (CalendarOAuthState)
code
required
string
in
string
required
string
schema
string

Responses

Response samples

Content type
{
  • "type": "string",
  • "example": "<html><body><p>Google Calendar linked successfully. You can now close this tab.</p></body></html>"
}

Disconnect the user's Google calendar integration

Disconnect the user's Google calendar by deleting any existing webhook subscriptions and removing stored tokens from the database.

Responses

Response samples

Content type
{
  • "success": true
}

Initiate Google calendar OAuth flow

Redirect the user to Google's OAuth 2.0 server to initiate the authentication and authorization process for accessing their Google calendar.

query Parameters
authorisationAction
required
string (CalendarOAuthAction)
Default: "authorise"
Value: 0

OAuth trigger action

in
string
required
string
schema
string

Responses

Handle Microsoft calendar OAuth callback

Handle the OAuth callback from Microsoft, exchange the authorization code for tokens, create a calendar subscription, and store the relevant information in the database.

query Parameters
required
object (CalendarOAuthState)
code
required
string
in
string
required
string
schema
string

Responses

Response samples

Content type
{
  • "type": "string",
  • "example": "<html><body><p>Microsoft Calendar linked successfully. You can now close this tab.</p></body></html>"
}

Disconnect the user's Microsoft calendar integration

Disconnect the user's Microsoft calendar by deleting any existing webhook subscriptions and removing stored tokens from the database.

Responses

Response samples

Content type
{
  • "success": true
}

Initiate Microsoft calendar OAuth flow

Redirect the user to Microsoft's OAuth 2.0 server to initiate the authentication and authorization process for accessing their Microsoft calendar.

query Parameters
authorisationAction
required
string (CalendarOAuthAction)
Default: "authorise"
Value: 0

OAuth trigger action

in
string
required
string
schema
string

Responses

Me - Content

User specific operations for content via Store routes.

Fetch featured content

Fetch contents which are being featured for a user

query Parameters
limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Fetch a user's saved assets and playlists

Fetch all saved assets and playlists available to a user in the store with pagination. Can be filtered by content completion status and whether it is an asset or a playlist.

query Parameters
status
string (MyContentStatus)
Enum: "all" "opened" "completed"

Content has been opened, completed or both

type
string (MyContentType)
Enum: "all" "assets" "playlists"

Content is an asset, playlist or both

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Fetch user's todo assets and playlists with due date

Fetch all todo assets and playlists with due date set available to user in the store with pagination. Can be filtered by content type (asset or a playlist).

query Parameters
type
string (MyContentType)
Enum: "all" "assets" "playlists"

Content is an asset, playlist or both

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Fetch a user's content history

Fetch all assets and playlists that a user has interacted with in the store with pagination. Can be filtered by content completion status and whether it is an asset or a playlist.

query Parameters
status
string (MyContentStatus)
Enum: "all" "opened" "completed"

Content has been opened, completed or both

type
string (MyContentType)
Enum: "all" "assets" "playlists"

Content is an asset, playlist or both

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Get content search

Search for assets, topics and playlists for the store

query Parameters
query
string (Search)
Example: query=playlistName

Search terms to filter the result by.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "nextOffset": 1
}

Get content search terms

Search for tags by name

query Parameters
query
string (Search)
Example: query=playlistName

Search terms to filter the result by.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "nextOffset": 1
}

Get comments

Get comments and comment count for a playlist or asset

path Parameters
contentId
required
number (ContentId)
Example: 1

Content id

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Create a comment

Create a user comment for a playlist or asset

path Parameters
contentId
required
number (ContentId)
Example: 1

Content id

Request Body schema:
required
message
required
string
parentId
number (ContentId)

Content id

Responses

Request samples

Content type
{
  • "message": "This is a comment",
  • "parentId": 1
}

Response samples

Content type
{
  • "id": 1,
  • "message": "This is a comment",
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "hasSubscribed": true
}

Update a comment

Update a user comment for a playlist or asset

path Parameters
contentId
required
number (ContentId)
Example: 1

Content id

commentId
required
number (CommentId)
Example: 1

Comment id

Request Body schema:
required
message
required
string

Responses

Request samples

Content type
{
  • "message": "This is an updated comment"
}

Response samples

Content type
{
  • "success": true
}

Delete a comment

Delete a user comment for a playlist or asset

path Parameters
contentId
required
number (ContentId)
Example: 1

Content id

commentId
required
number (CommentId)
Example: 1

Comment id

Responses

Response samples

Content type
{
  • "success": true
}

Me - Feedback

User specific feedback via Store routes.

Create my feedback

Create a user's feedback

Request Body schema:
required
refId
number (FeedbackRefId)

Reference id of the feedback. Can be e.g. a helixUserMeetingSkill.id

rating
boolean
comment
string
type
string (FeedbackType)
Value: "helix_user_meeting_skill"

Type of feedback

Responses

Request samples

Content type
{
  • "refId": 1,
  • "rating": true,
  • "comment": "This feedback is great!",
  • "type": "helix_user_meeting_skill"
}

Response samples

Content type
{
  • "success": true,
  • "id": 1
}

Update my feedback

Update a user's feedback by ID

query Parameters
feedbackId
required
number (FeedbackId)
Example: feedbackId=1

Feedback id

Request Body schema:
required
id
number (FeedbackId)

Feedback id

rating
boolean
comment
string

Responses

Request samples

Content type
{
  • "id": 1,
  • "rating": true,
  • "comment": "This feedback is great!"
}

Response samples

Content type
{
  • "success": true
}

Get my feedback

Fetch a user's feedback by ID

query Parameters
feedbackId
required
number (FeedbackId)
Example: feedbackId=1

Feedback id

Responses

Response samples

Content type
{
  • "id": 1,
  • "domainId": 1,
  • "userId": 1,
  • "refId": 1,
  • "rating": true,
  • "comment": "This feedback is great!",
  • "type": "helix_user_meeting_skill",
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "updatedTime": "2023-02-21T10:52:09.000Z"
}

Delete my feedback

Delete a user's feedback by ID

query Parameters
feedbackId
required
number (FeedbackId)
Example: feedbackId=1

Feedback id

Responses

Response samples

Content type
{
  • "success": true
}

Me - Filters

User specific operations for filters via Store routes.

Get topic filters for a user

Get topic filters for a user

query Parameters
topic
string

Responses

Me - Helix Access

User specific operations for helixAccess via Store routes.

Me - Managed Assets

User specific operations for managed assets via Store routes.

Fetch insights for a managed asset

Fetch insights for a managed asset. This also includes team specific asset insights for team managers.

path Parameters
assetId
required
string
query Parameters
teamIds
string

Responses

Fetch user stats for a managed asset

Fetch user stats for a managed asset. This also includes team specific asset stats for team managers.

path Parameters
assetId
required
string
query Parameters
search
string
progress
string
start
string
limit
string
order
string
column
string
teamIds
string

Responses

Me - Managed Playlists

User specific operations for managed playlists via Store routes.

Fetch insights for a managed playlist

Fetch insights for a managed playlist. This also includes team specific playlist insights for team managers.

path Parameters
playlistId
required
string
query Parameters
teamIds
string

Responses

Fetch user stats for a managed playlist

Fetch user stats for a managed playlist. This also includes team specific playlist stats for team managers.

path Parameters
playlistId
required
string
query Parameters
search
string
progress
string
start
string
limit
string
order
string
column
string
teamIds
string

Responses

Me - Managed Teams

User specific operations for managed teams via Store routes.

Fetch a user's managed teams

Fetch the total count and the list of teams which the user manages. By providing the hasUsers query parameter, the list of teams will be filtered to only include teams which have users. By providing the playlistId query parameter, the list of teams will be filtered to only include teams which have access to the playlist.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Fetch team details

Fetch the details for a team including playlist and user count

path Parameters
id
required
string

Responses

Fetch team insights

Fetch insights for a team for a set amount of days.

path Parameters
id
required
string
query Parameters
days
string

Responses

Fetch team trends

Fetch trends for a team for a set amount of days.

path Parameters
id
required
string
query Parameters
days
string

Responses

Fetch team members

Fetch member details and the member count for a team.

path Parameters
id
required
string
query Parameters
days
string
search
string
column
string
order
string

Responses

Fetch all team member details

Fetch details incl. team types and last activity data for all members of a team.

path Parameters
id
required
number (TeamId)
Example: 1

Team id

userId
required
number (UserId)
Example: 1

User id

Responses

Response samples

Content type
{
  • "id": 1,
  • "firstName": "John",
  • "lastName": "Doe",
  • "email": "john@5app.com",
  • "pictureUrl": {
    },
  • "teams": [
    ],
  • "lastAccess": "2023-02-21T10:52:09.000Z"
}

Fetch activity data for a team member

Fetch team member activity for a given duration.

path Parameters
id
required
string
userId
required
string
query Parameters
days
string

Responses

Fetch all team member playlists

Fetch all team member playlists and their count.

path Parameters
id
required
string
userId
required
string
query Parameters
column
string
order
string

Responses

Fetch all team member details

Fetch details incl. team types and last activity data for all members of a team.

path Parameters
userId
required
number (UserId)
Example: 1

User id

id
required
number (TeamId)
Example: 1

Team id

Responses

Response samples

Content type
{
  • "id": 1,
  • "firstName": "John",
  • "lastName": "Doe",
  • "email": "john@5app.com",
  • "pictureUrl": {
    },
  • "teams": [
    ],
  • "lastAccess": "2023-02-21T10:52:09.000Z"
}

Fetch activity data for a team member

Fetch team member activity for a given duration.

path Parameters
userId
required
string
query Parameters
days
string

Responses

Fetch all team member playlists

Fetch all team member playlists and their count.

path Parameters
userId
required
string
query Parameters
column
string
order
string

Responses

Me - Managed Team Types

User specific operations for managed team types via Store routes.

Fetch my managed team types

Fetch the managed team types

Responses

Me - Managed Users

User specific operations for managed users via Store routes.

Fetch a user's stats for a playlist

Fetch a user's stats for a specific playlist e.g. for a manager to check the user's playlist progress

path Parameters
userId
required
string
playlistId
required
string
query Parameters
limit
string
order
string
column
string
start
string

Responses

Me - Playlists

User specific operations for playlists via Store routes.

Fetch a user's playlists

Fetch all playlists available to a user in the store with pagination. Can be filtered whether the playlist has a badge.

query Parameters
search
string (MyPlaylistSearch)
Value: "badge"

Search terms to filter the query by.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "playlists": [
    ],
  • "nextOffset": 1,
  • "total": 100
}

Set a playlist as saved

Subscribe to a playlist by setting saved: 1 for a playlist within the userCollections

path Parameters
playlistId
required
string

Responses

Set a playlist as liked or unlike a playlist

Set a playlist within the userCollections as liked (rated_like: 1) or unlike the playlist (rated_like: 0)

path Parameters
playlistId
required
string
Request Body schema: application/json
isLiked
any

Responses

Request samples

Content type
application/json
{
  • "isLiked": "any"
}

Fetch all store playlists containing a specific asset

Fetch basic information for all playlists containing a specific asset available to the user in the store

path Parameters
assetId
required
number (ContentId)
Example: 1

Content id

Responses

Response samples

Content type
[
  • {
    }
]

Fetch recommended playlists

Get a randomised selection of recommended playlists for a user based on their activity

query Parameters
limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
[
  • [
    ]
]

Get playlists for browsing

Fetch playlists for a user to browse

query Parameters
limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

format
string (Format)
Value: "list"
Example: format=list

Explcitly return items within the standard list format, e.g. {items: [...items], total: 0, nextOffset: 0}

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Me - Profile

Operations for user profiles via Store routes.

Fetch a user's profile

Fetch a user's profile

Responses

Response samples

Content type
{
  • "id": 1,
  • "email": "user@5app.com",
  • "first_name": "Ada",
  • "last_name": "Lovelace",
  • "displayName": "Ada Lovelace",
  • "pictureUrl": null,
  • "settings": "Parsed JSON user settings",
  • "learning_progress": {
    },
  • "isAdmin": true,
  • "userCustomFields": [
    ],
  • "openCompleteProfile": true
}

Update a user's profile

Update a user's profile

Request Body schema: application/json
first_name
any
last_name
any

Responses

Request samples

Content type
application/json
{
  • "first_name": "any",
  • "last_name": "any"
}

Change a user's language

Change a user's account language

header Parameters
host
string

Responses

Fetch stats for a user's profile sections

Fetch the counts of earned badges, saved content items and content items with unachieved target

Responses

Response samples

Content type
{
  • "savedCount": 0,
  • "badgesTotalCount": 0,
  • "badgesAwardedCount": 0,
  • "dueCountComplete": 0,
  • "dueCountIncomplete": 0
}

Me - Settings

User specific operations for settings via Store routes.

Fetch user settings

Fetch user settings incl. notification_channel from userDomains

Responses

Update user settings

Update user settings incl. notification_channel in userDomains

header Parameters
host
string
Request Body schema: application/json
notification_channel
any
is_helix_hub
any
settings
any

Responses

Request samples

Content type
application/json
{
  • "notification_channel": "any",
  • "is_helix_hub": "any",
  • "settings": "any"
}

Me - Shared

Operations for content shared with a user via Store routes.

Fetch assets or playlists shared with a user

Fetch assets and playlists which were shared with a user

query Parameters
limit
number (Limit)
Example: limit=1

The number of items to return per page.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 100,
  • "nextOffset": 1
}

Dismiss assets or playlists shared with a user

Dismiss assets and playlists which were shared with a user as no longer shared

Request Body schema: application/json
share_ref_id
any
share_context_id
any

Responses

Request samples

Content type
application/json
{
  • "share_ref_id": "any",
  • "share_context_id": "any"
}

Me - Subscriptions

Operations for a user's subscriptions to e.g. comments via Store routes.

Unsubscribe a user's content comment subscription

Update all content comment subscriptions for a user to be set to unsubscribed.

Responses

Response samples

Content type
{
  • "success": true
}

Fetch user comment subscriptions

Fetch a user's content comment subscriptions

path Parameters
contentId
required
number (ContentId)
Example: 1

Content id

Responses

Response samples

Content type
{
  • "isSubscribed": true
}

Update a user's comment subscription

Update a user's comment subscription for a piece of content

path Parameters
contentId
required
number (ContentId)
Example: 1

Content id

Request Body schema:
required
isSubscribed
boolean

Responses

Request samples

Content type
{
  • "isSubscribed": true
}

Response samples

Content type
{
  • "isSubscribed": true
}

Mindset AI

Operations for Mindset AI via Store routes.

Fetch Mindset AI auth token

Uses hub config values to fetch the Mindset AI auth token

Responses

Response samples

Content type
{
  • "authToken": "TOKENSTRING"
}

Fetch Mindset AI agent uid

Uses hub config values to fetch the Mindset AI agent uid for this user

Responses

Response samples

Content type
{
  • "agentUid": "STRING"
}

Playlists

Operations for playlists and team playlists via Store routes.

Fetch a playlist for the current user

Fetch a playlist with user specific data

query Parameters
playlistId
required
number (ContentId)
Example: playlistId=1

Content id

Responses

Response samples

Content type
{
  • "id": 1,
  • "allow_member_contributions": true,
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "contentCount": 10,
  • "completionTime": "6",
  • "audience": "all",
  • "teamIds": [
    ],
  • "author": {
    },
  • "sharers": [
    ],
  • "badge": {
    },
  • "commentCount": 0,
  • "domain_id": 1,
  • "description": "Playlist description",
  • "hasPlaylistNumbering": true,
  • "isDeleted": false,
  • "lastUpdated": "2024-09-24T09:30:42.000Z",
  • "locale": "da-DK",
  • "name": "Playlist name",
  • "originatingId": 1,
  • "ownerTeamId": 1,
  • "pictureUrl": "`/api/content/1/thumb`",
  • "parentPlaylists": [
    ],
  • "rating_count": 1,
  • "saved": false,
  • "sourceDomain": {},
  • "tags": [
    ],
  • "topics": [
    ],
  • "type": "playlist",
  • "commentCountUser": 0,
  • "completionRate": 0,
  • "hasUserBadge": true,
  • "insightsEnabled": true,
  • "isSaved": false,
  • "user_rated_like": true,
  • "userContentStatus": "notstarted",
  • "recommendationType": "user",
  • "goal": {
    }
}

Fetch a playlist for the current user

Fetch a playlist with user specific data

query Parameters
playlistId
required
number (ContentId)
Example: playlistId=1

Content id

Responses

Response samples

Content type
{
  • "id": 1,
  • "allow_member_contributions": true,
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "contentCount": 10,
  • "completionTime": "6",
  • "audience": "all",
  • "teamIds": [
    ],
  • "author": {
    },
  • "sharers": [
    ],
  • "badge": {
    },
  • "commentCount": 0,
  • "domain_id": 1,
  • "description": "Playlist description",
  • "hasPlaylistNumbering": true,
  • "isDeleted": false,
  • "lastUpdated": "2024-09-24T09:30:42.000Z",
  • "locale": "da-DK",
  • "name": "Playlist name",
  • "originatingId": 1,
  • "ownerTeamId": 1,
  • "pictureUrl": "`/api/content/1/thumb`",
  • "parentPlaylists": [
    ],
  • "rating_count": 1,
  • "saved": false,
  • "sourceDomain": {},
  • "tags": [
    ],
  • "topics": [
    ],
  • "type": "playlist",
  • "commentCountUser": 0,
  • "completionRate": 0,
  • "hasUserBadge": true,
  • "insightsEnabled": true,
  • "isSaved": false,
  • "user_rated_like": true,
  • "userContentStatus": "notstarted",
  • "recommendationType": "user",
  • "goal": {
    }
}

Fetch a playlist's content for the current user

Fetch a playlist's user-accessible contents with user specific data

query Parameters
playlistId
required
number (ContentId)
Example: playlistId=1

Content id

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

format
string (Format)
Value: "list"
Example: format=list

Explcitly return items within the standard list format, e.g. {items: [...items], total: 0, nextOffset: 0}

Responses

Response samples

Content type
{
  • "items": {
    },
  • "total": 100,
  • "nextOffset": 1
}

Fetch all team playlists

Get all team playlists by teamId

query Parameters
teamId
number (TeamId)
Example: teamId=1

Team id

Responses

Response samples

Content type
{
  • "list": [
    ]
}

Create a playlist

Create a new playlist and, if supplied, assign the team as the owner

Request Body schema:
required
name
required
string
description
string or null
locale
string (Locale)
Enum: "da-DK" "de-DE" "de-DE-Sie" "en-GB" "en-US" "es-ES" "fi-FI" "fr-FR" "hu-HU" "it-IT" "ja-JP" "ko-KR" "nl-NL" "no-NO" "pl-PL" "pt-PT" "ro-RO" "ru-RU" "sv-SE" "th-TH" "zh-CN" "zh-TW"

Locale supported by the hub

tags
Array of numbers (TagIds)
topics
Array of numbers (TopicIds)
thumbnailId
number (ContentThumbnailId)

thumbnailId of the content

ownerTeamId
number (OwnerTeamId)

Team id of the content owning team

allow_member_contributions
boolean or null
playlist_numbering
boolean or null
optional
boolean (ContentOptional)
Default: false

Whether the content has been marked as 'optional' by the user within the specified playlist

parentPlaylistId
number (ContentId)

Content id

selectedTopicId
number (TopicId)

Topic id

Responses

Request samples

Content type
{
  • "name": "Playlist name",
  • "description": "Playlist description",
  • "locale": "da-DK",
  • "tags": [
    ],
  • "topics": [
    ],
  • "thumbnailId": 1,
  • "ownerTeamId": 1,
  • "allow_member_contributions": true,
  • "playlist_numbering": true,
  • "optional": false,
  • "parentPlaylistId": 1,
  • "selectedTopicId": 1
}

Response samples

Content type
{
  • "id": 1,
  • "allow_member_contributions": true,
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "contentCount": 10,
  • "completionTime": "6",
  • "audience": "all",
  • "teamIds": [
    ],
  • "author": {
    },
  • "sharers": [
    ],
  • "badge": {
    },
  • "commentCount": 0,
  • "domain_id": 1,
  • "description": "Playlist description",
  • "hasPlaylistNumbering": true,
  • "isDeleted": false,
  • "lastUpdated": "2024-09-24T09:30:42.000Z",
  • "locale": "da-DK",
  • "name": "Playlist name",
  • "originatingId": 1,
  • "ownerTeamId": 1,
  • "pictureUrl": "`/api/content/1/thumb`",
  • "parentPlaylists": [
    ],
  • "rating_count": 1,
  • "saved": false,
  • "sourceDomain": {},
  • "tags": [
    ],
  • "topics": [
    ],
  • "type": "playlist",
  • "commentCountUser": 0,
  • "completionRate": 0,
  • "hasUserBadge": true,
  • "insightsEnabled": true,
  • "isSaved": false,
  • "user_rated_like": true,
  • "userContentStatus": "notstarted",
  • "recommendationType": "user",
  • "goal": {
    },
  • "index": 1
}

Fetch a playlist

Get a single playlist by id

path Parameters
playlistId
required
number (ContentId)
Example: 1

Content id

query Parameters
includeDeleted
boolean (IncludeDeletedPlaylist)
Default: false
Example: includeDeleted=false

Whether data for a deleted playlist should be included in the response.

Responses

Response samples

Content type
{
  • "id": 1,
  • "allow_member_contributions": true,
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "contentCount": 10,
  • "completionTime": "6",
  • "audience": "all",
  • "teamIds": [
    ],
  • "author": {
    },
  • "sharers": [
    ],
  • "badge": {
    },
  • "commentCount": 0,
  • "domain_id": 1,
  • "description": "Playlist description",
  • "hasPlaylistNumbering": true,
  • "isDeleted": false,
  • "lastUpdated": "2024-09-24T09:30:42.000Z",
  • "locale": "da-DK",
  • "name": "Playlist name",
  • "originatingId": 1,
  • "ownerTeamId": 1,
  • "pictureUrl": "`/api/content/1/thumb`",
  • "parentPlaylists": [
    ],
  • "rating_count": 1,
  • "saved": false,
  • "sourceDomain": {},
  • "tags": [
    ],
  • "topics": [
    ],
  • "type": "playlist"
}

Update a playlist

Update update one or multiple fields of a playlist by id

path Parameters
playlistId
required
number (ContentId)
Example: 1

Content id

Request Body schema:
required
name
string or null
description
string or null
locale
string (Locale)
Enum: "da-DK" "de-DE" "de-DE-Sie" "en-GB" "en-US" "es-ES" "fi-FI" "fr-FR" "hu-HU" "it-IT" "ja-JP" "ko-KR" "nl-NL" "no-NO" "pl-PL" "pt-PT" "ro-RO" "ru-RU" "sv-SE" "th-TH" "zh-CN" "zh-TW"

Locale supported by the hub

tags
Array of numbers (TagIds)
topics
Array of numbers (TopicIds)
thumbnailId
number (ContentThumbnailId)

thumbnailId of the content

ownerTeamId
number (OwnerTeamId)

Team id of the content owning team

allow_member_contributions
boolean or null
playlist_numbering
boolean or null
externalRefId
string or null

Custom data

optional
boolean (ContentOptional)
Default: false

Whether the content has been marked as 'optional' by the user within the specified playlist

parentPlaylistId
number (ContentId)

Content id

Responses

Request samples

Content type
{
  • "name": "Playlist name",
  • "description": "Playlist description",
  • "locale": "da-DK",
  • "tags": [
    ],
  • "topics": [
    ],
  • "thumbnailId": 1,
  • "ownerTeamId": 1,
  • "allow_member_contributions": true,
  • "playlist_numbering": true,
  • "externalRefId": "string",
  • "optional": false,
  • "parentPlaylistId": 1
}

Response samples

Content type
{
  • "id": 1,
  • "allow_member_contributions": true,
  • "createdTime": "2023-02-21T10:52:09.000Z",
  • "contentCount": 10,
  • "completionTime": "6",
  • "audience": "all",
  • "teamIds": [
    ],
  • "author": {
    },
  • "sharers": [
    ],
  • "badge": {
    },
  • "commentCount": 0,
  • "domain_id": 1,
  • "description": "Playlist description",
  • "hasPlaylistNumbering": true,
  • "isDeleted": false,
  • "lastUpdated": "2024-09-24T09:30:42.000Z",
  • "locale": "da-DK",
  • "name": "Playlist name",
  • "originatingId": 1,
  • "ownerTeamId": 1,
  • "pictureUrl": "`/api/content/1/thumb`",
  • "parentPlaylists": [
    ],
  • "rating_count": 1,
  • "saved": false,
  • "sourceDomain": {},
  • "tags": [
    ],
  • "topics": [
    ],
  • "type": "playlist",
  • "commentCountUser": 0,
  • "completionRate": 0,
  • "hasUserBadge": true,
  • "insightsEnabled": true,
  • "isSaved": false,
  • "user_rated_like": true,
  • "userContentStatus": "notstarted",
  • "recommendationType": "user",
  • "goal": {
    }
}

Delete playlist

Soft deletes a playlist by id

query Parameters
playlistId
required
number (ContentId)
Example: playlistId=1

Content id

Responses

Response samples

Content type
{
  • "success": true
}

Fetch a playlist and its content

Fetch a playlist with its contents

query Parameters
playlistId
required
number (ContentId)
Example: playlistId=1

Content id

limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

includeDeleted
boolean (IncludeDeletedPlaylist)
Default: false
Example: includeDeleted=false

Whether data for a deleted playlist should be included in the response.

Responses

Response samples

Content type
{
  • "items": {
    },
  • "total": 100,
  • "nextOffset": 1
}

Update playlist content

Update the content (assets, playlists, sections) and content order of a playlist and create new sections.
Note: all content of the playlist must be sent with contentId and rank (and any changes). Only new sections to be created are sent without a contentId.
If content is not sent, it will be removed from the playlist. Removed sections will additionally be deleted.

path Parameters
playlistId
required
number (ContentId)
Example: 1

Content id

Request Body schema:
required
Array
Any of
rank
required
string (PlaylistContentRank)

Ranking of a piece of content within a playlist. Up to 3 levels deep.

object (PlaylistSectionNewDetails)

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "success": true
}

Reports

Operations for reports via Store routes.

Fetch available team reports

Return a list of all available team reports. Can be accessed by Admins with "Report Read" permission and by team managers, if the "Manager Reports" feature flag is enabled.

query Parameters
teamId
string

Responses

Fetch a report

Returns a report. Can be accessed by Admins with "Report Read" permission and by team managers, if the "Manager Reports" feature flag is enabled.

path Parameters
id
required
string
query Parameters
table
string
fields
string
filter
string
notfound
string
attachment
string
format
string
teamId
string
sessionToken
string

Responses

skills-analysis

Operations for Helix skill analysis via Store routes.

Get the skills analysis for a specific week and surrounding period

Get skill analysis data to show progress over a 13 week period in the graph friendly format.

query Parameters
weekCommencingDate
string (UserAnalysisWeekCommencementDate)
Example: weekCommencingDate=2023-10-08

The week commencing date of a user`s skill analysis

teamId
number (TeamId)
Example: teamId=1

Team id

Responses

Response samples

Content type
{
  • "skills": [
    ],
  • "dates": [
    ]
}

Get the skills analysis for a specific week broken down by user or team.

Get the skills analysis for a specific week broken down by user or team.

query Parameters
weekCommencingDate
string (UserAnalysisWeekCommencementDate)
Example: weekCommencingDate=2023-10-08

The week commencing date of a user`s skill analysis

teamId
number (TeamId)
Example: teamId=1

Team id

teamTypeId
number (TeamTypeId)
Example: teamTypeId=1

TeamType id

object
limit
number (Limit)
Example: limit=1

The number of items to return per page.

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "nextOffset": 10
}

Get the avaliable weeks and teams for skills analysis

Get the avaliable helix analysis weeks, helix reporting team type and helix reporting teams for skills analysis

Responses

Response samples

Content type
{
  • "dates": [
    ],
  • "teams": [
    ],
  • "helixReportingTeamType": {
    }
}

Tags

Operations for tags via Store routes.

Create tags

Create new tags in the hub without assigning them to content

Request Body schema: application/json
map(tagName
any
length
any

Responses

Request samples

Content type
application/json
{
  • "map(tagName": "any",
  • "length": "any"
}

Get all tags

Get all hub tags

Responses

Topics

Operations for topics via Store routes.

Fetch all topics

Get all topics in the hub.

Responses

Post topic rank

Update the ranking of topics.

path Parameters
topicId
required
string
query Parameters
index
string
parentTopicId
string

Responses

URL

Operations for urls via Store routes.

Get URL

Get the URL address of e.g. an asset

query Parameters
url
string

Responses

user-analysis

Operations for user analyses recorded through Helix.

Get user analysis for a specific user and week

Get user skill analysis and meetings for a specific week using Helix. By default returns the newest analysis

query Parameters
userId
number (UserId)
Example: userId=1

User id

weekCommencingDate
string (UserAnalysisWeekCommencementDate)
Example: weekCommencingDate=2023-10-08

The week commencing date of a user`s skill analysis

Responses

Response samples

Content type
{
  • "id": 1,
  • "userId": 1,
  • "summary": "string",
  • "analysisWeekCommencementDate": "2023-10-08",
  • "userMeetings": [
    ]
}

Get list of weeks with analysis for a specific user

Get descending list of commencement dates of weeks with analysis for a specific user using Helix.

query Parameters
userId
number (UserId)
Example: userId=1

User id

offset
number (Offset)
Example: offset=1

The number used to identify the starting point to return rows from a result set.

limit
number (Limit)
Example: limit=1

The number of items to return per page.

Responses

Response samples

Content type
{
  • "items": [
    ],
  • "total": 2,
  • "offset": 0,
  • "limit": 10000
}

Get list of users skills analysis for a specific user and week period

Get user skill analysis data to show progress over week period in the graph friendly format.

query Parameters
userId
number (UserId)
Example: userId=1

User id

skillId
number (UserAnalysisSkillId)
Example: skillId=1

User analysis skill id

weekCommencingDate
string (UserAnalysisWeekCommencementDate)
Example: weekCommencingDate=2023-10-08

The week commencing date of a user`s skill analysis

Responses

Response samples

Content type
{
  • "skills": [
    ],
  • "dates": [
    ]
}

Get user meeting analysis for a specific user and meeting

Get user meeting analysis for a specific meeting using Helix

path Parameters
meetingId
required
number (MeetingId)
Example: 1

Meeting id

query Parameters
userId
number (UserId)
Example: userId=1

User id

Responses

Response samples

Content type
{
  • "id": 1,
  • "meetingId": 1,
  • "title": "Meeting Title",
  • "startTime": "2025-01-16T13:30:00.000Z",
  • "endTime": "2025-01-16T13:46:12.838Z",
  • "organiserEmail": "admin@5app.com",
  • "meetingPlatform": "Slack",
  • "summary": "string",
  • "userMeetingSkills": [
    ]
}

Get user skill analysis for a specific user and skill

Get user skill analysis for a specific skill using Helix

path Parameters
skillId
required
number (SkillId)
Example: 1

Helix skill id

query Parameters
userId
number (UserId)
Example: userId=1

User id

weekCommencingDate
string (UserAnalysisWeekCommencementDate)
Example: weekCommencingDate=2023-10-08

The week commencing date of a user`s skill analysis

Responses

Response samples

Content type
{
  • "id": 1,
  • "analysisWeekCommencementDate": "2025-06-16",
  • "summary": "Analysis summary for the skill",
  • "description": "Description of the skill",
  • "suggestion": "Suggestion for improvement",
  • "score": 11,
  • "skillId": 1,
  • "skillUsage": {
    },
  • "userMeetings": [
    ]
}

Recommendations

Operations for recommendations via Sharing routes.

Get users or teams to recommend content to

Get a list of users or teams to recommend content to depending on their permissions.

query Parameters
assetIds
Array of numbers (ContentIds)
Example: assetIds=1
playlistIds
Array of numbers (ContentIds)
Example: playlistIds=1
query
string (Search)
Example: query=playlistName

Search terms to filter the result by.

collections
string
in
string
schema
string

Responses

Response samples

Content type
{
  • "teams": [
    ],
  • "users": [
    ]
}

Recommend content to users or teams

Share recommended content to users or teams via email, same as the share content nudge actions.

Request Body schema: application/json
share_ref_ids
any
share_context_ids
any
sendEmail
any
subject
any
message
any
testMode
any
label
any
searchQuery
any
limit
any
user_ids
any
team_ids
any
type
any

Responses

Request samples

Content type
application/json
{
  • "share_ref_ids": "any",
  • "share_context_ids": "any",
  • "sendEmail": "any",
  • "subject": "any",
  • "message": "any",
  • "testMode": "any",
  • "label": "any",
  • "searchQuery": "any",
  • "limit": "any",
  • "user_ids": "any",
  • "team_ids": "any",
  • "type": "any"
}

Delete a team recommendation

Delete a content recommendation for a team to stop auto-sharing a playlist with a team from the team settings. Used by admins.

Request Body schema: application/json
team_id
any
playlist_id
any
action
any

Responses

Request samples

Content type
application/json
{
  • "team_id": "any",
  • "playlist_id": "any",
  • "action": "any"
}

Files

Operations for files via Files routes.

Get thumbnail for users and content

Get the thumbnail for an asset or playlist by the contentId. Or user avatar. The thumbnail can be requested in different sizes.

path Parameters
pictureId
required
number (FileId)
Example: 1

File id

dimensions?
required
string
dimensions
required
string (ImageDimensions)
Example: /w_75,h_50

The size of the picture in pixels

Responses

Get the file's upload policy.

Use the file to get it's S3 upload policy and token for processing the file after upload.

Request Body schema: application/json
filename
any
contentType
any
size
any
type
any
referenceId
any
referenceIds
any
language
any
alternativeText
any
style
any
skipPostProcessing
any
skipAssigningToReference
any
notifyOnProcessingCompletion
any

Responses

Request samples

Content type
application/json
{
  • "filename": "any",
  • "contentType": "any",
  • "size": "any",
  • "type": "any",
  • "referenceId": "any",
  • "referenceIds": "any",
  • "language": "any",
  • "alternativeText": "any",
  • "style": "any",
  • "skipPostProcessing": "any",
  • "skipAssigningToReference": "any",
  • "notifyOnProcessingCompletion": "any"
}

Upload and process a file

Upload and postprocess a file depending on its type

Request Body schema: application/json
error
any
uploadToken
any

Responses

Request samples

Content type
application/json
{
  • "error": "any",
  • "uploadToken": "any"
}

Get file information

Get file information by it's id, such as its status, duration and notification settings

path Parameters
fileId
required
number (FileId)
Example: 1

File id

Responses

Response samples

Content type
{
  • "fileStatus": "draft",
  • "duration": "The actual duration of an asset in minutes if available. E.g. the length of the video or of the audio file.",
  • "notifyOnProcessingCompletion": false
}

Cancel file post-processing notification

Cancel the post-processing notification for a file

path Parameters
fileId
required
string

Responses

Content Files

Operations for content files via Files routes.

Get asset file by type

Get an asset's file by asset ID and type. When fetching subtitle files, also provide the subtitle id.

path Parameters
assetId
required
string
type
required
string
subId?
required
string
query Parameters
cdn
string
redirect
string
download
string
wrap
string
baseUrl
string
header Parameters
user-agent
string

Responses

Messages

Operations for messages via Message routes.

Send a content request message

Send a user's content request form to the admin

Request Body schema: application/json
content
any
name
any

Responses

Request samples

Content type
application/json
{
  • "content": "any",
  • "name": "any"
}

Get messages and unread count

Get all message and the unread messages count for a user

Responses

Mark all message as read

Mark all message as read by a user

Request Body schema: application/json
read
any

Responses

Request samples

Content type
application/json
{
  • "read": "any"
}

Mark message as read

Mark a message as read by a user

path Parameters
id
required
string
Request Body schema: application/json
read
any

Responses

Request samples

Content type
application/json
{
  • "read": "any"
}

Mindsmith Editor

Operations for Mindsmith Editor via Webhook routes.

Launch the mindsmith editor

Redirect page request to the Mindsmith editor. Either start a new course or edit an existing course by passing through an assetId

Responses

Launch the mindsmith editor

Redirect page request to the Mindsmith editor. Either start a new course or edit an existing course by passing through an assetId

Responses