Use Thrive Learning in Sim to manage learners, audiences, assignments, enrolments, and completion records. Workflows can look up users by ID or ref, manage audience members and managers, and retrieve content and activity data.
Manage user lifecycle, audiences and their members and managers, content assignments and enrolments, learning completions, content and activity records, CPD, tags, and skills.
Create a new user in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host refstring Yes Your organisation's unique identifier for this individual firstNamestring Yes The given name of the individual lastNamestring Yes The family name of the individual emailstring No The email address for the user (required unless loginMethod is 'ref') loginMethodstring No How the user logs in: 'email' or 'ref' (defaults to 'email') rolestring No Role assigned: 'administrator', 'learneradmin', or 'learner' (defaults to 'learner') jobTitlestring No Name of this individual's role in your organisation managerRefstring No Your organisation's unique identifier for this individual's line manager startDatestring No Date this individual started with your organisation (ISO 8601) endDatestring No Date this individual left your organisation (ISO 8601) timeZonestring No The user's preferred timezone (tenant default if omitted) languageCodestring No The user's preferred language (e.g. 'en-gb') ssoboolean No Whether the account is managed by an authentication provider domainstring No Domain this individual is associated with additionalFieldsstring No JSON object of custom field key-value pairs. Example: {"department":"Sales"}
Parameter Type Description userobject The created user ↳ id string The user ID ↳ loginMethod string How the user logs in ↳ ref string Your organisation's unique identifier for the user ↳ email string The email address for the user ↳ firstName string The given name of the individual ↳ lastName string The family name of the individual ↳ role string Role assigned to this individual ↳ jobTitle string Name of this individual's role ↳ managerRef string The line manager's ref ↳ startDate string Date started with the organisation ↳ endDate string Date left the organisation ↳ timeZone string The user's preferred timezone ↳ languageCode string The user's preferred language ↳ active boolean Whether the account is active or suspended ↳ createdAt string Date/time the user was created ↳ updatedAt string Date/time the user was last modified ↳ sso boolean Whether the account is managed by an auth provider ↳ domain string Domain this individual is associated with ↳ additionalFields json Custom field values for this user
Update an existing user in Thrive by ref. Only the fields provided are changed.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host refstring Yes The user ref to update firstNamestring No The given name of the individual lastNamestring No The family name of the individual emailstring No The email address for the user loginMethodstring No How the user logs in: 'email' or 'ref' rolestring No Role assigned: 'administrator', 'learneradmin', or 'learner' jobTitlestring No Name of this individual's role in your organisation managerRefstring No Your organisation's unique identifier for this individual's line manager startDatestring No Date this individual started with your organisation (ISO 8601) endDatestring No Date this individual left your organisation (ISO 8601) timeZonestring No The user's preferred timezone languageCodestring No The user's preferred language (e.g. 'en-gb') ssoboolean No Whether the account is managed by an authentication provider domainstring No Domain this individual is associated with additionalFieldsstring No JSON object of custom field key-value pairs. Example: {"department":"Sales"}
Parameter Type Description userobject The updated user ↳ id string The user ID ↳ loginMethod string How the user logs in ↳ ref string Your organisation's unique identifier for the user ↳ email string The email address for the user ↳ firstName string The given name of the individual ↳ lastName string The family name of the individual ↳ role string Role assigned to this individual ↳ jobTitle string Name of this individual's role ↳ managerRef string The line manager's ref ↳ startDate string Date started with the organisation ↳ endDate string Date left the organisation ↳ timeZone string The user's preferred timezone ↳ languageCode string The user's preferred language ↳ active boolean Whether the account is active or suspended ↳ createdAt string Date/time the user was created ↳ updatedAt string Date/time the user was last modified ↳ sso boolean Whether the account is managed by an auth provider ↳ domain string Domain this individual is associated with ↳ additionalFields json Custom field values for this user
Permanently delete (obfuscate) a user in Thrive by ref while retaining training history.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host refstring Yes The user ref to delete
Parameter Type Description successboolean Whether the user was deleted
Suspend a user in Thrive by ref, marking the account inactive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host refstring Yes The user ref to suspend endDatestring No The date this individual left your organisation (ISO 8601)
Parameter Type Description userobject The suspended user ↳ id string The user ID ↳ loginMethod string How the user logs in ↳ ref string Your organisation's unique identifier for the user ↳ email string The email address for the user ↳ firstName string The given name of the individual ↳ lastName string The family name of the individual ↳ role string Role assigned to this individual ↳ jobTitle string Name of this individual's role ↳ managerRef string The line manager's ref ↳ startDate string Date started with the organisation ↳ endDate string Date left the organisation ↳ timeZone string The user's preferred timezone ↳ languageCode string The user's preferred language ↳ active boolean Whether the account is active or suspended ↳ createdAt string Date/time the user was created ↳ updatedAt string Date/time the user was last modified ↳ sso boolean Whether the account is managed by an auth provider ↳ domain string Domain this individual is associated with ↳ additionalFields json Custom field values for this user
Search users in Thrive and return basic user information with pagination.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 100) updatedSincestring No Return only users updated on or after this date/time (ISO 8601) statusesstring No Comma-separated statuses to include: active, inactive, expired, new omitStatusesstring No Comma-separated statuses to exclude: active, inactive, expired, new statusstring No Filter by a single status: active, inactive, expired, or new
Parameter Type Description resultsarray The matching users ↳ id string The user's ID ↳ ref string The user's ref ↳ firstName string The user's first name ↳ lastName string The user's last name ↳ email string The user's email ↳ role string The user's role ↳ status string The user's status ↳ positions array The user's positions ↳ id string The user ID ↳ manager object Line manager details ↳ id string The manager's user ID ↳ name string The manager's full name ↳ ref string The manager's unique reference ↳ ouId string The organisational unit ID ↳ isActive boolean Whether the position is active ↳ startDate string Start date (ISO 8601) ↳ endDate string End date (ISO 8601) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) ↳ additionalFields json Custom field values ↳ languageCode string The user's language code ↳ deleted boolean Whether the user has been deleted ↳ compliance number The user's compliance score ↳ level number The user's level ↳ firstLogin string First login timestamp (ISO 8601) ↳ lastLogin string Last login timestamp (ISO 8601) ↳ tags json Tag membership (e.g. skills) ↳ usersFollowing array IDs of users this user follows ↳ tagsFollowing array Tags this user follows ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) ↳ hasPicture boolean Whether the user has a profile picture ↳ timeZone string The user's time zone ↳ summary string The user's summary ↳ relevancy number The user's relevancy score ↳ rank json The user's rank details ↳ agreedTerms boolean Whether the user agreed to the terms ↳ onboarded boolean Whether the user has been onboarded ↳ audiences array Audience IDs the user belongs to ↳ singleSignOn boolean Whether the user uses single sign-on paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Get a single user in Thrive by their ID and return basic user information.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host idstring Yes The user ID
Parameter Type Description userobject The user ↳ id string The user's ID ↳ ref string The user's ref ↳ firstName string The user's first name ↳ lastName string The user's last name ↳ email string The user's email ↳ role string The user's role ↳ status string The user's status ↳ positions array The user's positions ↳ id string The user ID ↳ manager object Line manager details ↳ id string The manager's user ID ↳ name string The manager's full name ↳ ref string The manager's unique reference ↳ ouId string The organisational unit ID ↳ isActive boolean Whether the position is active ↳ startDate string Start date (ISO 8601) ↳ endDate string End date (ISO 8601) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) ↳ additionalFields json Custom field values ↳ languageCode string The user's language code ↳ deleted boolean Whether the user has been deleted ↳ compliance number The user's compliance score ↳ level number The user's level ↳ firstLogin string First login timestamp (ISO 8601) ↳ lastLogin string Last login timestamp (ISO 8601) ↳ tags json Tag membership (e.g. skills) ↳ usersFollowing array IDs of users this user follows ↳ tagsFollowing array Tags this user follows ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) ↳ hasPicture boolean Whether the user has a profile picture ↳ timeZone string The user's time zone ↳ summary string The user's summary ↳ relevancy number The user's relevancy score ↳ rank json The user's rank details ↳ agreedTerms boolean Whether the user agreed to the terms ↳ onboarded boolean Whether the user has been onboarded ↳ audiences array Audience IDs the user belongs to ↳ singleSignOn boolean Whether the user uses single sign-on
Get a single user in Thrive by their ref and return basic user information.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host refstring Yes The user ref
Parameter Type Description userobject The user (basic information) ↳ id string The user's ID ↳ ref string The user's ref ↳ firstName string The user's first name ↳ lastName string The user's last name ↳ email string The user's email ↳ role string The user's role ↳ status string The user's status ↳ positions array The user's positions ↳ id string The user ID ↳ manager object Line manager details ↳ id string The manager's user ID ↳ name string The manager's full name ↳ ref string The manager's unique reference ↳ ouId string The organisational unit ID ↳ isActive boolean Whether the position is active ↳ startDate string Start date (ISO 8601) ↳ endDate string End date (ISO 8601) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) ↳ additionalFields json Custom field values ↳ languageCode string The user's language code
List audiences and structures in Thrive with pagination.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host apiControlledboolean No Filter to only return audiences which are / are not API controlled updatedSincestring No Return only audiences updated on or after this date/time (ISO 8601) pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 100)
Parameter Type Description resultsarray The matching audiences ↳ id string The id of the audience ↳ name string The name of the audience ↳ reference string The external reference for the audience ↳ apiControlled boolean Whether the audience is API controlled ↳ category string Either "audience" or "structure" ↳ type string Either "manual" or "smart" ↳ parent object Parent audience/structure information ↳ name string The name of the parent audience ↳ reference string The external reference for the parent ↳ id string The id of the parent audience/structure ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Create a new audience or structure in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host namestring No The name of the audience (max 100 characters) referencestring No The external reference for the audience (max 100 characters) parentIdstring No The id or reference of the parent audience/structure; leave blank for a parent audience/structure categorystring No The audience category: 'audience' or 'structure'
Parameter Type Description audienceobject The created audience ↳ id string The id of the audience ↳ name string The name of the audience ↳ reference string The external reference for the audience ↳ apiControlled boolean Whether the audience is API controlled ↳ category string Either "audience" or "structure" ↳ type string Either "manual" or "smart" ↳ parent object Parent audience/structure information ↳ name string The name of the parent audience ↳ reference string The external reference for the parent ↳ id string The id of the parent audience/structure ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601)
Get a single audience or structure in Thrive by id or reference.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference
Parameter Type Description audienceobject The audience ↳ id string The id of the audience ↳ name string The name of the audience ↳ reference string The external reference for the audience ↳ apiControlled boolean Whether the audience is API controlled ↳ category string Either "audience" or "structure" ↳ type string Either "manual" or "smart" ↳ parent object Parent audience/structure information ↳ name string The name of the parent audience ↳ reference string The external reference for the parent ↳ id string The id of the parent audience/structure ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601)
Update an audience in Thrive, optionally moving it to a new parent.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference namestring No The name of the audience (max 100 characters) referencestring No The external reference for the audience (max 100 characters) parentIdstring No The id of the parent audience/structure to move the audience to
Parameter Type Description audienceobject The updated audience ↳ id string The id of the audience ↳ name string The name of the audience ↳ reference string The external reference for the audience ↳ apiControlled boolean Whether the audience is API controlled ↳ category string Either "audience" or "structure" ↳ type string Either "manual" or "smart" ↳ parent object Parent audience/structure information ↳ name string The name of the parent audience ↳ reference string The external reference for the parent ↳ id string The id of the parent audience/structure ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601)
Delete an audience in Thrive (only if it has no child audiences).
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference
Parameter Type Description successboolean Whether the audience was deleted
List the members of a Thrive audience with pagination.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 100)
Parameter Type Description resultsarray The audience members ↳ userId string The user's id ↳ reference string The user's reference ↳ email string The user's email paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Add members to a Thrive audience by email, ref, or id.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference usersstring Yes JSON array of user emails/refs/ids to add (1-100). Example: ["user@example.com "]
Parameter Type Description resultobject The add/replace result, with successfully and unsuccessfully processed entities ↳ success object Successfully processed entities ↳ count number Number of successfully processed entities ↳ entities array The successfully processed entities ↳ reference string The entity reference ↳ failure object Unsuccessfully processed entities ↳ count number Number of unsuccessfully processed entities ↳ entities array The unsuccessfully processed entities ↳ reason string The reason for the failure ↳ reference string The entity reference
Replace a Thrive audience's entire members list with the given users (does not support an empty array).
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference usersstring Yes JSON array of user emails/refs/ids that replaces the whole members list (1-100, no empty array). Example: ["user@example.com "]
Parameter Type Description resultobject The add/replace result, with successfully and unsuccessfully processed entities ↳ success object Successfully processed entities ↳ count number Number of successfully processed entities ↳ entities array The successfully processed entities ↳ reference string The entity reference ↳ failure object Unsuccessfully processed entities ↳ count number Number of unsuccessfully processed entities ↳ entities array The unsuccessfully processed entities ↳ reason string The reason for the failure ↳ reference string The entity reference
Remove a single member from a Thrive audience.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference userRefstring Yes The user email, ref, or id to remove
Parameter Type Description successboolean Whether the audience member was removed
List the managers of a Thrive audience.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference
Parameter Type Description managersarray The audience managers ↳ userId string The user's id ↳ reference string The user's reference ↳ email string The user's email ↳ permissions object The manager permissions ↳ audienceManager json Audience manager permissions ↳ peopleManager json People manager permissions ↳ administrator json Administrator permissions (structures only)
Add managers to a Thrive audience with their permissions.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference managersstring Yes JSON array of manager objects (1-100). Each: {"reference":"user@example.com ","permissions":{"audienceManager":{"manageContent":true,"assignments":true},"peopleManager":{"canViewLearnPage":true,"insights":false,"manage":false},"administrator":{"canAddAudienceManagers":false}}}
Parameter Type Description resultobject The add/replace result, with successfully and unsuccessfully processed entities ↳ success object Successfully processed entities ↳ count number Number of successfully processed entities ↳ entities array The successfully processed entities ↳ reference string The entity reference ↳ failure object Unsuccessfully processed entities ↳ count number Number of unsuccessfully processed entities ↳ entities array The unsuccessfully processed entities ↳ reason string The reason for the failure ↳ reference string The entity reference
Replace a Thrive audience's entire manager list with the given managers (does not support an empty array).
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference managersstring Yes JSON array of manager objects that replaces the whole manager list (1-100, no empty array). Each: {"reference":"user@example.com ","permissions":{"audienceManager":{"manageContent":true,"assignments":true},"peopleManager":{"canViewLearnPage":true,"insights":false,"manage":false},"administrator":{"canAddAudienceManagers":false}}}
Parameter Type Description resultobject The add/replace result, with successfully and unsuccessfully processed entities ↳ success object Successfully processed entities ↳ count number Number of successfully processed entities ↳ entities array The successfully processed entities ↳ reference string The entity reference ↳ failure object Unsuccessfully processed entities ↳ count number Number of unsuccessfully processed entities ↳ entities array The unsuccessfully processed entities ↳ reason string The reason for the failure ↳ reference string The entity reference
Remove a single manager from a Thrive audience.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience id or audience reference userIdstring Yes The user email, ref, or id to remove as a manager
Parameter Type Description successboolean Whether the audience manager was removed
List compliance assignments in Thrive, optionally filtered by audience.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring No Filter by audience ID or audience reference updatedSincestring No Return only items updated on or after this date/time (ISO 8601) pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-100, default 100)
Parameter Type Description assignmentsarray The matching assignments ↳ id string The assignment ID ↳ audienceId string The audience ID ↳ primaryContentId string The content ID for the primary content ↳ alternativeContentIds array Content IDs that can also complete the assignment ↳ hideAlternativeContent boolean Whether to hide the alternative content ↳ completionPeriod number Number of days required to complete the assignment ↳ recurrence number Number of days until the assignment reoccurs ↳ isActive boolean Whether the assignment is active ↳ isDeleted boolean Whether the assignment is deleted ↳ createdAt string Creation timestamp (ISO 8601) ↳ deletedAt string Deletion timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601)
Create a compliance assignment in Thrive for an audience and content item.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceIdstring Yes The audience ID contentIdstring Yes The content ID for the primary content alternativeContentIdsstring No JSON array of content IDs that can also complete the assignment hideAlternativeContentboolean No Whether to hide the alternative content completionPeriodnumber No The number of days required to complete the assignment (default 30) recurrencenumber No The number of days until the assignment will reoccur
Parameter Type Description assignmentobject The created assignment ↳ id string The assignment ID ↳ audienceId string The audience ID ↳ primaryContentId string The content ID for the primary content ↳ alternativeContentIds array Content IDs that can also complete the assignment ↳ hideAlternativeContent boolean Whether to hide the alternative content ↳ completionPeriod number Number of days required to complete the assignment ↳ recurrence number Number of days until the assignment reoccurs ↳ isActive boolean Whether the assignment is active ↳ isDeleted boolean Whether the assignment is deleted ↳ createdAt string Creation timestamp (ISO 8601) ↳ deletedAt string Deletion timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601)
Get a single compliance assignment in Thrive by its ID.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host assignmentIdstring Yes The assignment ID
Parameter Type Description assignmentobject The assignment ↳ id string The assignment ID ↳ audienceId string The audience ID ↳ primaryContentId string The content ID for the primary content ↳ alternativeContentIds array Content IDs that can also complete the assignment ↳ hideAlternativeContent boolean Whether to hide the alternative content ↳ completionPeriod number Number of days required to complete the assignment ↳ recurrence number Number of days until the assignment reoccurs ↳ isActive boolean Whether the assignment is active ↳ isDeleted boolean Whether the assignment is deleted ↳ createdAt string Creation timestamp (ISO 8601) ↳ deletedAt string Deletion timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601)
Update a compliance assignment in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host assignmentIdstring Yes The assignment ID audienceIdstring Yes The audience ID contentIdstring No The content ID for the primary content completionPeriodnumber No The number of days required to complete the assignment recurrencenumber No The number of days until the assignment will reoccur alternativeContentIdsstring No JSON array of content IDs that can also complete the assignment
Parameter Type Description assignmentobject The updated assignment ↳ id string The assignment ID ↳ audienceId string The audience ID ↳ primaryContentId string The content ID for the primary content ↳ alternativeContentIds array Content IDs that can also complete the assignment ↳ hideAlternativeContent boolean Whether to hide the alternative content ↳ completionPeriod number Number of days required to complete the assignment ↳ recurrence number Number of days until the assignment reoccurs ↳ isActive boolean Whether the assignment is active ↳ isDeleted boolean Whether the assignment is deleted ↳ createdAt string Creation timestamp (ISO 8601) ↳ deletedAt string Deletion timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601)
Delete a compliance assignment in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host assignmentIdstring Yes The assignment ID audienceIdstring Yes The audience ID
Parameter Type Description successboolean Whether the assignment was deleted
List enrolments for a compliance assignment in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host assignmentIdstring Yes The assignment ID updatedAtFromstring No Start date to filter enrolments from (ISO 8601) updatedAtTostring No Date to filter enrolments up to (ISO 8601). Requires updatedAtFrom. statusstring No Filter by enrolment status: archived, complete, open, overdue, scheduled, or unassigned pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-100, default 100)
Parameter Type Description enrolmentsarray The matching enrolments ↳ id string The enrolment ID ↳ userId string The assignee user ID ↳ assignmentId string The assignment ID ↳ audienceId string The audience ID ↳ primaryContentId string The assigned content ID ↳ status string Enrolment status ↳ availableDate string Date a scheduled enrolment becomes open ↳ dueDate string Date after which a scheduled enrolment is overdue ↳ lastCompletedAt string Date a scheduled enrolment was last completed ↳ history array Event-log history entries ↳ type string The type of the logged event ↳ completionId string The completion ID ↳ previousStatus string The previous enrolment status ↳ nextStatus string The next enrolment status ↳ createdAt string Date the event was logged ↳ updatedAt string Date the event was last modified ↳ updatedAt string Date the enrolment was last updated
Get a single enrolment for a compliance assignment in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host assignmentIdstring Yes The assignment ID enrolmentIdstring Yes The enrolment ID
Parameter Type Description enrolmentobject The enrolment ↳ id string The enrolment ID ↳ userId string The assignee user ID ↳ assignmentId string The assignment ID ↳ audienceId string The audience ID ↳ primaryContentId string The assigned content ID ↳ status string Enrolment status ↳ availableDate string Date a scheduled enrolment becomes open ↳ dueDate string Date after which a scheduled enrolment is overdue ↳ lastCompletedAt string Date a scheduled enrolment was last completed ↳ history array Event-log history entries ↳ type string The type of the logged event ↳ completionId string The completion ID ↳ previousStatus string The previous enrolment status ↳ nextStatus string The next enrolment status ↳ createdAt string Date the event was logged ↳ updatedAt string Date the event was last modified ↳ updatedAt string Date the enrolment was last updated
List learning completion records in Thrive, optionally filtered by user or content.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host contentIdstring No Filter by content isRPLboolean No Filter by completions imported via Recognition of Prior Learning (RPL) userIdstring No Filter by user completedDateRangeStartstring No Filter by completedDate (completedDate >= this date/date-time) completedDateRangeEndstring No Filter by completedDate (completedDate <= this date/date-time) pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 1000)
Parameter Type Description completionsarray The matching completion records ↳ id string The completion ID ↳ userId string The user ID ↳ contentId string The content ID for the content completed ↳ contentVersion number The version of the content ↳ skills array The skills acquired by completing this content ↳ completionType string The type of completion record ↳ hadDueDate boolean Whether the completion had a due date ↳ isRPL boolean Whether the completion was imported via RPL ↳ completedAt string Timestamp when the completion occurred (ISO 8601) ↳ activeUntil string Timestamp the completion is valid until (ISO 8601)
Get a single learning completion record in Thrive by its ID.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host idstring Yes The completion ID
Parameter Type Description completionobject The completion record ↳ id string The completion ID ↳ userId string The user ID ↳ contentId string The content ID for the content completed ↳ contentVersion number The version of the content ↳ skills array The skills acquired by completing this content ↳ completionType string The type of completion record ↳ hadDueDate boolean Whether the completion had a due date ↳ isRPL boolean Whether the completion was imported via RPL ↳ completedAt string Timestamp when the completion occurred (ISO 8601) ↳ activeUntil string Timestamp the completion is valid until (ISO 8601)
Record a learning completion in Thrive for a user and content item.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host userIdstring Yes The user ID contentIdstring Yes The content ID for the content completed completedAtstring Yes ISO8601 timestamp when the completion occurred
Parameter Type Description statementIdstring The completion statement ID
Get a single content record in Thrive by its ID.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host idstring Yes Unique identifier of the content item
Parameter Type Description contentobject The content record ↳ id string Unique identifier for the content ↳ title string Title of the content ↳ description string Detailed description (may contain HTML) ↳ tags array Tags associated with this content ↳ type string The kind of artifact associated with this content ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) ↳ author string User ID who authored the content ↳ isOfficial boolean Whether the content is recognised as official ↳ duration object Expected time to complete the content ↳ value number Duration value ↳ unit string The unit of the duration (always 'minutes') ↳ contentHistory array Chronological history of actions on this content ↳ action string Type of change or event recorded ↳ timestamp string When the action occurred (ISO 8601) ↳ performedBy object The actor that performed the action ↳ type string Kind of actor (e.g. user or system) ↳ value string Identifier or value of the actor
Query content records in Thrive with pagination and filtering options.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 20) typesstring No Comma-separated content types (article, assessment, broadcast, cmi5, elearning, event, file, pathway, question, quiz, scorm, url, video, mixed). If both set, omitTypes is ignored. omitTypesstring No Comma-separated content types (article, assessment, broadcast, cmi5, elearning, event, file, pathway, question, quiz, scorm, url, video, mixed). If both set, omitTypes is ignored. updatedSincestring No Return only items updated on or after this date/time (ISO 8601)
Parameter Type Description resultsarray The matching content records ↳ id string Unique identifier for the content ↳ title string Title of the content ↳ description string Detailed description (may contain HTML) ↳ tags array Tags associated with this content ↳ type string The kind of artifact associated with this content ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) ↳ author string User ID who authored the content ↳ isOfficial boolean Whether the content is recognised as official ↳ duration object Expected time to complete the content ↳ value number Duration value ↳ unit string The unit of the duration (always 'minutes') ↳ contentHistory array Chronological history of actions on this content ↳ action string Type of change or event recorded ↳ timestamp string When the action occurred (ISO 8601) ↳ performedBy object The actor that performed the action ↳ type string Kind of actor (e.g. user or system) ↳ value string Identifier or value of the actor paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Get a single activity record in Thrive by its ID.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host idstring Yes Unique identifier of the activity
Parameter Type Description activityobject The activity record ↳ type string The activity action type ↳ name string The name of the activity ↳ id string Unique ID for this activity record ↳ user string User ID who triggered the activity ↳ date string Timestamp when the activity occurred (ISO 8601) ↳ contextId string Identifier for the context item ↳ contextType string What this activity was in relation to ↳ data json Unstructured activity data; shape varies by type ↳ with json Additional context information
Query activity records in Thrive with pagination and filtering options.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 20) actionsstring No comma-separated activity types e.g. viewed,completed omitActionsstring No comma-separated activity types e.g. viewed,completed contentIdsstring No comma-separated content IDs contentTypestring No Filter by content type timestampFromstring No format YYYY-MM-DD hh:mm:ss timestampTostring No format YYYY-MM-DD hh:mm:ss
Parameter Type Description resultsarray The matching activity records ↳ type string The activity action type ↳ name string The name of the activity ↳ id string Unique ID for this activity record ↳ user string User ID who triggered the activity ↳ date string Timestamp when the activity occurred (ISO 8601) ↳ contextId string Identifier for the context item ↳ contextType string What this activity was in relation to ↳ data json Unstructured activity data; shape varies by type ↳ with json Additional context information paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Get a single CPD category in Thrive by its ID.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host categoryIdstring Yes The CPD category ID
Parameter Type Description categoryobject The CPD category ↳ categoryId string Unique ID for this category record ↳ name string Name of the category of CPD activity
Query CPD categories in Thrive and return results with pagination.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 100) updatedSincestring No Return only items updated on or after this date/time (ISO 8601)
Parameter Type Description resultsarray The matching CPD categories ↳ categoryId string Unique ID for this category record ↳ name string Name of the category of CPD activity paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Get a single CPD log entry in Thrive by its ID.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host logEntryIdstring Yes The CPD log entry ID
Parameter Type Description entryobject The CPD entry ↳ logEntryId string Unique ID for this activity record ↳ userId string User ID who triggered this activity record ↳ activity object The content item associated with the CPD log entry ↳ type string The type of content (e.g. file, article, video) ↳ name string The name of the content item ↳ category object The CPD category ↳ categoryId string Unique ID for this category record ↳ name string Name of the category of CPD activity ↳ entryDate string The date and time the CPD entry was logged (ISO 8601) ↳ durationMinutes number Minutes logged as CPD from this activity ↳ description string Summary or reflective statement ↳ isVerified boolean Whether the activity was generated from verified system activity
Query CPD log entries in Thrive and return results with pagination.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 100) entryDateFromstring No Filter entries after this date (format YYYY-MM-DD hh:mm:ss) entryDateTostring No Filter entries before this date (format YYYY-MM-DD hh:mm:ss)
Parameter Type Description resultsarray The matching CPD entries ↳ logEntryId string Unique ID for this activity record ↳ userId string User ID who triggered this activity record ↳ activity object The content item associated with the CPD log entry ↳ type string The type of content (e.g. file, article, video) ↳ name string The name of the content item ↳ category object The CPD category ↳ categoryId string Unique ID for this category record ↳ name string Name of the category of CPD activity ↳ entryDate string The date and time the CPD entry was logged (ISO 8601) ↳ durationMinutes number Minutes logged as CPD from this activity ↳ description string Summary or reflective statement ↳ isVerified boolean Whether the activity was generated from verified system activity paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Get a single CPD requirement summary in Thrive by its ID.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host audienceRequirementIdstring Yes The CPD requirement ID
Parameter Type Description requirementobject The CPD requirement ↳ audienceRequirementId string Unique ID for this requirement record ↳ audienceId string ID of the audience this requirement applies to ↳ requiredMinutes number Number of minutes required for CPD completion ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601)
Query CPD requirement summaries in Thrive and return results with pagination.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 100) updatedSincestring No Return only items updated on or after this date/time (ISO 8601)
Parameter Type Description resultsarray The matching CPD requirements ↳ audienceRequirementId string Unique ID for this requirement record ↳ audienceId string ID of the audience this requirement applies to ↳ requiredMinutes number Number of minutes required for CPD completion ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last-update timestamp (ISO 8601) paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Query CPD user log summaries in Thrive and return results with pagination.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host entryDateFromstring Yes Filter entries after this date (format YYYY-MM-DDThh:mm:ss) entryDateTostring Yes Filter entries before this date (format YYYY-MM-DDThh:mm:ss) userIdsstring No Comma-separated user IDs to filter by pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 100)
Parameter Type Description resultsarray The matching CPD user summaries ↳ userId string ID of the user this summary is for ↳ durationMinutes number Total CPD minutes logged by the user in the period paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
List tags in Thrive and return tag information with pagination.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host pagenumber No Page number for pagination (default 1) perPagenumber No Number of results per page (1-1000, default 100) updatedSincestring No Return only tags updated on or after this date/time (ISO 8601)
Parameter Type Description resultsarray The tags ↳ tag string The name of the tag ↳ id string The ID of the tag ↳ contents array IDs of contents using this tag ↳ campaigns array IDs of campaigns using this tag ↳ interests array IDs of users interested in this tag ↳ skills array IDs of users skilled in this tag paginationobject Pagination details ↳ totalResults number Total number of results matching the query ↳ totalPages number Total number of pages available ↳ page number Current page number ↳ perPage number Number of results per page
Get a single tag in Thrive by its ID.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host tagIdstring Yes The tag ID
Parameter Type Description tagobject The tag ↳ tag string The name of the tag ↳ id string The ID of the tag ↳ contents array IDs of contents using this tag ↳ campaigns array IDs of campaigns using this tag ↳ interests array IDs of users interested in this tag ↳ skills array IDs of users skilled in this tag
Add one or more tags to a learner in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host userIdstring Yes The learner ID tagsstring Yes JSON array of tag names to add (1-100). Example: ["leadership"]
Parameter Type Description statusnumber The HTTP status code of the operation messagestring A human-readable result message
Remove one or more tags from a learner in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host userIdstring Yes The learner ID tagsstring Yes JSON array of tag names to remove (1-100). Example: ["leadership"]
Parameter Type Description statusnumber The HTTP status code of the operation messagestring A human-readable result message
Update skills and levels for a learner in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host userIdstring Yes The learner ID skillsstring Yes JSON array of skill objects (1-100). Each: {"tagName":"leadership","level":1,"targetLevel":3}. level/targetLevel optional (min -1).
Parameter Type Description statusnumber The HTTP status code of the operation messagestring A human-readable result message
Get the available skill levels configured in Thrive.
Inputs and outputsParameter Type Required Description tenantIdstring Yes Thrive Tenant ID (used as the Basic auth username) apiKeystring Yes Thrive API key (used as the Basic auth password) hoststring No Region-specific API host
Parameter Type Description levelsarray The available skill levels ↳ name string The name of the skill level ↳ isEnabled boolean Whether the skill level is enabled ↳ value number The numeric value of the skill level