Lesson Topics

Returns a paginated list of topics belonging to the specified lesson

Returns a paginated list of topics belonging to the specified lesson.

GEThttps://example.thoughtindustries.com/incoming/v2/topics/lesson/:lessonId

Example request

curl "https://example.thoughtindustries.com/incoming/v2/topics/lesson/:lessonId" \
  -H 'Authorization: Bearer YOUR_API_KEY'

Parameters

Name	Type	Required	Location	Description
`lessonId`	`uuid`	Yes	path	The lessonId identifier.
`page`	`integer`	No	query	Page number to retrieve in the paginated result set.
`perPage`	`integer`	No	query	Number of topics to return per page.

Example response

{
  "data": {
    "APILessonTopics": {
      "pageInfo": {
        "perPage": 0,
        "currentPage": 0,
        "total": 0,
        "hasMore": true
      },
      "topics": [
        {
          "id": "00000000-0000-0000-0000-000000000000",
          "originalId": "00000000-0000-0000-0000-000000000000",
          "title": "string",
          "type": "ad",
          "quizQuestions": [
            "00000000-0000-0000-0000-000000000000"
          ],
          "preTextBlock": "string",
          "postTextBlock": "string",
          "updatedAt": "2024-01-01T00:00:00.000Z",
          "resultsMessage": "string",
          "passMessage": "string",
          "failMessage": "string",
          "navigationDisabled": true,
          "instructorAssessment": true,
          "questionSkipEnabled": true,
          "isProctored": true,
          "allowToResume": true,
          "assetType": "string"
        }
      ]
    }
  }
}

Response fields

Field	Type	Description
`pageInfo`	`PageInfo`	Pagination metadata for the topics result set.
`pageInfo.perPage`	`integer`	Number of topics returned per page.
`pageInfo.currentPage`	`integer`	The current page number in the paginated result set.
`pageInfo.total`	`integer`	Total number of topics across all pages.
`pageInfo.hasMore`	`boolean`	Indicates whether additional pages of results are available.
`topics`	`Topic[]`	Array of topic objects belonging to the lesson.
`topics.id`	`uuid`	Unique identifier for the topic.
`topics.originalId`	`uuid`	Identifier referencing the topic's original source, used when the topic was copied or cloned.
`topics.title`	`string`	Display title of the topic.
`topics.type`	`TopicType`	Content type of the topic (e.g., `ad`, quiz, video).
`topics.quizQuestions`	`uuid[]`	List of UUIDs referencing the quiz questions associated with the topic.
`topics.preTextBlock`	`string`	HTML or plain-text content displayed before the topic's main content.
`topics.postTextBlock`	`string`	HTML or plain-text content displayed after the topic's main content.
`topics.updatedAt`	`ISO 8601 timestamp`	Date and time the topic was last updated, in ISO 8601 format.
`topics.resultsMessage`	`string`	Message displayed to the learner after completing a quiz or assessment.
`topics.passMessage`	`string`	Message displayed to the learner when they pass a quiz or assessment.
`topics.failMessage`	`string`	Message displayed to the learner when they fail a quiz or assessment.
`topics.navigationDisabled`	`boolean`	Indicates whether learners are prevented from navigating away from the topic before completing it.
`topics.instructorAssessment`	`boolean`	Indicates whether the topic requires manual grading by an instructor.
`topics.questionSkipEnabled`	`boolean`	Indicates whether learners are allowed to skip questions within the topic.
`topics.isProctored`	`boolean`	Indicates whether the topic is delivered under proctored conditions.
`topics.allowToResume`	`boolean`	Indicates whether learners can resume the topic after leaving it mid-progress.
`topics.assetType`	`string`	The media or asset type associated with the topic's content (e.g., video, SCORM).