STEM API endpoints

The STEM app holds the core records of a study: projects, the subjects and specimen sets studied in them, the sessions in which data was recorded, and the cohorts, collections, breedings and epochs that organize them. Permissions for every other record derive from these.

Resources

ResourceWhat it isPortals
projectGroups the subjects, sessions and specimens of a study and sets who can see and edit them.private, public
subjectAn animal in a study, described by its species, strain, sex and the procedures and logs recorded for it.private, public
sessionOne experimental session, described by the behaviors, data acquisition and manipulations that took place in it.private, public
specimensetTissue or cultures prepared together, such as a slice series or a well plate, usually taken from a subject.private, public
specimenOne item of a specimen set, such as a single slice, section or well.private, public
cohortA named subgroup of a project’s subjects, for an analysis or an experimental group.private, public
collectionA named subgroup of a project’s sessions, for an analysis or a figure.private, public
breedingA breeding pair, the dam and the sire, with the litters it produced.private, public
epochA stretch of a session, such as a baseline or a stimulation block, with the behavior, data acquisition and manipulations recorded in it.private, public

Supporting endpoints

Approval requests, membership invitations and link tables. Most workflows never call these directly; the main resources create and resolve them.

ResourceWhat it isPortals
cohortsubjectCohort subject records.private, public
collectionsessionCollection session records.private, public
projectgroupmembershipinvitationTable to store invitations for groups to join a project. When any user in the group accepts / rejects the invitation, this record will be deleted.private
projectmembershipinvitationTable to store invitations for members to join a project. When the user accepts / rejects the invitation, this record will be deleted.private
sessiondatastorageSession data storage records.private, public

All endpoints follow https://www.brainstem.org/api/{portal}/stem/{resource}/ and support the common query parameters.