Previous value: -"Observation ids to fetch, 1 to 10. Find current ids for an area with inaturalist_search_observations."New value: +"Observation ids to fetch, 1 to 100 submitted ids. The first 10 distinct ids are attempted; any remaining distinct ids are deferred to another call. Find current ids for an area with inaturalist_search_observations."

Previous value: -10New value: +100

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "observations",
-      "unresolved"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "observations",
+      "unresolved",
+      "deferred"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "description": "Distinct ids beyond the attempted batch, in requested order. Empty when no work remains.",
+  "items": {
+    "additionalProperties": false,
+    "description": "One id to request in a subsequent call.",
+    "properties": {
+      "observation_id": {
+        "description": "An id not attempted in this call.",
+        "type": "number"
+      }
+    },
+    "required": [
+      "observation_id"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: None of the requested ids resolved to an observation. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: None of the attempted ids resolved to an observation and no deferred ids remain. Other values are possible when a failure originates below the handler."

Previous value: -"Decoded attribute label, e.g. \"Life Stage\". Null when the id is not in the vocabulary."New value: +"Attribute label, e.g. \"Life Stage\"; null for an unknown id."

Previous value: -"Decoded value label, e.g. \"Larva\". Null when the id is not in the vocabulary."New value: +"Value label, e.g. \"Larva\"; null for an unknown id."

Previous 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."New value: +"Requested comments, first entries in upstream order (not strictly chronological), sharing a 40-entry budget across records."

Previous value: -"How many of them comments carries. Below comments_total when the thread was cut. Present when \"comments\" was included."New value: +"Comment entries returned; below comments_total when capped."

Previous value: -"How many comments upstream holds on the record. Present when \"comments\" was included."New value: +"Comment count before the cap; present with \"comments\"."

Previous value: -"Consensus taxon, resolved. Present on the by-id tool; null when the thread has reached none."New value: +"Resolved consensus taxon on detail records; null without consensus."

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "accuracy_m": {
-        "description": "Public positional accuracy radius in metres. On an obscured record this is tens of kilometres and the point is a locality, not a sighting position.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "lat": {
-        "description": "Latitude in decimal degrees.",
-        "type": "number"
-      },
-      "lng": {
-        "description": "Longitude in decimal degrees.",
-        "type": "number"
-      }
-    },
-    "required": [
-      "lat",
-      "lng",
-      "accuracy_m"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accuracy_m": {
+        "description": "Public accuracy radius, metres. An obscured point is a locality, not a sighting position.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "lat": {
+        "description": "Latitude in decimal degrees.",
+        "type": "number"
+      },
+      "lng": {
+        "description": "Longitude in decimal degrees.",
+        "type": "number"
+      }
+    },
+    "required": [
+      "lat",
+      "lng",
+      "accuracy_m"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"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."New value: +"Verbatim observer note on detail records; null when none was written, distinct from an empty string."

Previous value: -"Count of disagreeing identifications as upstream tallies it. Present on the by-id tool."New value: +"Upstream disagreement count on detail records."

Previous 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."New value: +"Requested identification thread, first entries in upstream order (not strictly chronological), sharing a 40-entry budget across records."

Previous 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."New value: +"Tally against the community taxon: agreements + disagreements. Excludes the observer and neutral/withdrawn ids; thread size is identifications_total on inaturalist_get_observation."

Previous value: -"How many of them identifications carries. Below identifications_total when the thread was cut. Present when \"identifications\" was included."New value: +"Identification entries returned; below identifications_total when capped."

Previous value: -"How many identifications upstream holds on the record — the thread size. Present when \"identifications\" was included."New value: +"Thread size before the cap; present with \"identifications\"."

Previous value: -"True when the true coordinate is withheld, typically for a threatened taxon. The point is never resolved or approximated."New value: +"True when the true coordinate is withheld; the public point is a locality."

Previous value: -"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."New value: +"Filled fields on detail records, verbatim; blanks omitted. First entries in upstream order, sharing a 40-entry budget across records."

Previous value: -"Field name, as its creator wrote it, e.g. \"Habitat_Description\"."New value: +"Verbatim field name, e.g. \"Habitat_Description\"."

Previous value: -"How many of them observation_fields carries. Below observation_fields_total when the list was cut. Present on the by-id tool."New value: +"Filled fields returned; below observation_fields_total when capped."

Previous value: -"How many filled observation fields the record carries. Present on the by-id tool."New value: +"Filled field count before the cap on detail records."

Previous value: -"Login of the observer. The rest of the upstream profile is not relayed."New value: +"Observer login."

Previous value: -[
-  {
-    "additionalProperties": false,
-    "description": "A photo with the attribution and licence that must travel with it.",
-    "properties": {
-      "attribution": {
-        "description": "Attribution string, verbatim and never reformatted. Reproduce it with any use of the image.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "license_code": {
-        "description": "Photo licence code. Null means all rights reserved, independent of the record.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "medium_url": {
-        "description": "Medium variant. Supplied by upstream where it publishes every size, otherwise derived by substituting the size qualifier in the path. Absent when the path did not match the documented shape.",
-        "type": "string"
-      },
-      "open": {
-        "description": "True when the photo is served from the host the upstream reserves for open licences. A photo can move hosts when its licence changes, so this reflects fetch time.",
-        "type": "boolean"
-      },
-      "square_url": {
-        "description": "75px square variant, exactly as upstream published it. Null when absent.",
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "square_url",
-      "attribution",
-      "license_code",
-      "open"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "description": "A photo with the attribution and licence that must travel with it.",
+    "properties": {
+      "attribution": {
+        "description": "Verbatim attribution; reproduce with any use of the image.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "license_code": {
+        "description": "Photo licence code. Null means all rights reserved, independent of the record.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "medium_url": {
+        "description": "Medium image URL; derived from the size path if needed. Absent when no variant is available.",
+        "type": "string"
+      },
+      "open": {
+        "description": "True when served from the open-licence host at fetch time; licences can change.",
+        "type": "boolean"
+      },
+      "square_url": {
+        "description": "75px square variant, exactly as upstream published it. Null when absent.",
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "square_url",
+      "attribution",
+      "license_code",
+      "open"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"How many photos the record carries, so include \"photos\" can be spent knowingly."New value: +"Photo count; include \"photos\" for every photo."

Previous value: -"Attribution string, verbatim and never reformatted. Reproduce it with any use of the image."New value: +"Verbatim attribution; reproduce with any use of the image."

Previous value: -"Medium variant. Supplied by upstream where it publishes every size, otherwise derived by substituting the size qualifier in the path. Absent when the path did not match the documented shape."New value: +"Medium image URL; derived from the size path if needed. Absent when no variant is available."

Previous value: -"True when the photo is served from the host the upstream reserves for open licences. A photo can move hosts when its licence changes, so this reflects fetch time."New value: +"True when served from the open-licence host at fetch time; licences can change."

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."

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."

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."

Previous value: -"How many identifications agree with the current taxon."New value: +"How many identifications currently agree with the community taxon."

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."

Added value: +{
+  "description": "How many of them comments carries. Below comments_total when the thread was cut. Present when \"comments\" was included.",
+  "type": "number"
+}

Added value: +{
+  "description": "How many comments upstream holds on the record. Present when \"comments\" was included.",
+  "type": "number"
+}

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"
+  ]
+}

Previous value: -"How many identifications disagree with the current taxon."New value: +"How many identifications currently disagree with the community taxon."

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."

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."

Added value: +{
+  "description": "How many of them identifications carries. Below identifications_total when the thread was cut. Present when \"identifications\" was included.",
+  "type": "number"
+}

Added value: +{
+  "description": "How many identifications upstream holds on the record — the thread size. Present when \"identifications\" was included.",
+  "type": "number"
+}

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"
+}

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"
+}

Added value: +{
+  "description": "How many filled observation fields the record carries. Present on the by-id tool.",
+  "type": "number"
+}