# Thrive Learning

> Manage learners, audiences, learning content, completions and events in Thrive Learning.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/thrive-learning

## Actions

### Add audience members

Add users to an audience's members list.

**Inputs**

- Audience (`audience_id`, text, required): Filter by audienceId or audience reference.
- Values (`values`, list, required): Values to send, using the fields documented by the app.

**Outputs**: Value.

- `data` (object): A success response for adding members/managers.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "success": {
      "count": 1,
      "entities": []
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Archive content

Archive a content record.

**Inputs**

- Id (`id`, text, required): Unique identifier of the content item
- Author ref (`author_ref`, text, required): Your organisation's reference for the acting user. The status change is recorded against this user, and on a restore that user also becomes the recorded publisher. A suspended or deleted user is rejected.

**Outputs**: Value.

- `data` (object): The content after a lifecycle transition, in the same shape as `GET /contents/{id}`. Answered by publish, archive and restore, so that a caller reads one shape from all three. Unlike the create and the update, a transition adds no upload URLs. In the rare case that the transition was made but the record could not be read back, the response is the minimal form: `id` and `status` only. The transition holds in both cases , do not retry the request; a retry answers 409. A full body also satisfies the minimal shape, so this is `anyOf`.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Create audience

Add a new audience.

**Inputs**

- Name (`name`, text): The name of the audience.
- Reference (`reference`, text): The external reference for the Audience.
- Parent ID (`parent_id`, text): The id or reference of the parent audience/ structure, this will be blank if it is a parent audience/ structure.
- Category (`category`, text): Category of Audience: * structure - Structure, a top-level/parent audience. Created without a parentId. Represents an organizational unit. * audience - Audience, a child audience that exists within a structure. Created with a parentId. The workflow for creating audiences requires first creating a structure (category=structure, no parentId), then creating child audiences within that structure (category=audience, with parentId). A structure may contain multiple child audiences, but each audience can only belong to one structure. When a structure is deleted, all its child audiences are also deleted. See the [Audience Workflow Documentation](https://docs.thrivelearning.com/apidocs/understanding-the-audiences-api-workflows#audience-hierarchy-management) for hierarchy examples. One of: `audience`, `structure`.

**Outputs**: Value.

- `data` (object): A audience object.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "apiControlled": true,
    "category": "audience",
    "createdAt": "2026-10-01T12:00:00Z",
    "id": "63f8c5361b9c80d3274be7ca",
    "name": "Tech Team",
    "parent": {
      "id": "673db100e5c0503ac23b0e2b",
      "name": "Tech Team",
      "reference": "audience123"
    },
    "reference": "audience123",
    "type": "manual",
    "updatedAt": "2026-10-01T12:00:00Z"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create completion

Create a completion record.

**Inputs**

- Record user ID (`record_user_id`, text, required): The user ID
- Content (`content_id`, text, required): The content ID for the content completed
- Completed at (`completed_at`, date and time, required): An ISO8601 for the timestamp when the completion occurred
- Current completion (`current_completion`, true/false): Whether this is a live, on-system completion. Defaults to false, which treats the record as a historic completion (imported Recognition of Prior Learning) so it does not reset assignment due dates. Set to true to record a live completion that updates due dates as the most recent completion.

**Outputs**: Value.

- `data` (object): The identifier of the completion statement that was recorded. This is not a completion ID. Statement IDs and completion IDs are separate identifier spaces, so a statement ID cannot be passed to `GET /learning/completions/{id}`, which expects a completion ID and will return `422` for a statement ID. To retrieve the completion itself, query `GET /learning/completions` filtered by `userId` and `contentId`.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "statementId": "7e34859f-6364-5315-82d9-1b16dfadee01"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create content

Create a content record.

**Inputs**

- Title (`title`, text, required): Title for this request.
- Language code (`language_code`, text, required): The content language. The value is case-insensitive and is normalised to a code on the Thrive supported-languages list before the content is created: en, en-GB and en_gb are all stored as en-gb, and fr-FR is stored as fr. A regional variant without its own entry is mapped to the nearest supported code, which is not always the bare language code: es-AR is stored as es-mx and en-IE as en-gb. Norwegian is the one code stored with an upper-case region: no, nb and nn are stored as no-NO. A code that cannot be resolved is rejected with a 422.
- Author ref (`author_ref`, text, required): Your organisation's reference for the acting user. The user becomes the recorded actor, and the author unless a collaboration owns the content. The user must be active. A new, suspended, expired or deleted user is rejected.
- Collaboration ID (`collaboration_id`, text): The collaboration that owns the content. The authorRef user must be a member of it, or the request is rejected with 422.
- Publish when ready (`publish_when_ready`, true/false): Publish automatically when the content becomes ready: every item has completed processing and the content has a thumbnail. Send thumbnail to get a thumbnail upload URL in the same response; without a thumbnail the content stays created. The flag is stored so the publish happens as soon as the record is ready.
- Skills (`skills`, list): Skills to associate with the content. Each name must be an existing skill in your organisation, or the request is rejected with 422. Only accepted together with publishWhenReady: true. Stored in the content tags alongside the topics.
- Topics (`topics`, list): Topics to associate with the content. Free names; a topic is not checked against your organisation's tags. Only accepted together with publishWhenReady: true. Stored in the content tags alongside the skills. A name cannot appear in both lists.
- Primary category (`primary_category`, text): The content type category a caller can set on mixed content, as the platform shows it on content cards and filters search on it. standard is displayed as "Mixed". A token outside this list is rejected with 422; event, pathway and question exist on the platform for legacy search filtering only and cannot be set here. The value is case insensitive and is stored in lower case. Omitted on create, a default is inferred: elearning when the content holds an e-learning item, otherwise standard. Omitted on update, the stored category is unchanged: an update never re-infers elearning, so content that gains its first e-learning item after create keeps standard until an update sets the category. The category cannot be cleared: null is rejected with 422. Set it on create or with PATCH /contents/{id}; the publish endpoint does not take it. One of: `file`, `article`, `elearning`, `url`, `quiz`, `assessment`, `video`, `standard`.
- Completion type (`completion_type`, text): How the content is completed. Defaults to auto. auto, confirm and external apply to any content; on_elearning_completion requires an e-learning item. on_clicking_links requires at least one URL item with a non-empty location that is not a YouTube video, otherwise returns 409. The quiz, assessment and interactive types require item types this API cannot create yet, so they are rejected with a 409. One of: `auto`, `confirm`, `external`, `on_passing_quizzes`, `on_passing_observer_completed_quizzes`, `on_passing_assessments`, `on_elearning_completion`, `on_completing_interactive`, `on_clicking_links`.
- Custom duration in ms (`custom_duration_in_ms`, number): A custom duration in milliseconds. At least 1.
- Is official (`is_official`, true/false): Create the content as endorsed by your organisation. Defaults to false.
- Cpd category ID (`cpd_category_id`, text): The CPD category to record this content against. Only accepted together with isOfficial: true (400 otherwise). The category must exist in your organisation (422 otherwise).
- Thumbnail (`thumbnail`, object): Asks for a thumbnail upload URL. The content thumbnail is uploaded like an item file: give the upload a UUID here and PUT the image bytes (JPEG, PNG, GIF or WebP) to the signedPutUrls entry that echoes it. The uploadId is not stored; it only pairs this request with its response entry, so it must differ from every item uploadId in the same request (400 otherwise). A content has one thumbnail, and a later upload replaces it. Processing is asynchronous: the thumbnail counts for readiness once the image has been resized and stored.
- Items (`items`, list): The content items. At most one upload item (elearning, video or image) plus one non-upload item (rich_text or url) per request. Each rank must be unique.

**Outputs**: Value.

- `data` (object): The created content with its presigned upload URLs. In the rare case that the content was created but could not be read back, the response is the minimal form: `id`, `status` and `signedPutUrls` only. The content exists in both cases , do not retry the request. A full body also satisfies the minimal shape, so this is `anyOf`.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Create user

Create a user.

**Inputs**

- Ref (`ref`, text, required): Your organisation's unique identifier for this individual
- First name (`first_name`, text, required): The given name of the individual
- Last name (`last_name`, text, required): The family name of the individual
- Email (`email`, text): The email address for the user. Required unless loginMethod is 'ref'.
- Login method (`login_method`, text): How the user logs in. Defaults to 'email'. One of: `email`, `ref`.
- Role (`role`, text): The role assigned to this individual. Defaults to 'learner' if omitted. One of: `administrator`, `learneradmin`, `learner`.
- Job title (`job_title`, text): The name of this individual's role in your organisation
- Manager ref (`manager_ref`, text): Your organisation's unique identifier for this individual's line manager
- Start date (`start_date`, date and time): The date this individual started working with your organisation
- End date (`end_date`, date and time): The date this individual left your organisation
- Time zone (`time_zone`, text): The user's preferred timezone. If not provided the tenant default is used.
- Language code (`language_code`, text): The user’s preferred language. If not provided the tenant default is used. One caveat is that the tenant may only use the languages they have requested. One of: `cs`, `de`, `en-gb`, `en-us`, `es`, `es-mx`, `fi`, `fr`, `hu`, `id`, and 13 more.
- Sso (`sso`, true/false): Whether this account is managed by an Authentication provider or not.
- Domain (`domain`, text): The domain this individual is associated with
- Additional fields (`additional_fields`, object): Custom field key-value pairs matching your configured custom fields.

**Outputs**: Value.

- `data` (object): A user lifecycle resource returned by the v2 user lifecycle endpoints
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "active": true,
    "additionalFields": {},
    "createdAt": "2021-08-18T13:48:00+00:00",
    "domain": "tenant.learn.link",
    "email": "user@thrivelearning.com",
    "endDate": "2021-06-11T16:00:00Z",
    "firstName": "Thomas",
    "id": "6143eedfd39243e830bdbb8c",
    "jobTitle": "Director",
    "languageCode": "en-gb",
    "lastName": "Jefferson",
    "loginMethod": "email",
    "managerRef": "UID0034234555",
    "ref": "UID30084022",
    "role": "learner",
    "sso": true,
    "startDate": "2021-01-01T09:00:00+00:00",
    "timeZone": "Europe/London",
    "updatedAt": "2021-08-19T18:00:00Z"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Delete audience

Delete an audience.

**Inputs**

- Audience (`audience_id`, text, required): Filter by audienceId or audience reference.

**Outputs**: Value.

- `data` (null): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": null
}
```

### Delete user

Delete a user.

**Inputs**

- Ref (`ref`, text, required): The user ref

**Outputs**: Value.

- `data` (object): Response returned when a user is successfully deleted
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "success": true
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get audience

Get an audience.

**Inputs**

- Audience (`audience_id`, text, required): Filter by audienceId or audience reference.

**Outputs**: Value.

- `data` (object): A audience object.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "apiControlled": true,
    "category": "audience",
    "createdAt": "2026-10-01T12:00:00Z",
    "id": "63f8c5361b9c80d3274be7ca",
    "name": "Tech Team",
    "parent": {
      "id": "673db100e5c0503ac23b0e2b",
      "name": "Tech Team",
      "reference": "audience123"
    },
    "reference": "audience123",
    "type": "manual",
    "updatedAt": "2026-10-01T12:00:00Z"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get content

Get a single content record.

**Inputs**

- Id (`id`, text, required): Unique identifier of the content item

**Outputs**: Value.

- `data` (object): The record `GET /contents/{id}` returns: the content, plus its `thumbnail` when the record is served from content-core. The v2 create, update and publish responses and the `GET /contents` list never carry `thumbnail`; read the record by its id to get it.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "author": "5c8936159ec2d00010cdd334",
    "contentHistory": [],
    "cpdCategoryId": "507f1f77bcf86cd799439012",
    "createdAt": "2019-03-13T16:15:24Z",
    "description": "This content looked really interesting and relevant to recent conversations in the development team",
    "duration": {
      "unit": "minutes",
      "value": 15
    },
    "id": "5c8936159ec2d00010cdd334",
    "isOfficial": true,
    "items": [],
    "lastUpdatedBy": {
      "email": "example",
      "id": "example",
      "reference": "example"
    },
    "primaryCategory": "elearning",
    "provider": {
      "id": "thrive",
      "name": "Thrive"
    },
    "skills": [],
    "status": "published",
    "tags": [],
    "thumbnail": {
      "updatedAt": "2026-10-02T09:00:00Z",
      "url": "https://cdn.example.com/processed/content-core/5f9d88d6e1b2a34c56d78901/thumbnail/507f1f77bcf86cd799439011.jpeg?2026-10-02T09:00:00.000Z"
    },
    "title": "An amazing video",
    "topics": [],
    "type": "video",
    "updatedAt": "2019-03-13T16:15:24Z"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get event

Get a single event.

**Inputs**

- Id (`id`, text, required): The event id

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "attendeeCount": 34,
    "canReshare": true,
    "cancellationPeriod": 2,
    "createdAt": "2024-01-10T09:00:00Z",
    "eventLog": [],
    "id": "64a1f2b3c4d5e6f7a8b9c0d1",
    "isAllowedToComment": true,
    "isCancellationRestricted": true,
    "lastUpdatedBy": {
      "email": "author@example.com",
      "id": "64a1f2b3c4d5e6f7a8b9c0d2",
      "reference": "EMP123"
    },
    "managerTeamEnrolmentEnabled": true,
    "occurrenceCount": 2,
    "occurrences": [],
    "selfRegistrationEnabled": true,
    "status": "published",
    "title": "Leadership Workshop Q1",
    "truncated": {
      "attendees": false,
      "occurrences": false
    },
    "type": "event",
    "updatedAt": "2024-06-15T10:30:00Z",
    "waitlistDisabled": false
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get user

Search user by ID and return basic user information.

**Inputs**

- Id (`id`, text, required): Filter by user
- Expand (`expand`, text): Comma-separated list of extra data to nest into the response. Omit it and the response is unchanged. - permissions - every permission domain currently supported, today audiences and spaces. New domains are added to this token over time. - audiencePermissions - audience management permissions only. - spacePermissions - space permissions only. When any permission domain is expanded the maximum perPage is reduced from 1000 to 100.

**Outputs**: Value.

- `data` (object): A user object
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "additionalFields": {},
    "agreedTerms": true,
    "audiences": [
      "646767d82535201223349e09"
    ],
    "compliance": 0,
    "createdAt": "2021-01-01T09:00:00+00:00",
    "deleted": false,
    "email": "sample@thrivelearning.com",
    "firstLogin": "2021-01-01T09:00:00+00:00",
    "firstName": "John",
    "hasPicture": false,
    "id": "646767d82535201223349e09",
    "languageCode": "en-gb",
    "lastLogin": "2021-01-01T09:00:00+00:00",
    "lastName": "Doe",
    "level": 0,
    "onboarded": true,
    "permissions": {
      "audiences": [],
      "spaces": []
    },
    "positions": [],
    "rank": {
      "currentCategory": "Beginner",
      "currentRank": 1
    },
    "ref": "xyzabc",
    "relevancy": 0,
    "role": "learner",
    "singleSignOn": true,
    "status": "active",
    "summary": "A summary of the user",
    "tags": {
      "skillLevels": [],
      "skills": [
        "communication",
        "leadership"
      ]
    },
    "tagsFollowing": [
      "646767d82535201223349e09"
    ],
    "timeZone": "Europe/London",
    "updatedAt": "2021-01-01T09:00:00+00:00",
    "usersFollowing": [
      "646767d82535201223349e09"
    ]
  },
  "has_more": false,
  "next_cursor": null
}
```

### List audience members

Get an audience members list.

**Inputs**

- Audience (`audience_id`, text, required): Filter by audienceId or audience reference.
- Page (`page`, number): Used in combination with the limit parameter to page through the data.
- Per page (`per_page`, number): Used in combination with the page parameter to page through the data. From 1 to 100.
- Limit (`limit`, number): Used in combination with the page parameter to page through the data. From 1 to 100.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "pagination": {
      "page": 1,
      "pageNumber": 1,
      "perPage": 20,
      "totalPages": 3,
      "totalResults": 48
    },
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List audiences

Get audiences.

**Inputs**

- Api controlled (`api_controlled`, true/false): Filter to only return audiences which are / are not api controlled.
- Updated since (`updated_since`, date and time): Return only items updated on or after this date/time (ISO 8601).
- Page (`page`, number): Used in combination with the limit parameter to page through the data.
- Per page (`per_page`, number): Used in combination with the page parameter to page through the data. From 1 to 100.
- Limit (`limit`, number): Used in combination with the page parameter to page through the data. From 1 to 100.
- Expand (`expand`, text): Comma-separated list of extra data to nest into each audience. Omit it and the response is unchanged. - managers - every user holding a management role on the audience (audience manager, people manager or administrator), with the full permission set for each role they hold. Values are case-insensitive. Any other value is rejected with a 400, matching the expand parameter on the users endpoints; this endpoint's other query parameters fail with a 422.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "pagination": {
      "page": 1,
      "perPage": 20,
      "totalPages": 3,
      "totalResults": 48
    },
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List completions

