academyFIVE API icon

academyFIVE API

Interact with academyFIVE API

Actions549

Exams [Beta] → Create a new exam

AI-generated

Summary

Create a new exam in the academyFIVE system by specifying detailed exam data and required relationships such as site, study program, grading key, and participant presentation.

Inputs

  • data (required) — An object containing the exam's core details: 'type' (string), 'attributes' including exam-specific flags (e.g., isResitExam), year, term, valuationType, participantPresentationId, examPartGeneration, and optional properties like maxPoints, date, times, duration, labelSuffix, comments, result publication date, and various boolean flags controlling exam behavior and integrations. If examPartGeneration is manual (value 3), 'numberOfManualCreatedPartialExams' must be defined (between 2 and 10).
  • relationships (required) — Object defining key relationships for the new exam, including mandatory 'site', 'studyProgram', and 'gradingKey' each with 'data' containing 'type' and 'id'. Optional related entities include 'subjectVersion', 'moduleVersion', 'examGenerationTemplate', 'lecturers', 'assessors', 'rooms', 'submission', and 'teachingLanguages', each specified similarly with type and id fields.

Output shape

a JSON array with the created exam's data or an error object if creation fails

The node processes each input item independently; on success, the response data is returned as JSON with the item index paired. If an error occurs and 'Continue On Fail' is enabled, the error message is returned for that item instead of stopping execution.

Links

Discussion