Changelog last updated Sep 2nd 2026

Sep 2nd 2026

  • The Monitoring Event Site schema now carries name: the sites display name, built the way the monitoring report prints it - the sites number and its paddock, e.g. 3-La Pampa. Use it to label a site to a reader instead of showing the raw id.
  • historicalName comes with it - the producers own name for the site, e.g. ST 1' - and is present on about two thirds of sites.
  • Both are resolved from the monitoring site on read, so renaming a site updates every event it appears in. Both are absent when the site document has been deleted.
  • Two sites under one landbase can share a name; the monitoringSites key is still the identity.
  • The site name on v1/monitoringevents/{id}/ecology is populated by the same derivation. It was documented but never returned.

Aug 27th 2026

  • The Monitoring Event Site schema now documents requiredPhotos: the four photo slots (horizon, angle45, nadir, photoOfInterest) captured at a site during a monitoring event. Each slot is a URL once uploaded, an empty string after a delete cleared it, and null when never filled.
  • On the oldest events the fourth slot was stored under its legacy name soilShovelSample; responses now resolve it to photoOfInterest so photo pairs work across an event's full history.
  • To compare oldest against newest photos of a site, list the landbases monitoring events and follow the same monitoringSites key across eventDate's.
  • The Eco Region schema now carries its biome: biomeId is the stored assignment, and biome is the resolved object with the biomes name, ehiCeiling and brittleness band (brittlenessMin / brittlenessMax'). Both v1/ecoregions and v1/ecoregions/{id} return them.
  • ehiCeiling is the maximum Ecological Health Index score attainable in that biome - use it to normalize an EHI before comparing scores across eco regions.
  • biome is always present and is null when no biome has been assigned to the eco region yet.

Mar 26th 2026

  • Added new migration aliases for legacy scorecard field naming: evaluationMatrix mirrors scorecard on Monitoring Site responses, and evaluationMatrixId / evaluationMatrixAnswers mirror scorecardId / scorecardAnswers on Monitoring Event Site responses.
  • Both old and new field names are returned with identical values to support client migration to new field names. Old field names will be deprecated sometime in the future.
  • Added alias routes that mirror scorecard resources: GET v1/evaluationmatrices/{id} (same as v1/scorecards/{id}) and GET v1/ecoregions/{id}/evaluationmatrices (same as v1/ecoregions/{id}/scorecards).

Jan 23rd 2026

  • The approved field has been removed from the Eco Region schema - the verification.admin.verified field should be used to determine if the Eco Region has been verified

Previous Updates

  • The ehi field has been added to the Monitoring Event schema for Short Term events - this value will be calculated automatically
  • The shannonWeiner, speciesCount, and functionalGroupCount fields have been added to the Monitoring Event Site (response) schema for Long Term events - these values will be calculated automatically
  • The paddockId field has been added to the Monitoring Event Site (response) schema - this field is automatically set based on the Monitoring Site's paddock when the event is created.
  • The notes field has been added to the Evaluation Matrix/Scorecard schema as an optional field - Scorecards are currently read-only
  • The completed field was removed from the Monitoring Event Site schema - this field is deprecated and no longer used
  • The totalScore field was removed from the Monitoring Event Site input schema - this field is calculated will be returned in the response
  • The Monitoring Event-Site endpoints have been made more flexible and only the fields included in the payload will be updated - previously the entire site object was required
  • The Monitoring Event-Site endpoint schema has been updated so only Short Term events require the requiredPhotos field - previously this field was (incorrectly) required for all events
  • All Monitoring Event-Site endpoints will now return the full Monitoring Event object in the response, including the newly added site - previously only the event-site object was returned
  • Monitoring Event schema has been updated - Weather Observations have been moved to the top level observations field and Wildlife Observations have been updated with the correct schema.
  • FlexibleArea and BeltArea schemas have been updated with minimum acceptable values for area and distance
  • Monitoring Event schema has been updated to add the usableArea and totalArea fields - these values are read-only and are set by the monitoring plan when the event is created.
  • Monitoring Plan schema has been updated to add the usableArea and totalArea fields.
  • Landbase schema has been updated to remove the usableArea and totalArea fields
  • Eco Region schema has been updated to replace the approved field with verification fields
  • Scorecard schema has been updated to replace the approved field with verification fields
  • When adding a monitoring site to a monitoring event, the siteId will be validated against the landbase's monitoring plan to ensure it is valid
  • The v1/landbases/{id}/monitoringPlan endpoint now allows for updating the Long and Short Term siteId arrays individually by sending only the array(s) you want to update
  • Paginated endpoints now return a total field with the total number of documents found
  • Protections have been added to prevent editing of verified Monitoring Events
  • Verification fields have been added to the MonitoringEvent schema for GET endpoints
  • The renamed misspelled quantity field to quality in the v1/monitoringevents/{id}/monitoringSites/{id}/forage endpoint
  • All paddock endpoints have been moved to the v1/landbases/{landbaseId}/paddocks route from the v1/paddocks route
  • The v1/ecoregions/{id}/scorecards route now supports pagination - as a result the endpoint schema has changed
  • The v1/landbases/{id}/monitoringsites route now supports pagination - as a result the endpoint schema has changed
  • The v1/landbases/{id}/monitoringevents route now supports pagination - as a result the endpoint schema has changed
  • Updated the v1/monitoringevents/{id}/monitoringSites/{id}/transects endpoint to be plural (previously was transect)
  • Redundant IDs have been removed from payload schemas when they were present in the route (such as landbaseId in the monitoringevent creation payload)