changedInput schema / properties / canvas_id / description
Previous value: -"Also stage the values on this dataframe canvas as a table with two columns, code and label, holding every value the dimension lists — past the inline cap too — at the geo_level requested, country when it is omitted. Pass the canvasId a eurostat_download_dataset or eurostat_query_dataset response returned, then search the staged table with SQL or join it to a download on the dimension column (e.g., d.geo = g.code). Omit to return the values inline only: this tool never starts a canvas. Ignored on deployments without a dataframe canvas."New value: +"Also stage the values on this dataframe canvas as a table with two columns, code and label, holding every value the dimension lists at the geo_level requested (country when it is omitted), whatever filter and limit are. Pass the canvasId a eurostat_download_dataset or eurostat_query_dataset response returned, then search the staged table with SQL or join it to a download on the dimension column (e.g., d.geo = g.code). Only on a call without cursor; omit to return the values inline only: this tool never starts a canvas. Ignored on deployments without a dataframe canvas."
addedInput schema / properties / cursor
Added value: +{
+ "description": "Opaque nextCursor from the previous page; omit for the first page. It resumes after that page's last code and is bound to dataset_code, dimension, geo_level and filter, so send those unchanged. Cannot be combined with canvas_id on a deployment with a dataframe canvas.",
+ "type": "string"
+}
addedInput schema / properties / filter
Added value: +{
+ "description": "Words to find, up to 500 characters: keeps only values whose code and label, joined by a space, contain every whitespace-separated word as a substring — in any order, ignoring case and accents (\"palma frankfurt\" finds DE_EDDF_ES_LEPA, \"zurich\" finds Zürich). Punctuation is part of a word, and spellings are not transliterated (\"münchen\" does not find MUENCHEN). Runs over the whole list at the effective geo_level before paging and keeps Eurostat's order, with no ranking; matchCount counts the matches.",
+ "maxLength": 500,
+ "type": "string"
+}
addedInput schema / properties / limit
Added value: +{
+ "description": "Most values per page. No default and no maximum: without it a page holds as many whole values as fit 64,000 bytes, and with it the page ends at whichever comes first. Fixed by the first call: on a call with cursor, the cursor carries that first limit and this field is ignored.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+}
removedOutput schema / properties / cap
Removed value: -{
- "description": "The inline cap applied. Present alongside truncated.",
- "type": "number"
-}
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: The dataset code or dimension code does not exist. `no_results`: The dataset has no geo values at the effective geo_level. `conflicting_params`: geo_level was combined with a dimension other than \"geo\", where it has no effect. `upstream_fault`: Eurostat returned a dataset structure or content constraint this server cannot read: malformed, truncated, not XML, or missing the requested dataset's dataflow. `canvas_not_found`: A canvas_id was supplied for staging but is unknown or its lifetime has elapsed. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: The dataset code or dimension code does not exist. `no_results`: The dataset has no geo values at the effective geo_level. `conflicting_params`: geo_level was combined with a dimension other than \"geo\", where it has no effect; or, on a deployment with a dataframe canvas, canvas_id was combined with cursor, which would stage the list again on every page. `invalid_cursor`: The cursor is malformed, was issued for a different dataset_code, dimension, geo_level or filter, or resumes after a code the list no longer holds. `upstream_fault`: Eurostat returned a dataset structure or content constraint this server cannot read — malformed, truncated, not XML, or missing the requested dataset's dataflow — or the structure endpoint answered HTTP 5xx or could not be reached on every retry, which the error marks retryable. `canvas_not_found`: A canvas_id was supplied for staging but is unknown or its lifetime has elapsed. Other values are possible when a failure originates below the handler."
changedOutput schema / properties / error / properties / data / properties / reason / examples
Previous value: -[
- "not_found",
- "no_results",
- "conflicting_params",
- "upstream_fault",
- "canvas_not_found"
-]New value: +[
+ "not_found",
+ "no_results",
+ "conflicting_params",
+ "invalid_cursor",
+ "upstream_fault",
+ "canvas_not_found"
+]
addedOutput schema / properties / matchCount
Added value: +{
+ "description": "Values matching filter across the whole list, before paging. Present only when filter was passed.",
+ "type": "number"
+}
addedOutput schema / properties / nextCursor
Added value: +{
+ "description": "Opaque cursor for the next page. Pass it back as cursor with dataset_code, dimension, geo_level and filter unchanged; it resumes after this page's last code. Omitted on the last page.",
+ "type": "string"
+}
changedOutput schema / properties / notice / description
Previous value: -"Where the values past the inline cap are: the staged table when canvas_id was passed, or how to stage them. Present alongside truncated."New value: +"On a page with more after it: whether limit or the response budget ended it, and the routes to the rest — nextCursor, filter, and canvas_id. Also explains a filter that matched nothing."
removedOutput schema / properties / shown
Removed value: -{
- "description": "Values returned inline. Present alongside truncated.",
- "type": "number"
-}
changedOutput schema / properties / totalCount / description
Previous value: -"Number of distinct values the dimension lists, after geoLevel filtering for geo — all of them, including any past the inline cap."New value: +"Number of distinct values the dimension lists, after geoLevel filtering for geo — every one, whatever filter and paging apply."
changedOutput schema / properties / truncated / description
Previous value: -"True when the dimension lists more values than the inline cap and values holds only the first of them. Omitted when values holds every one."New value: +"True when more values follow this page — pass nextCursor as cursor to fetch them. Omitted on the last page."
changedOutput schema / properties / values / description
Previous value: -"Dataset-available values for this dimension, in Eurostat's order — for geo, the subset at geoLevel. Holds every value up to 2,000; past that, the first 2,000, with truncated set and the whole list on the canvas table when canvas_id was passed."New value: +"This page of the dataset-available values, in Eurostat's order — for geo, the subset at geoLevel; with filter, only the matches. A page ends between whole values, at limit or at 64,000 bytes per response surface, whichever comes first, and holds at least one value; truncated and nextCursor are set when more follow."