From b4fad1be0af07bd76af71c8e3ab43e5bd7f4244a Mon Sep 17 00:00:00 2001 From: Mofei Zhu Date: Mon, 5 Oct 2026 15:52:18 +0300 Subject: [PATCH 1/2] Note that search --exclude-fields only applies to some accounts photos and reviews are only returned for accounts with a specific data provider arrangement, so for everyone else the flag has no effect. Say so in the spec and in docs/commands.md rather than implying the fields are always there to exclude. --- custom-openapi/search/openapi/search.yaml | 6 ++++++ docs/commands.md | 4 ++-- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/custom-openapi/search/openapi/search.yaml b/custom-openapi/search/openapi/search.yaml index 18a62e4..eaea8ff 100644 --- a/custom-openapi/search/openapi/search.yaml +++ b/custom-openapi/search/openapi/search.yaml @@ -180,6 +180,9 @@ paths: description: >- A comma-separated list of metadata fields to omit from the response, to reduce payload size. Accepts `photos`, `reviews`. + Only applies to accounts with a specific data provider + arrangement; other responses do not include these fields, so + the parameter has no effect on them. schema: type: string - name: "rank_strategy" @@ -470,6 +473,9 @@ paths: description: >- A comma-separated list of metadata fields to omit from the response, to reduce payload size. Accepts `photos`, `reviews`. + Only applies to accounts with a specific data provider + arrangement; other responses do not include these fields, so + the parameter has no effect on them. schema: type: string - name: "sar_type" diff --git a/docs/commands.md b/docs/commands.md index c3098a9..d6bc669 100644 --- a/docs/commands.md +++ b/docs/commands.md @@ -1234,7 +1234,7 @@ session behind it. | `--poi-category ` / `--poi-category-exclusions ` | Include or exclude POI categories. | | `--show-closed-pois` / `--open-now` | Include closed POIs, or only currently-open ones. | | `--minimum-rating <0.0-5.0>` / `--price-levels <$..$$$$>` | Filter POIs by rating or price. | -| `--exclude-fields ` | Omit metadata fields from the response, e.g. `photos,reviews`. | +| `--exclude-fields ` | Omit metadata fields from the response, e.g. `photos,reviews`. Only applies to accounts with a specific data provider arrangement; otherwise these fields are never returned and the flag has no effect. | | `--rank-strategy ` | Change how results are ordered. | | `--language ` | ISO language code. | | `--auto-complete` | Include partial and fuzzy matches, for autocomplete-style input. | @@ -1350,7 +1350,7 @@ here enforces it before the request goes out. | `--types ` | `poi`, `address`, `place`, … | | `--poi-category-exclusions ` | Exclude POI categories. | | `--show-closed-pois` | Include permanently closed POIs. | -| `--exclude-fields ` | Omit metadata fields from the response, e.g. `photos,reviews`. | +| `--exclude-fields ` | Omit metadata fields from the response, e.g. `photos,reviews`. Only applies to accounts with a specific data provider arrangement; otherwise these fields are never returned and the flag has no effect. | | `--language ` | ISO language code. | | `--sar-type isochrone` + `--route ` + `--route-geometry ` | Search-along-route: results near a route rather than a point. | | `--time-deviation ` | With SAR, maximum detour allowed from the route. | From 3e25424ee1c145bd3c047c33a75820ae50ecfd76 Mon Sep 17 00:00:00 2001 From: Mofei Zhu Date: Mon, 5 Oct 2026 15:54:35 +0300 Subject: [PATCH 2/2] Remove --exclude-fields from search forward and search category The photos and reviews fields it omitted are only returned for accounts with a specific data provider arrangement, so for everyone else the flag never had an effect. Drop it rather than document a parameter that does nothing for most users. --- CHANGELOG.md | 7 +++++++ custom-openapi/search/openapi/search.yaml | 22 ---------------------- docs/commands.md | 2 -- 3 files changed, 7 insertions(+), 24 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d0bbaa6..410b98b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -19,6 +19,13 @@ that may never merge. They are not releases and are not listed here. ## Unreleased +- **Breaking**: `--exclude-fields` removed from `mapbox search forward` + and `mapbox search category`. The `photos` and `reviews` fields it + omitted are only returned for accounts with a specific data provider + arrangement, so for everyone else it never had an effect. A script that + passes it now fails with an unknown-argument error; drop the flag. + (#77) + - `mapbox mcp list`/`mapbox mcp install`: registers a Mapbox MCP server (direct tool-calling access to Mapbox's APIs, not just guidance about them) with a coding agent's own CLI or config. Claude Code, Codex, VS Code diff --git a/custom-openapi/search/openapi/search.yaml b/custom-openapi/search/openapi/search.yaml index eaea8ff..69ad746 100644 --- a/custom-openapi/search/openapi/search.yaml +++ b/custom-openapi/search/openapi/search.yaml @@ -174,17 +174,6 @@ paths: schema: type: string example: "$,$$" - - name: "exclude_fields" - in: query - required: false - description: >- - A comma-separated list of metadata fields to omit from the - response, to reduce payload size. Accepts `photos`, `reviews`. - Only applies to accounts with a specific data provider - arrangement; other responses do not include these fields, so - the parameter has no effect on them. - schema: - type: string - name: "rank_strategy" in: query required: false @@ -467,17 +456,6 @@ paths: Excluded by default. schema: type: boolean - - name: "exclude_fields" - in: query - required: false - description: >- - A comma-separated list of metadata fields to omit from the - response, to reduce payload size. Accepts `photos`, `reviews`. - Only applies to accounts with a specific data provider - arrangement; other responses do not include these fields, so - the parameter has no effect on them. - schema: - type: string - name: "sar_type" in: query required: false diff --git a/docs/commands.md b/docs/commands.md index d6bc669..bcd9c34 100644 --- a/docs/commands.md +++ b/docs/commands.md @@ -1234,7 +1234,6 @@ session behind it. | `--poi-category ` / `--poi-category-exclusions ` | Include or exclude POI categories. | | `--show-closed-pois` / `--open-now` | Include closed POIs, or only currently-open ones. | | `--minimum-rating <0.0-5.0>` / `--price-levels <$..$$$$>` | Filter POIs by rating or price. | -| `--exclude-fields ` | Omit metadata fields from the response, e.g. `photos,reviews`. Only applies to accounts with a specific data provider arrangement; otherwise these fields are never returned and the flag has no effect. | | `--rank-strategy ` | Change how results are ordered. | | `--language ` | ISO language code. | | `--auto-complete` | Include partial and fuzzy matches, for autocomplete-style input. | @@ -1350,7 +1349,6 @@ here enforces it before the request goes out. | `--types ` | `poi`, `address`, `place`, … | | `--poi-category-exclusions ` | Exclude POI categories. | | `--show-closed-pois` | Include permanently closed POIs. | -| `--exclude-fields ` | Omit metadata fields from the response, e.g. `photos,reviews`. Only applies to accounts with a specific data provider arrangement; otherwise these fields are never returned and the flag has no effect. | | `--language ` | ISO language code. | | `--sar-type isochrone` + `--route ` + `--route-geometry ` | Search-along-route: results near a route rather than a point. | | `--time-deviation ` | With SAR, maximum detour allowed from the route. |