Get a list of completion records.

**Inputs**

- Content (`content_id`, text): Filter by content
- Is rpl (`is_rpl`, true/false): Filter by completions imported via RPL
- Record user ID (`record_user_id`, text): Filter by user
- Completed date range start (`completed_date_range_start`, text): Filter by completedDate (completedDate >= completedDateRangeStart)
- Completed date range end (`completed_date_range_end`, text): Filter by completedDate (completedDate <= completedDateRangeEnd)
- Page (`page`, number): Set the current page of results. At least 1.
- Per page (`per_page`, number): Used in combination with the page parameter to page through the data, will be prioritised over limit. **Allowed values: 1, 1000**. From 1 to 1000.
- Limit (`limit`, number): Set the number of items to retrieve per page. From 1 to 1000.

**Outputs**: Value.

- `data` (list): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": [],
  "has_more": false,
  "next_cursor": null
}
```

### List content

Query content records.

**Inputs**

- Page (`page`, number): Page number for pagination. At least 1.
- Per page (`per_page`, number): Number of records per page. From 1 to 1000.
- Types (`types`, text): Only return content whose type is in this list (comma-separated, case-insensitive). Allowed values: article, assessment, broadcast, cmi5, elearning, event, file, pathway, question, quiz, scorm, url, video, mixed. If both types and omitTypes are provided, only types is applied; omitTypes is ignored.
- Omit types (`omit_types`, text): Exclude content whose type is in this list (comma-separated, case-insensitive). Allowed values: article, assessment, broadcast, cmi5, elearning, event, file, pathway, question, quiz, scorm, url, video, mixed. Ignored when types is also provided.
- Statuses (`statuses`, text): Only return content whose state is in this list (comma-separated, case-insensitive). Allowed values: created, published, archived, deleted. When used with omitStatuses, results must match an included status and must not match any omitted status. Note: deleted filters on the deletion flag, not on the response status field. A deleted record reports its pre-deletion status (created, published or archived), so the returned status values do not match this filter value.
- Omit statuses (`omit_statuses`, text): Exclude content whose state is in this list (comma-separated, case-insensitive). Allowed values: created, published, archived, deleted. When statuses is not provided, non-omitted lifecycle states keep the default catalogue behaviour (non-archived and non-deleted), unless archived or deleted is listed here. Note: deleted filters on the deletion flag, not on the response status field. A deleted record reports its pre-deletion status (created, published or archived).
- Updated since (`updated_since`, date and time): Return only items updated on or after this date/time (ISO 8601).

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "pagination": {
      "page": 1,
      "perPage": 20,
      "totalPages": 3,
      "totalResults": 48
    },
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List events

List events.

**Inputs**

- Page (`page`, number): Page number for pagination. At least 1.
- Per page (`per_page`, number): Number of records per page. From 1 to 100.
- Status (`status`, text): Comma-separated list of lifecycle states to include. When omitted, archived events are excluded. One of: `created`, `published`, `archived`.
- Updated since (`updated_since`, date and time): Returns only events whose **metadata** changed after this timestamp (title, description, status, occurrence and session edits). Attendee activity does not update this timestamp: registrations, cancellations and attendance marking do not make an event appear in an updatedSince result. To track attendance state, read attendeeCount on the list or use GET /events/user/ref/{ref} per user.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "pagination": {
      "page": 1,
      "perPage": 20,
      "totalPages": 3,
      "totalResults": 48
    },
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List users

Search users and return basic user information.

**Inputs**

- Page (`page`, number): Used in combination with the limit parameter to page through the data.
- Per page (`per_page`, number): Used in combination with the page parameter to page through the data. From 1 to 1000.
- Updated since (`updated_since`, date and time): Return only items updated on or after this date/time (ISO 8601).
- Expand (`expand`, text): Comma-separated list of extra data to nest into the response. Omit it and the response is unchanged. - permissions - every permission domain currently supported, today audiences and spaces. New domains are added to this token over time. - audiencePermissions - audience management permissions only. - spacePermissions - space permissions only. When any permission domain is expanded the maximum perPage is reduced from 1000 to 100.
- Statuses (`statuses`, text): Only return users whose status is in this list. Comma-separated string. Allowed values (any combination): active, inactive, expired, new.
- Omit statuses (`omit_statuses`, text): Exclude users whose status is in this list. Comma-separated string. Allowed values (any combination): active, inactive, expired, new.
- Roles (`roles`, text): Only return users whose role is in this list. Comma-separated string. Allowed values (any combination): administrator, learneradmin, learner.
- Omit roles (`omit_roles`, text): Exclude users whose role is in this list. Comma-separated string. Allowed values (any combination): administrator, learneradmin, learner.
- Status (`status`, text): Filter by a single user status. One value only (not comma-separated). Allowed values: active, inactive, expired, new. One of: `active`, `inactive`, `expired`, `new`.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "pagination": {
      "page": 1,
      "pageNumber": 1,
      "perPage": 20,
      "totalPages": 3,
      "totalResults": 48
    },
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List webhook events

Query stored outbound webhook events.

**Inputs**

- Page (`page`, number): Page number for pagination. At least 1.
- Per page (`per_page`, number): Number of records per page. From 1 to 1000.
- Event type (`event_type`, text): Filter by mapped webhook event type (e.g. content.completed, post.posted). See the full list at https://docs.thrivelearning.com/apidocs/webhooks
- Subscription key (`subscription_key`, text): Filter by tenant subscription config key. See the available subscriptions at https://docs.thrivelearning.com/apidocs/webhooks
- Delivery status (`delivery_status`, text): Filter by webhook delivery outcome. One of: `delivered`, `failed`.
- Created from (`created_from`, date and time): Return events ingested at or after this ISO 8601 timestamp. Defaults to 24 hours ago when omitted.
- Created to (`created_to`, date and time): Return events ingested at or before this ISO 8601 timestamp.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "pagination": {
      "page": 1,
      "pageNumber": 1,
      "perPage": 20,
      "totalPages": 3,
      "totalResults": 48
    },
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Publish content

Publish a content record.

**Inputs**

- Id (`id`, text, required): Unique identifier of the content item
- Author ref (`author_ref`, text, required): Your organisation's reference for the acting user. The user is recorded as the publisher. The user must be active. A new, suspended, expired or deleted user is rejected.
- Skills (`skills`, list): The complete list of skills to publish with. Sending this field replaces the skills the content was created with and keeps its topics; omitting it keeps both. Each name must be an existing skill in your organisation, or the request is rejected with 422. An empty list publishes with no skills.
- Topics (`topics`, list): The complete list of topics to publish with. Sending this field replaces the topics the content was created with and keeps its skills; omitting it keeps both. Free names; a topic is not checked against your organisation's tags. An empty list publishes with no topics. A name cannot appear in both lists.
- Published at (`published_at`, date and time): The publish date to record, for content that was originally published elsewhere. ISO-8601, not in the future. Applied by a second write after the publish; see the endpoint description for the failure mode. Defaults to the time of the call.

**Outputs**: Value.

- `data` (object): The publish form of `ContentTransitionResponse`. Both the full and the minimal shape carry `publishedAtApplied` when the request sent `publishedAt`.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "publishedAtApplied": true
  },
  "has_more": false,
  "next_cursor": null
}
```

