academyFIVE API Beta icon

academyFIVE API Beta

Interact with academyFIVE API

Actions482

Lecturer-contract-employments [Beta] → Update a lecturer contract employment

AI-generated

Summary

Update a lecturer contract employment by sending its required type and id with any supplied attributes or relationship changes to the academyFIVE API. Attributes can include teaching units, dates, occupation type, capacity, and working days; the employment status relationship can be set by status type and id.

Inputs

  • data.type (required) — Type value for the employment record.
  • data.id (required) — ID of the lecturer contract employment to update.
  • data.attributes (required) — Optional fields to update: teachingUnits, startDate, endDate, occupationTypeId (1 = Internal, 2 = External), capacity, and workingDays. Working days use ISO weekdays 1–7 and are available only when Teaching load PRO is active.
  • data.relationships.lecturerContractEmploymentStatus.data — Optionally set the employment status using its type and required id. The status id is found in academyFIVE under Settings → Lecturer contracts → Status values employments.

Output shape

A list of JSON items from the API response.

Each returned item is paired with its input item. If Continue On Fail is enabled, a failed request produces an item with an error field.

Links

Discussion