Synap API (Beta)
    Synap API (Beta)
    • Getting Started
    • Authentication
    • Error Handling
    • Versioning
    • Security
    • API Reference
      • Access Policies
        • Create AccessMigration
        • Create AccessPolicy
        • List AccessPolicies
        • Get AccessPolicy
        • Update AccessPolicy
        • Delete AccessPolicy
        • Create AccessPolicyReset
        • List AvailableAccessPolicies
      • Assignments
        • Get AssignmentFolder
        • Create AssignmentGroupCourseVersion
        • List AssignmentGroupCourseVersions
        • Create AssignmentGroupDataExport
        • Get AssignmentGroupHeadlineInsight
        • Create AssignmentGroup
        • Get AssignmentGroup
        • Update AssignmentGroup
        • Delete AssignmentGroup
        • Get AssignmentHeadlineInsight
        • Get AssignmentItemAudio
        • Update AssignmentItemAudio
        • Get AssignmentItemDocument
        • Update AssignmentItemDocument
        • Get AssignmentItemEmbed
        • Update AssignmentItemEmbed
        • Get AssignmentItemNote
        • Update AssignmentItemNote
        • Create AssignmentItemPulse
        • Get AssignmentItemQuiz
        • Update AssignmentItemQuiz
        • Get AssignmentItemScorm
        • Update AssignmentItemScorm
        • Get AssignmentItemSurvey
        • Update AssignmentItemSurvey
        • Get AssignmentItemTextEntry
        • Update AssignmentItemTextEntry
        • Get AssignmentItemUpload
        • Update AssignmentItemUpload
        • Get AssignmentItemVideo
        • Update AssignmentItemVideo
        • Get AssignmentItemZip
        • Update AssignmentItemZip
        • Create AssignmentManualReview
        • Create AssignmentReattempt
        • Create AssignmentReset
        • Create AssignmentRevocation
        • Delete AssignmentRevocation
        • Get AssignmentScormResult
        • Get Assignment
        • Update Assignment
        • List Assignments
      • Attempts
        • List AttemptCharts
        • List AttemptInsights
        • Create AttemptLock
        • Delete AttemptLock
        • Get AttemptMarkSession
        • List AttemptMarkSessions
        • Create AttemptMarkerEntry
        • Create AttemptMarksSubmission
        • Create AttemptOverride
        • List AttemptOverrides
        • Get AttemptPlayerState
        • List AttemptResultConfigs
        • List AttemptSchedules
        • Get AttemptSchedule
        • Update AttemptSchedule
        • Create AttemptSitting
        • Create AttemptSubmission
        • List AttemptTagLabels
        • Create AttemptTimerReset
        • List AttemptTimers
        • Get AttemptTimer
        • Update AttemptTimer
        • Create Attempt
        • List Attempts
        • Get Attempt
        • Update Attempt
        • Assign Markers
        • Assign Moderating Markers
        • Unassign Moderating Markers
        • Assign Backreaders
        • Unassign Backreaders
        • Assign Escalating Markers
        • Unassign Escalating Markers
        • Assign Auditing Markers
        • Unassign Auditing Markers
        • Assign Provisional Markers
        • Unassign Provisional Markers
        • Update Attempt Responses
        • List EnrichedAttemptOptions
        • List EnrichedAttempts
        • Create ExamPreview
        • Create ExportEnrichedAttempt
        • Get MarkableResponse
        • Update MarkableResponse
        • List MarkableResponses
        • Get PlayerAttempt
        • Update PlayerAttempt
        • Delete PlayerAttempt
        • Get PlayerAudioResponse
        • Update PlayerAudioResponse
        • Get PlayerClozeDragAndDropResponse
        • Update PlayerClozeDragAndDropResponse
        • Get PlayerClozeDropDownResponse
        • Update PlayerClozeDropDownResponse
        • Get PlayerClozeTextResponse
        • Update PlayerClozeTextResponse
        • Get PlayerEmqGroup
        • Get PlayerFileUploadResponse
        • Update PlayerFileUploadResponse
        • Get PlayerFreeTextResponse
        • Update PlayerFreeTextResponse
        • Get PlayerInformationalResponse
        • Update PlayerInformationalResponse
        • Get PlayerMultipleChoiceResponse
        • Update PlayerMultipleChoiceResponse
        • Get PlayerRankedResponse
        • Update PlayerRankedResponse
        • Get PlayerSection
        • Update PlayerSection
        • Get PlayerShortAnswerResponse
        • Update PlayerShortAnswerResponse
        • Get PlayerSingleChoiceResponse
        • Update PlayerSingleChoiceResponse
        • Get PlayerVideoResponse
        • Update PlayerAudioResponse
        • Get QuestionMarkSession
      • Auditing
        • List ActionLogs
        • Get ActionLog
      • Authentication
        • Create ADFS AuthenticationOption
        • Get ADFS AuthenticationOption
        • Update ADFS AuthenticationOption
        • Delete ADFS AuthenticationOption
        • Create Auth0 AuthenticationOption
        • Get Auth0 AuthenticationOption
        • Update Auth0 AuthenticationOption
        • Delete Auth0 AuthenticationOption
        • Create JWT AuthenticationOption
        • Get JWT AuthenticationOption
        • Update JWT AuthenticationOption
        • Delete JWT AuthenticationOption
        • Get Local AuthenticationOption
        • Update Local AuthenticationOption
        • Create LTI1.3 AuthenticationOption
        • Get LTI1.3 AuthenticationOption
        • Update LTI1.3 AuthenticationOption
        • Delete LTI1.3 AuthenticationOption
        • Create SAML AuthenticationOption
        • Get SAML AuthenticationOption
        • Update SAML AuthenticationOption
        • Delete SAML AuthenticationOption
        • List AuthenticationOptions
        • Create BotSession
        • Activate MFA
        • Get MfaConfig
        • Create MFAConfig
        • Create MfaDeactivation
        • Create PersonalAccessToken
        • List PersonalAccessTokens
        • Update PersonalAccessToken
        • Delete PersonalAccessToken
        • List PublicAuthenticationOptions
        • Get Token
        • Delete own UserSession
        • Create ZapierApiKey
        • List ZapierApiKeys
        • Update ZapierApiKey
        • Delete ZapierApiKey
      • Billing
        • Get Billing Info
        • Create ManageBillingSession
        • Get PortalUsage
        • List Subscriptions
        • Get Subscription
      • Certificates
        • Get Certificate
        • List Certificates
        • Create Certificate
        • List PublicCertificates
        • List Templates
      • Collections
        • Create Annotation
        • List Annotations
        • Get Annotation
        • Update Annotation
        • Delete Annotation
        • Create CollectionAccess
        • Delete CollectionAccess
        • Create CollectionFolder
        • List CollectionFolders
        • Get CollectionFolder
        • Update CollectionFolder
        • Delete CollectionFolder
        • Reorder CollectionFolder Items
        • Create CollectionSubFolder
        • Get CollectionSubFolder
        • Update CollectionSubFolder
        • Delete CollectionSubFolder
        • Reorder CollectionSubFolder Items
        • Create CollectionItemAudio
        • List CollectionItemAudio (Use Generic)
        • Get CollectionItemAudio
        • Update CollectionItemAudio
        • Delete CollectionItemAudio
        • Get CollectionItemDocument
        • Update CollectionItemDocument
        • Delete CollectionItemDocument
        • Create CollectionItemDocument
        • Create CollectionItemEmbed
        • List CollectionItemEmbeds (Use Generic)
        • Get CollectionItemEmbed
        • Update CollectionItemEmbed
        • Delete CollectionItemEmbed
        • Create CollectionItemNote
        • List CollectionItemNotes (Use Generic)
        • Get CollectionItemNote
        • Update CollectionItemNote
        • Delete CollectionItemNote
        • Create CollectionItemQuiz
        • List CollectionItems - use generic CollectionItem
        • Get CollectionItemQuiz
        • Update CollectionItemQuiz
        • Delete CollectionItemQuiz
        • Create CollectionItemVideo
        • List CollectionItems - use generic CollectionItem
        • Get CollectionItemVideo
        • Update CollectionItemVideo
        • Delete CollectionItemVideo
        • Create CollectionItemZip
        • List CollectionItems - use generic CollectionItem
        • Get CollectionItemZip
        • Update CollectionItemZip
        • Delete CollectionItemZip
        • List CollectionItems
        • List CollectionMocks
        • Create CollectionProgress
        • List CollectionProgresses
        • Update CollectionProgress
        • List CollectionSubFolders
        • Get CollectionTagBreakdown
        • List Collections
        • Create Collection
        • Get Collection
        • Update Collection
        • Delete Collection
        • Reorder Collection Folders
        • Reorder Collection Items
        • Create Highlight
        • List Highlights
        • Get Highlight
        • Update Highlight
        • Delete Highlight
      • Content Metadata
        • Create AttributeConfig
        • List AttributeConfigs
        • Get AttributeConfig
        • Update AttributeConfig
        • Delete AttributeConfig
        • Create CloneJob
        • Get CloneJob
        • List FacetConfigs
        • List PublicAttributeConfigs
        • Create TagSet
        • List TagSets
        • Get TagSet
        • Update TagSet
        • Delete TagSet
        • Create Tag
        • List Tags
        • Get Tag
        • Update Tag
        • Delete Tag
      • Courses
        • Create CourseFolder
        • List CourseFolders
        • Get CourseFolder
        • Update CourseFolder
        • Delete CourseFolder
        • Update CourseFolder Items
        • Create CourseItemAudio
        • List CourseItemAudio (Use Generic)
        • Get CourseItemAudio
        • Update CourseItemAudio
        • Delete CourseItemAudio
        • Create CourseItemDocument
        • List CourseItemDocument (Use Generic)
        • Get CourseItemDocument
        • Update CourseItemDocument
        • Delete CourseItemDocument
        • Create CourseItemEmbed
        • List CourseItemEmbed (Use Generic)
        • Get CourseItemEmbed
        • Update CourseItemEmbed
        • Delete CourseItemEmbed
        • Create CourseItemNote
        • List CourseItemNote (Use Generic)
        • Get CourseItemNote
        • Update CourseItemNote
        • Delete CourseItemNote
        • Create CourseItemQuiz
        • List CourseItemQuiz (Use Generic)
        • Get CourseItemQuiz
        • Update CourseItemQuiz
        • Delete CourseItemQuiz
        • Create CourseItemScorm
        • List CourseItemScorm (Use Generic)
        • Get CourseItemScorm
        • Update CourseItemScorm
        • Delete CourseItemScorm
        • Create CourseItemSurvey
        • List CourseItemSurvey (Use Generic)
        • Get CourseItemSurvey
        • Update CourseItemSurvey
        • Delete CourseItemSurvey
        • Create CourseItemTextEntry
        • List CourseItemTextEntry (Use Generic)
        • Get CourseItemTextEntry
        • Update CourseItemTextEntry
        • Delete CourseItemTextEntry
        • Create CourseItemUpload
        • List CourseItemUpload (Use Generic)
        • Get CourseItemUpload
        • Update CourseItemUpload
        • Delete CourseItemUpload
        • Create CourseItemVideo
        • List CourseItemVideo (Use Generic)
        • Get CourseItemVideo
        • Update CourseItemVideo
        • Delete CourseItemVideo
        • Create CourseItemZip
        • List CourseItemZip (Use Generic)
        • Get CourseItemZip
        • Update CourseItemZip
        • Delete CourseItemZip
        • List CourseItems
        • Create Course
        • Get Course
        • Update Course
        • Delete Course
        • Reorder Course Folders
        • Reorder Course Items
      • Exams
        • Create AttemptRevokeReversal
        • List AttemptRevokeReversals
        • Get AttemptRevokeReversal
        • Update AttemptRevokeReversal
        • Delete AttemptRevokeReversal
        • Get ExamAttemptHeadlineInsight
        • Create ExamCandidateExport
        • Get ExamHall
        • List ExamQuestionStats
        • Create ExamQuestionStatsExport
        • Create ExamV2
        • Find ExamV2s
        • Get ExamV2
        • Update ExamV2
        • Delete ExamV2
        • Create Internal Markers Group
        • Set Shared Markers Group
        • Create Internal Moderating Markers Group
        • Set Shared Moderating Markers Group
        • Set Shared Escalating Markers Group
        • Set Shared Auditing Markers Group
        • Create Internal Escalating Markers Group
        • Create Internal Auditing Markers Group
        • Create Internal BackReading Markers Group
        • Set Shared BackReading Markers Group
        • Update Exam Section
        • Creates a new draft version of the underlying quiz
        • Discards the current draft quiz and replaces it with the latest published version.
        • Sets a quiz as the current published version. New attempts for this exam will use the publishedVersion quiz.
        • Create ExamineeNotification
        • List MarkersInboxItems
      • Insights
        • Get Chart
        • List CustomInsights
        • List InsightsTagBreakdowns
      • Integrations
        • Create Integration
        • Get Integration
        • Update Integration
        • Delete Integration
      • Library
        • Create ContentEmbedDatum
        • Create Content
        • Get Content
        • Update Content
        • Delete Content
        • Create File
        • Get File
        • Get Note
        • Delete Note
        • Update Note
        • Create Note
        • Create ScormCourse
        • Get ScormCourse
        • Update ScormCourse
        • Delete ScormCourse
        • Create SurveyItem
        • Get SurveyItem
        • Update SurveyItem
        • Delete SurveyItem
        • Create SurveyPage
        • Get SurveyPage
        • Update SurveyPage
        • Delete SurveyPage
        • Update Survey Page Items
        • Create SurveyResponse
        • Create Survey
        • Get Survey
        • Update Survey
        • Delete Survey
        • Update Survey Pages
      • Marking
        • Create MarkingEntry
        • List MarkingEntries
        • Update MarkingEntry
        • Get MarkingSession
        • Update MarkingSession
        • List MarkingSessions
        • Create MarkingState
        • List MarkingStates
        • Get MarkingState
        • Update MarkingState
        • Delete MarkingState
      • Mobile
        • Create MobileAttempt
        • List MobileAttempts
        • Get MobileAttempt
        • Update MobileAttempt
        • Create MobileCollectionItem
        • List MobileCollectionItems
        • Get MobileCollectionItem
        • Update MobileCollectionItem
        • Delete MobileCollectionItem
        • List Collections
        • Get Collection
        • List MobileResponses
        • Get MobileResponse
        • Update MobileResponse
        • Get Session
        • Get MobileSpacedLearning
        • Update MobileSpacedLearning
        • Add MobileStudyItems
        • Remove MobileStudyItems
        • Create MobileUser
        • Get MobileUser
      • Notifications
        • Get BackgroundJob
        • Create GenericNotification
        • List NotificationGroups
        • Get TransactionalEmail
        • List TransactionalEmails
      • Portals
        • Get Portal
        • Update Portal
        • Create SubPortal
        • List SubPortals
        • Get SubPortal
        • Update SubPortal
        • Delete SubPortal
        • Create WebhookSubscription
        • List WebhookSubscriptions
        • Get WebhookSubscription
        • Update WebhookSubscription
        • Delete WebhookSubscription
      • Proctoring
        • Get ExternalProctorSessionResult
        • Create ExternalProctorSession
        • List ProctorCaptures
        • List ProctorEventLogs
        • List ProctorReviews
        • Create ProctorReview
        • Get ProctorSession
        • Create ProctorSession
      • Quizzes
        • Create EmqGroupExport
        • Create EmqGroupImportValidation
        • Create EmqGroupImport
        • Create GenerateTestJob
        • Get GenerateTestJob
        • Create GeneratedTest
        • Create QuestionExport
        • Create QuestionImportValidation
        • Create QuestionImport
        • Create QuizEmqGroup
        • Get QuizEmqGroup
        • Update QuizEmqGroup
        • Delete QuizEmqGroup
        • Update quiz section questions.
        • Get QuizPdfExport
        • Create QuizQuestionAudioRecording
        • List QuizQuestionAudioRecording
        • Get QuizQuestionAudioRecording
        • Update QuizQuestionAudioRecording
        • Delete QuizQuestionAudioRecording
        • Create QuizQuestionClozeDragAndDrop
        • List QuizQuestionClozeDragAndDrop
        • Get QuizQuestionClozeDragAndDrop
        • Update QuizQuestionClozeDragAndDrop
        • Delete QuizQuestionClozeDragAndDrop
        • Create QuizQuestionClozeDropDown
        • List QuizQuestionClozeDropDown
        • Get QuizQuestionClozeDropDown
        • Update QuizQuestionClozeDropDown
        • Delete QuizQuestionClozeDropDown
        • Create QuizQuestionClozeText
        • List QuizQuestionClozeText
        • Get QuizQuestionClozeText
        • Update QuizQuestionClozeText
        • Delete QuizQuestionClozeText
        • Create QuizQuestionFileUpload
        • List QuizQuestionFileUpload
        • Get QuizQuestionFileUpload
        • Update QuizQuestionFileUpload
        • Delete QuizQuestionFileUpload
        • Create QuizQuestionFreeText
        • List QuizQuestionFreeText
        • Get QuizQuestionFreeText
        • Update QuizQuestionFreeText
        • Delete QuizQuestionFreeText
        • Create QuizQuestionInformational
        • List QuizQuestionInformational
        • Get QuizQuestionInformational
        • Update QuizQuestionInformational
        • Delete QuizQuestionInformational
        • Create QuizQuestionMultipleCorrect
        • List QuizQuestionMultipleCorrect
        • Get QuizQuestionMultipleCorrect
        • Update QuizQuestionMultipleCorrect
        • Delete QuizQuestionMultipleCorrect
        • Create QuizQuestionRanked
        • List QuizQuestionRanked
        • Get QuizQuestionRanked
        • Update QuizQuestionRanked
        • Delete QuizQuestionRanked
        • Create QuizQuestionShortAnswer
        • List QuizQuestionShortAnswer
        • Get QuizQuestionShortAnswer
        • Update QuizQuestionShortAnswer
        • Delete QuizQuestionShortAnswer
        • Create QuizQuestionSingleCorrect
        • List QuizQuestionSingleCorrect
        • Get QuizQuestionSingleCorrect
        • Update QuizQuestionSingleCorrect
        • Delete QuizQuestionSingleCorrect
        • Create QuizQuestionVideoRecording
        • List QuizQuestionVideoRecording
        • Get QuizQuestionVideoRecording
        • Update QuizQuestionVideoRecording
        • Delete QuizQuestionVideoRecording
        • Create QuizSection
        • List QuizSections
        • Get QuizSection
        • Update QuizSection
        • Delete QuizSection
        • Update quiz section questions.
        • Add quiz section questions.
        • Create QuizSetupValidation
        • Get QuizTagBreakdown
        • Create Quiz
        • Get Quiz
        • Update Quiz
        • Delete Quiz
        • Update Quiz Questions
        • Update Quiz Sections
        • Update Quiz Content Sources
        • Update Quiz Settings Source
        • Get Test
        • Delete Test
        • List Tests
      • Revision
        • List QuestionSummaries
        • Get Study
        • Update Study
        • List Studies
        • Create Study
        • Add StudyItems
        • Remove StudyItems
        • Get StudyItem
        • Delete StudyItem
        • Create StudyItem
      • Search
        • List SearchFilterConfigs
        • Search
      • Shop
        • Create CheckoutSession
        • Get CheckoutSession
        • Update CheckoutSession
        • List LegacyAccessUpgradeOptions
        • Create PortalStore
        • List PortalStores
        • Get PortalStore
        • Update PortalStore
        • Delete PortalStore
        • Create ProductList
        • List ProductLists
        • Get ProductList
        • Update ProductList
        • Delete ProductList
        • Add Products
        • Remove Products
        • Create Product
        • List Products
        • Get Product
        • Update Product
        • Delete Product
        • Get StoreOffer
      • User Groups
        • Create UserGroupExport
        • Create UserGroupLinkAccess
        • List UserGroupLinkSettings
        • Create UserGroupLinkSetting
        • Get UserGroupLinkSetting
        • Update UserGroupLinkSetting
        • Validate UserGroupLink
        • Get UserGroupLink
        • Create UserGroup
        • List UserGroups
        • Get UserGroup
        • Update UserGroup
        • Delete UserGroup
        • Add Users to UserGroup
        • Remove Users from UserGroup
        • Create UserImport
        • List UserTypes
        • Get UserType
        • Update UserType
      • User Feedback
        • Create FlagExport
        • Create Flag
        • List Flags
        • Get Flag
        • Update Flag
        • Create TipSuggestion
        • List TipSuggestions
      • Users
        • Create AccountClosureRequest
        • Create AccountClosure
        • Update AccountClosure
        • Create BotUser
        • List BotUsers
        • List Documents
        • Create EmailVerification
        • Update EmailVerification
        • Create ExternalExamSitting
        • List ExternalExamSittings
        • Update ExternalExamSitting
        • Create GeneratedAccount
        • Create InviteExport
        • List Invites
        • Get Invite
        • Update Invite
        • Create LearningRecordExport
        • Create LearningRecord
        • List LearningRecords
        • Get LearningRecord
        • Update LearningRecord
        • Delete LearningRecord
        • Get App Login QR Code
        • Create MarketingConsent
        • Delete MarketingConsent
        • Create PasswordResetRequest
        • Create PasswordReset
        • Get PasswordReset
        • Update PasswordReset
        • Get Session Context
        • Get UserAccount
        • List UserEngagement
        • Create UserPassword
        • Create UserRegistration
        • Get UserStat
        • List Users
        • Get User
        • Update User
        • Delete User
    • Cookbook
      • Register a User
      • Get Exam Result
      • Proctor Integration
        • Introduction
        • Launch
        • Complete
        • Cancel
        • Review Status

    Getting Started

    The Synap API is currently in beta. Expect some instability, incomplete documentation and potentially breaking-changes.
    This documentation covers the Synap API endpoints and use-cases.
    Looking for our legacy "Org API" documentation? Please click here.
    Looking for the "Synap Academy" Help Guides? Please click here.
    Looking to extend or customise your organisation's Synap platform experience? You've found the right place. Please read on.

    API Design#

    The Synap API is built upon two well-known industry standards:
    OpenAPI v3: Specification
    JSON:API v1.1: Specification
    You do not need to be familiar with either of these standards to begin building with the Synap API. However, any client libraries you wish to use to interact with the API can safely assume that the requests and responses will adhere to these standards.

    First Request#

    You do not need an organisation-level "secret" API Key to access the Synap API. Instead, we have opted for a self-managed token approach called Personal Access Tokens (PATs). Once obtained, you add this to each request as an Authorization: Bearer <token>. Read the Authentication guide to learn more.
    Once you have obtained a PAT, here is a simple CURL request that you can try:
    If you see some data related to your organisation's Portal, the request was successful:
    { "data": {"type":"Portal", "id":"...", "attributes": { ... }} }
    Otherwise, if your PAT was invalid or misconfigured, you may see the following:
    { "errors": [{"status":"404","title":"...","detail":"..." }] }

    Testing#

    You may wish to build your integration against our "Staging" API. However, as this API will be unable to access your organisation's "live" data, we must first setup a staging environment for you. This is currently only available to our Enterprise customers. Please get in touch if your organisation needs this functionality.
    Modified at 2025-07-07 21:16:19
    Next
    Authentication
    Built with