### Reactivate user

Reactivate a suspended user.

**Inputs**

- Ref (`ref`, text, required): The user ref

**Outputs**: Value.

- `data` (object): A user lifecycle resource returned by the v2 user lifecycle endpoints
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "active": true,
    "additionalFields": {},
    "createdAt": "2021-08-18T13:48:00+00:00",
    "domain": "tenant.learn.link",
    "email": "user@thrivelearning.com",
    "endDate": "2021-06-11T16:00:00Z",
    "firstName": "Thomas",
    "id": "6143eedfd39243e830bdbb8c",
    "jobTitle": "Director",
    "languageCode": "en-gb",
    "lastName": "Jefferson",
    "loginMethod": "email",
    "managerRef": "UID0034234555",
    "ref": "UID30084022",
    "role": "learner",
    "sso": true,
    "startDate": "2021-01-01T09:00:00+00:00",
    "timeZone": "Europe/London",
    "updatedAt": "2021-08-19T18:00:00Z"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Remove audience member

Removes an audience member.

**Inputs**

- Audience (`audience_id`, text, required): Filter by audienceId or audience reference.
- User ref (`user_ref`, text, required): Filter by user

**Outputs**: Value.

- `data` (null): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": null
}
```

### Suspend user

Suspend a user.

**Inputs**

- Ref (`ref`, text, required): The user ref
- End date (`end_date`, date and time): The date this individual left your organisation

**Outputs**: Value.

- `data` (object): A user lifecycle resource returned by the v2 user lifecycle endpoints
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "active": true,
    "additionalFields": {},
    "createdAt": "2021-08-18T13:48:00+00:00",
    "domain": "tenant.learn.link",
    "email": "user@thrivelearning.com",
    "endDate": "2021-06-11T16:00:00Z",
    "firstName": "Thomas",
    "id": "6143eedfd39243e830bdbb8c",
    "jobTitle": "Director",
    "languageCode": "en-gb",
    "lastName": "Jefferson",
    "loginMethod": "email",
    "managerRef": "UID0034234555",
    "ref": "UID30084022",
    "role": "learner",
    "sso": true,
    "startDate": "2021-01-01T09:00:00+00:00",
    "timeZone": "Europe/London",
    "updatedAt": "2021-08-19T18:00:00Z"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Update content

Update a content record.

**Inputs**

- Id (`id`, text, required): Unique identifier of the content item
- Title (`title`, text): Title for this request.
- Author ref (`author_ref`, text, required): Your organisation's reference for the acting user. The update is recorded against this user. A suspended or deleted user is rejected.
- Can comment (`can_comment`, true/false): Whether learners may comment on this content.
- Is official (`is_official`, true/false): Whether the content is endorsed by your organisation. false leaves a stored CPD category as it is; send cpdCategoryId: null to clear it.
- Cpd category ID (`cpd_category_id`, text): The CPD category to record this content against. null clears it. An id is only accepted when the content is endorsed after the update (400 otherwise), and it must exist in your organisation (422 otherwise).
- Primary category (`primary_category`, text): The content type category a caller can set on mixed content, as the platform shows it on content cards and filters search on it. standard is displayed as "Mixed". A token outside this list is rejected with 422; event, pathway and question exist on the platform for legacy search filtering only and cannot be set here. The value is case insensitive and is stored in lower case. Omitted on create, a default is inferred: elearning when the content holds an e-learning item, otherwise standard. Omitted on update, the stored category is unchanged: an update never re-infers elearning, so content that gains its first e-learning item after create keeps standard until an update sets the category. The category cannot be cleared: null is rejected with 422. Set it on create or with PATCH /contents/{id}; the publish endpoint does not take it. One of: `file`, `article`, `elearning`, `url`, `quiz`, `assessment`, `video`, `standard`.
- Completion type (`completion_type`, text): How the content is completed. One of: `auto`, `confirm`, `external`, `on_passing_quizzes`, `on_passing_observer_completed_quizzes`, `on_passing_assessments`, `on_elearning_completion`, `on_completing_interactive`, `on_clicking_links`.
- Increment version (`increment_version`, true/false): Bump the content's version number. Valid only on published content (409 otherwise). This is not a snapshot , content keeps no version history, so any item replaced in this request has its previous file deleted permanently.
- Add items (`add_items`, list): Items to append. The per-request cap applies to this array only, not to the resulting document: at most one upload item plus one non-upload item. Each rank must be unique within this array (422 otherwise) and must not collide with the rank of an item already on the content (409 otherwise).
- Update items (`update_items`, list): Existing items to change, identified by their item id. The type must match the stored item , an item cannot change type. Fields the change does not name keep their stored values. A rank that collides with the rank of another item that survives this request answers 409, the same as an added item's rank , ranks are checked as a set once the whole change is applied.
- Remove items (`remove_items`, list): The ids of items to delete. Removing an upload item deletes its stored file permanently. An id that does not match an item on this content is rejected with 422.
- Thumbnail (`thumbnail`, object): Asks for a thumbnail upload URL. The content thumbnail is uploaded like an item file: give the upload a UUID here and PUT the image bytes (JPEG, PNG, GIF or WebP) to the signedPutUrls entry that echoes it. The uploadId is not stored; it only pairs this request with its response entry, so it must differ from every item uploadId in the same request (400 otherwise). A content has one thumbnail, and a later upload replaces it. Processing is asynchronous: the thumbnail counts for readiness once the image has been resized and stored.

**Outputs**: Value.

- `data` (object): The updated content with its presigned upload URLs. In the rare case that the content was updated but could not be read back, the response is the minimal form: `id`, `status` and `signedPutUrls` only. The update was applied in both cases , do not retry the request. A full body also satisfies the minimal shape, so this is `anyOf`.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Update user

Update a user.

**Inputs**

- Ref (`ref`, text, required): The user ref
- First name (`first_name`, text): The given name of the individual
- Last name (`last_name`, text): The family name of the individual
- Email (`email`, text): The email address for the user
- Login method (`login_method`, text): How the user logs in
- Role (`role`, text): The role assigned to this individual. One of: `administrator`, `learneradmin`, `learner`.
- Job title (`job_title`, text): The name of this individual's role in your organisation
- Manager ref (`manager_ref`, text): Your organisation's unique identifier for this individual's line manager
- Start date (`start_date`, date and time): The date this individual started working with your organisation
- End date (`end_date`, date and time): The date this individual left your organisation
- Time zone (`time_zone`, text): The user's preferred timezone
- Language code (`language_code`, text): The user’s preferred language. If not provided the tenant default is used. One caveat is that the tenant may only use the languages they have requested. One of: `cs`, `de`, `en-gb`, `en-us`, `es`, `es-mx`, `fi`, `fr`, `hu`, `id`, and 13 more.
- Sso (`sso`, true/false): Whether this account is managed by an Authentication provider or not.
- Domain (`domain`, text): The domain this individual is associated with
- Additional fields (`additional_fields`, object): Custom field key-value pairs matching your configured custom fields.

**Outputs**: Value.

- `data` (object): A user lifecycle resource returned by the v2 user lifecycle endpoints
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "active": true,
    "additionalFields": {},
    "createdAt": "2021-08-18T13:48:00+00:00",
    "domain": "tenant.learn.link",
    "email": "user@thrivelearning.com",
    "endDate": "2021-06-11T16:00:00Z",
    "firstName": "Thomas",
    "id": "6143eedfd39243e830bdbb8c",
    "jobTitle": "Director",
    "languageCode": "en-gb",
    "lastName": "Jefferson",
    "loginMethod": "email",
    "managerRef": "UID0034234555",
    "ref": "UID30084022",
    "role": "learner",
    "sso": true,
    "startDate": "2021-01-01T09:00:00+00:00",
    "timeZone": "Europe/London",
    "updatedAt": "2021-08-19T18:00:00Z"
  },
  "has_more": false,
  "next_cursor": null
}
```
