Add a subject to a curriculum container
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
structureId
Query parameters
programCode
programYear
specialisationCode
specialisationYear
Request
This endpoint expects an object.
code
The subject code, e.g. "MATH1131".
year
Catalogue year of the subject, e.g. 2026.
Response
The subject was added to the container.
id
itemType
Course | Major | Minor | Honours | Specialisation | Research. Only Course can be added through the API; the rest came from the handbook.
code
year
name
uoc
Credit points this entry contributes.
resolved
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
