changedInput schema / properties / include / description
Previous value: -"Embedded arrays to expand per record. identifications is the default and is what carries the thread; the others cost context, so check photo_count and sound_count first."New value: +"Embedded arrays to expand per record. identifications is the default and is what carries the thread; the others cost context, so check photo_count and sound_count first. identifications and comments — like the observation_fields every record carries — share a 40-entry budget across the batch: each record keeps at most 40 ÷ records returned entries per array (never fewer than 4), and reports identifications_total, comments_total, and observation_fields_total beside what it kept — request one id alone for the 40-entry view."
changedOutput schema / properties / notice / description
Previous value: -"Guidance when part of the batch did not resolve."New value: +"Guidance when part of the batch did not resolve, or when a thread or observation-field list was cut to fit the response."
changedOutput schema / properties / observations / description
Previous value: -"The observations that resolved, with the expansions that were requested."New value: +"The observations that resolved, in the requested order with unresolved ids left out, carrying the expansions that were requested."
changedOutput schema / properties / observations / items / properties / agreements / description
Previous value: -"How many identifications agree with the current taxon."New value: +"How many identifications currently agree with the community taxon."
changedOutput schema / properties / observations / items / properties / comments / description
Previous value: -"Discussion comments. Present when \"comments\" was included."New value: +"Discussion comments, cut to their first entries in upstream order (not strictly chronological) when they exceed the per-record share of a 40-entry budget. Present when \"comments\" was included."
addedOutput schema / properties / observations / items / properties / comments_shown
Added value: +{
+ "description": "How many of them comments carries. Below comments_total when the thread was cut. Present when \"comments\" was included.",
+ "type": "number"
+}
addedOutput schema / properties / observations / items / properties / comments_total
Added value: +{
+ "description": "How many comments upstream holds on the record. Present when \"comments\" was included.",
+ "type": "number"
+}
addedOutput schema / properties / observations / items / properties / description
Added value: +{
+ "description": "The observer’s own note on the sighting — host plant, behaviour, habitat, count. Third-party free text. Present on the by-id tool; null when the observer wrote none.",
+ "type": [
+ "string",
+ "null"
+ ]
+}
changedOutput schema / properties / observations / items / properties / disagreements / description
Previous value: -"How many identifications disagree with the current taxon."New value: +"How many identifications currently disagree with the community taxon."
changedOutput schema / properties / observations / items / properties / identifications / description
Previous value: -"The identification thread. Present when \"identifications\" was included."New value: +"The identification thread, cut to its first entries in upstream order (roughly but not strictly chronological) when it exceeds the per-record share of a 40-entry budget. Present when \"identifications\" was included."
changedOutput schema / properties / observations / items / properties / identifications_count / description
Previous value: -"How many identifications the thread holds."New value: +"Upstream’s tally of identifications currently agreeing or disagreeing with the community taxon — agreements + disagreements. Not the thread size: it leaves out the observer’s own identification and any that neither agrees nor disagrees, such as a coarser or withdrawn one. The thread size is identifications_total, on inaturalist_get_observation."
addedOutput schema / properties / observations / items / properties / identifications_shown
Added value: +{
+ "description": "How many of them identifications carries. Below identifications_total when the thread was cut. Present when \"identifications\" was included.",
+ "type": "number"
+}
addedOutput schema / properties / observations / items / properties / identifications_total
Added value: +{
+ "description": "How many identifications upstream holds on the record — the thread size. Present when \"identifications\" was included.",
+ "type": "number"
+}
addedOutput schema / properties / observations / items / properties / observation_fields
Added value: +{
+ "description": "Observation-field values filled in on the record, usually by a project; fields left blank are dropped. Cut to the first filled fields in upstream order when they exceed the per-record share of a 40-entry budget. Present on the by-id tool.",
+ "items": {
+ "additionalProperties": false,
+ "description": "One filled observation field.",
+ "properties": {
+ "name": {
+ "description": "Field name, as its creator wrote it, e.g. \"Habitat_Description\".",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "description": "The value filled in, verbatim.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "value"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
addedOutput schema / properties / observations / items / properties / observation_fields_shown
Added value: +{
+ "description": "How many of them observation_fields carries. Below observation_fields_total when the list was cut. Present on the by-id tool.",
+ "type": "number"
+}
addedOutput schema / properties / observations / items / properties / observation_fields_total
Added value: +{
+ "description": "How many filled observation fields the record carries. Present on the by-id tool.",
+ "type": "number"
+}