academyFIVE API icon

academyFIVE API

Interact with academyFIVE API

Actions549

Subject-versions [Beta] → Update a subject version [Beta]

AI-generated

Summary

Update an existing subject version by sending the specified subject version ID and updated data fields to the academyFIVE API.

Inputs

  • subjectVersionId (required) — The ID of the subject version to update, provided as a path parameter.
  • data (required) — An object containing the update data including 'id' (required), optional 'type', and 'attributes' such as 'labelDe', 'labelEn', 'version', and nested assignee information ('responsibleAssignee', 'coordinatorAssignee', 'additionalAssignees').

Output shape

a JSON array containing the API response objects, each paired with the respective input item index; or execution data containing binary file data if the response is binary.

The operation sends a PATCH request to /api/v1/subject-versions/{subjectVersionId} with the structured update payload under 'data'. The response is parsed as JSON unless it matches expected binary response MIME types, in which case binary data is handled accordingly. Errors can be captured per item if 'Continue On Fail' is enabled.

Examples

Example 1: Update a subject version's labels and version number, specifying the subject version ID.

Set 'subjectVersionId' to the target ID, fill the 'data' parameter with the 'id' of the subject version and optionally provide 'attributes' such as 'labelEn', 'labelDe', and 'version' to update respective fields.

Links

Discussion