Skip to navigation

Add a subject to a curriculum container

View as Markdown

Adds a subject to this container, appended after the subjects already in it.

The subject must already exist in the institution’s subject catalogue for the same year. A code we don’t hold is a 400, so a typo can’t become a dangling reference. 404 if the container is unknown, 409 if the subject is already in it.

Optionally assert the owner with programCode and programYear, or specialisationCode and specialisationYear. Supply one pair, not both.

Authentication

AuthorizationBearer

Paste a Keycloak access token (no "Bearer " prefix)

Path parameters

structureIdstringRequiredformat: "uuid"

Query parameters

programCodestringOptional
programYearintegerOptional
specialisationCodestringOptional
specialisationYearintegerOptional

Request

This endpoint expects an object.
codestringOptional
The subject code, e.g. "MATH1131".
yearintegerOptional
Catalogue year of the subject, e.g. 2026.

Response

The subject was added to the container.
idstringOptionalformat: "uuid"
itemTypestringOptional

Course | Major | Minor | Honours | Specialisation | Research. Only Course can be added through the API; the rest came from the handbook.

codestringOptional
yearintegerOptional
namestringOptional
uocintegerOptional
Credit points this entry contributes.
resolvedbooleanOptional
False when the code isn't in our catalogue. Only ever the case for entries from the original handbook import, because subjects added through the API must resolve.

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error