Webhooks and AI Reports: Getting Results from TrustExam

Webhooks

If configured in assignment.settings.webhook, TrustExam will send HTTP POST requests to your endpoints at the start and end of each exam.

• start_url – called when the exam begins.

• finish_url – called when the exam ends.

Each webhook contains:

• Attempt identifiers (including your session_data.external_id if provided),

• Status and timestamps,

• Basic exam metadata,

• Optional fields from webhook.post, webhook.query, and webhook.headers.
  
  

Use webhooks to:

• Sync exam status into your LMS,

• Trigger grading or review workflows,

• Notify instructors or HR systems.

Report URL

The backend API response includes:

{
  "external_session": { "token": "..." },
  "report_url": "https://app.trustexam.ai/.../report"
}

{
  "external_session": { "token": "..." },
  "report_url": "https://app.trustexam.ai/.../report"
}

{
  "external_session": { "token": "..." },
  "report_url": "https://app.trustexam.ai/.../report"
}

• report_url – a direct link to the exam attempt report in the TrustExam UI.

• Use this URL in your admin or instructor panel for quick access.

AI Attempt Report API

TrustExam can generate an AI-based proctoring report for each attempt.

GET

https://trust-rating.trustexam.ai/api/v1/actions/reports/ai/ATTEMPT_ID?api_token=API_KEY

https://trust-rating.trustexam.ai/api/v1/actions/reports/ai/ATTEMPT_ID?api_token=API_KEY

https://trust-rating.trustexam.ai/api/v1/actions/reports/ai/ATTEMPT_ID?api_token=API_KEY

Where:

• ATTEMPT_ID – internal ID of the attempt (returned in webhooks or UI).

• API_KEY – your TrustExam rating API key.
  
  

The response includes a structured AI assessment of exam integrity, such as:

• Overall risk score,

• List of detected violations,

• Timeline of suspicious events,

• Recommendations for manual review.

Use this endpoint when you:

• Need to automate decision-making (e.g., flagging attempts),

• Integrate risk scores into your HR or academic decision pipeline,

• Build custom dashboards or analytics.