Schemas

Use this section when an endpoint asks for type/details or coordinates_system/coordinates_details.

How schemas relate to API calls

  • A module endpoint validates the JSON fragment in details (or coordinates_details) against a schema chosen by type (or coordinates_system).
  • If fields do not match the selected schema, the API returns 400 Bad request with validation errors.
  • Always send the selector and payload pair together in create/update calls.

Schema groups

GroupUsed by endpoint(s)Selector fieldPayload field
Coordinates/api/private/modules/procedure/coordinates_systemcoordinates_details
ConsumableStock/api/private/modules/consumablestock/typedetails
DataAcquisition/api/private/modules/dataacquisition/typedetails
Equipment/api/private/modules/equipment/typedetails
Manipulation/api/private/modules/manipulation/typedetails
Procedure/api/private/modules/procedure/typedetails
ProcedureLog/api/private/modules/procedurelog/typedetails
SubjectLog/api/private/modules/subjectlog/typedetails

Validation troubleshooting

  • type or coordinates_system not recognized: use one value from the target schema page quick map.
  • Missing required field: add all fields listed under Required fields for that schema.
  • Wrong nested shape: check whether field expects scalar (string, number) vs object (value + unit) or array rows.
  • Unit mismatch: use one of the unit enum values documented in constraints.