Taxonomies API endpoints

Taxonomies are the shared controlled vocabularies: species, strains, anatomical regions and their atlas references, coordinate transforms, behavioral categories and paradigms, setup types and regulatory authorities. Changes by users without approval rights become approval requests.

Resources

ResourceWhat it isPortals
speciesThe shared list of species subjects can belong to.private, public
strainThe shared list of strains, each belonging to a species.private, public
anatomicalregionThe shared atlas of brain regions that procedures and recordings point to.private, public
anatomicalreferenceImmutable, system-managed anatomical atlas release metadata.private, public
coordinatetransformNamed, versioned mapping from a BrainSTEM coordinate type to an atlas.private, public
behavioralcategoryA shared two-level grouping of behavioral paradigms by cognitive domain.private, public
behavioralparadigmA standard behavioral task shared across labs, independent of how one lab runs it.private, public
setuptypeA shared classification of experimental preparations, such as head-fixed or freely moving.private, public
regulatoryauthorityThe shared list of organizations that issue research licenses.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
behavioralcategoryapprovalA request to add or change a shared behavioral category, reviewed before it takes effect.private
behavioralparadigmapprovalA request to add or change a shared behavioral paradigm, reviewed before it takes effect.private
regulatoryauthorityapprovalA request to add or change a shared regulatory authority, reviewed before it takes effect.private
setuptypeapprovalA request to add or change a shared setup type, reviewed before it takes effect.private
speciesapprovalA request to add or change a shared species, reviewed before it takes effect.private
strainapprovalA request to add or change a shared strain, reviewed before it takes effect.private

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