fleshing out the subject API