Skip to navigation
UNSW Advance Institution APICatalogue

Add a specialisation to a curriculum container

View as Markdown

Adds a specialisation to this container, appended after the items already in it.

itemType says which kind: Major, Minor, Honours, Specialisation or Research. Anything else is a 400, including Course — use the subjects endpoint for those.

The specialisation must already exist in the institution’s specialisation 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 specialisation is already in it under any type.

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 specialisation code, e.g. "COMPBH".
yearintegerOptional
Catalogue year of the specialisation, e.g. 2026.
itemTypeenumOptional
Which kind of specialisation this is within the container.
Allowed values:

Response

The specialisation 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