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
| Resource | What it is | Portals |
|---|---|---|
species | The shared list of species subjects can belong to. | private, public |
strain | The shared list of strains, each belonging to a species. | private, public |
anatomicalregion | The shared atlas of brain regions that procedures and recordings point to. | private, public |
anatomicalreference | Immutable, system-managed anatomical atlas release metadata. | private, public |
coordinatetransform | Named, versioned mapping from a BrainSTEM coordinate type to an atlas. | private, public |
behavioralcategory | A shared two-level grouping of behavioral paradigms by cognitive domain. | private, public |
behavioralparadigm | A standard behavioral task shared across labs, independent of how one lab runs it. | private, public |
setuptype | A shared classification of experimental preparations, such as head-fixed or freely moving. | private, public |
regulatoryauthority | The 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.
| Resource | What it is | Portals |
|---|---|---|
behavioralcategoryapproval | A request to add or change a shared behavioral category, reviewed before it takes effect. | private |
behavioralparadigmapproval | A request to add or change a shared behavioral paradigm, reviewed before it takes effect. | private |
regulatoryauthorityapproval | A request to add or change a shared regulatory authority, reviewed before it takes effect. | private |
setuptypeapproval | A request to add or change a shared setup type, reviewed before it takes effect. | private |
speciesapproval | A request to add or change a shared species, reviewed before it takes effect. | private |
strainapproval | A 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.