Skip to main content

Maps service changelog

Vector Tiles API

Mar 7, 2023

  • Removed sortby parameter from list styles endpoint in Styles documentation

Jan 23, 2023

  • Removed beta flag from MTS API

Oct 31, 2022

  • Updated tileset ID's wording in MTS documentation

July 14, 2022

  • Documented the Vector Tiles API's default cache headers and linked to new troubleshooting page with tips on working with caching.

May 4, 2022

Jun 4, 2021

  • Documented the Vector Tiles API's cache behavior when compositing multiple tileset IDs.

May 22, 2019

  • The endpoint that serves vector tiles generated from Mapbox Studio styles is now the Vector Tiles API.

October 28, 2016

  • Document .mvt extension for vector tiles, over .vector.pbf.

Raster Tiles API

July 14, 2022

  • Documented the Raster Tiles API's default cache headers and linked to new troubleshooting page with tips on working with caching.

Jun 4, 2021

  • Documented the Raster Tiles API's cache behavior when compositing multiple tileset IDs.

May 22, 2019

  • The endpoint that serves raster tiles generated from satellite imagery tilesets and tilesets generated from raster data uploaded to Mapbox.com is now the Raster Tiles API.

August 3, 2016

  • Specifies that map tiles including mapbox.satellite are delivered as JPEG regardless of requested format.

Static Images API

July 14, 2022

July 20, 2021

  • Updated the maximum zoom value from 20 to 22.

April 16, 2021

  • Updated the rate limit for the Static Images API from 1,200 to 1,250 requests per minute.

February 24, 2021

  • Added 422: Overlay bounds are out of range. HTTP response code to Static Images API.

December 10, 2020

  • Added documentation for requesting a static image using a bounding box with the Static Images API.

November 12, 2020

  • Added documentation for using the optional padding parameter with the Static Images API.

October 29, 2020

  • Added 422: invalid style source HTTP response code to the Static Images API to denote that styles will fail if the underlying source contains invalid values.

November 13, 2019

November 12, 2019

October 17, 2019

September 27, 2019

September 25, 2019

  • Updated the rate limit for the Static Images API from 600 requests per minute to 1,200 requests per minute.

August 5, 2019

  • Updated the Static Images API to reflect the fact that if the referenced style contains raster sources, the returned file will be a JPEG rather than a PNG.

May 22, 2019

  • The endpoint that serves static map images generated from vector map styles is now the Static Images API.

April 10, 2017

March 14, 2017

  • Added documentation for styling stroke width for encoded polyline static requests.

February 23, 2017

  • Added documentation for the Static API with overlays.

August 8, 2016

  • Corrected the maximum size of a custom icon placed on a static map.

April 5, 2016

  • Reiterates that even with the attribution=false option, attribution is required for static maps that include OpenStreetMap data.

Static Tiles API

July 14, 2022

July 20, 2021

  • Updated the maximum zoom value from 20 to 22.

April 16, 2021

  • Updated the rate limit for the Static Tiles API from 5,000 to 6,000 requests per minute.

February 18, 2021

  • Noted that the Static Tiles API will return a PNG if the queried tileset contains only vector layers.

October 29, 2020

  • Added 422: invalid style source HTTP response code to the Static Tiles API to denote that styles will fail if the underlying source contains invalid values.

September 25, 2019

  • Updated the rate limit for the Static Images API from 600 requests per minute to 1,200 requests per minute.

May 22, 2019

  • The endpoint that serves raster tiles generated from Mapbox Studio styles is now the Static Tiles API.

Styles API

November 29, 2023

  • Added the standard GA endpoint for Mapbox Standard and removed the standard-beta endpoint

August 2, 2023

  • Added the standard-beta endpoint for Mapbox Standard

July 14, 2022

  • Documented the Styles API's default cache headers and linked to new troubleshooting page with tips on working with caching.

January 11, 2022

  • Added documentation for the new Protected endpoint.

August 3, 2021

  • Updated the description for the Request embeddable HTML endpoint's optional hash parameter to show that it can also accept values for bearing and pitch.

May 19, 2021

January 5, 2021

December 11, 2020

October 29, 2020

  • Updated the Styles API documentation to include information about how to access immutable, versioned sprites.
  • Included note about supporting decimal values of scaled sprite displays.
  • Added 422: invalid style source HTTP response code to the Static Images API and Static Tiles API to denote that styles will fail if the underlying source contains invalid values.

August 6, 2020

August 5, 2020

  • Added note about sprite optimization in Styles API.

June 11, 2020

February 6, 2020

  • Removed metadata parameter documentation for the GET style endpoint: Styles API.

January 30, 2020

  • Increase limit of images per sprite from 500 to 1,000: Styles API.
  • Documented metadata parameter of the GET style endpoint: Styles API.

August 28, 2019

July 25, 2019

  • Updated Styles API to show parameters for mapboxGLVersion and mapboxGLGeocoderVersion.

June 26, 2019

May 23, 2019

  • Updated Styles API to show parameter for draft style.

August 24, 2018

August 24, 2017

  • Removed traffic-day-v2 and traffic-night-v2 from the list of available Mapbox styles in the Styles API.
  • Added navigation-preview-day-v2, navigation-preview-night-v2, navigation-guidance-day-v2, and navigation-guidance-night-v2 to the list of available Mapbox styles in the Styles API.

May 16, 2017

  • Updated the Styles API documentation with URLs to the Mapbox Streets v10, Mapbox Outdoors v10, and Mapbox Satellite Streets v10 styles.

April 11, 2017

July 18, 2016

  • Restore listing endpoint for styles.

July 11, 2016

  • Removed documentation for listing endpoint for styles.

June 20, 2016

  • Added documentation for the new OGC WMTS endpoint for maps.

May 10, 2016

  • Update the Styles API section with latest v9 styles, remove basic and bright styles from documentation.

Tilequery API

Mar 13, 2024

July 14, 2022

  • Documented the Tilequery API's default cache headers and linked to new troubleshooting page with tips on working with caching.

Jun 4, 2021

  • Documented the Tilequery API's cache behavior when compositing multiple tileset IDs.

April 24, 2018

Uploads API

January 25, 2021

  • Removed the private property from the Uploads API since this is not an allowed property right now.

October 2, 2020

November 5, 2019

December 7, 2017

  • Added character limit notes to tileset and name parameters in the Uploads API create endpoint.

May 9, 2017

  • Added a POST request endpoint to Uploads API credentials POST /uploads/v1/{username}/credentials and updated documentation. GET requests will still work.

March 4, 2016

  • Increased public Upload limits

Mapbox Tiling Service

June 21, 2023

October 26, 2022

  • Under Restrictions and limits, reduced MTS read rate limit from 100,000 to 3,000. Updated Delete a tileset with MTS write rate limit.

Aug 19, 2022

  • Make the use of tileset_id, tilesets, tileset_name, id more consistent.

July 14, 2022

January 19, 2021

  • Added accept_invalid_sources as an optional parameter to the Mapbox Tiling Service Validate a recipe endpoint.

December 20, 2020

December 11, 2020

September 14, 2020

  • Updated the Mapbox Tiling Service List tilesets endpoint to have a maximum limit value of 100 instead of 500.

August 17, 2020

August 5, 2020

July 31, 2020

  • Added Mapbox Tiling Services PUT endpoint for replacing a tileset's source data.

June 22, 2020

June 11, 2020

May 28, 2020

  • The Tilesets API has a new name! It's now called Mapbox Tiling Service (MTS). The endpoints that you use to access MTS have not changed, and still follow the format /tilesets/v1/.

May 7, 2020

  • Documented new Tilesets API PATCH endpoint for updating tileset information, such as name, description, private, and attribution.

April 16, 2020

April 2, 2020

  • Changed the response for deleting tileset source from 201 to 204 in Tilesets API.

February 20, 2020

  • Limited the GET sources endpoint in the Tilesets API to 2000 results.

February 17, 2020

  • Changed the response of the GET status endpoint in the Tilesets API. Users relying on the last_completed_job, success, failed, queued, or processing attributes should update their applications to use latest_job and status.

February 03, 2020

  • Updated the rate-limits for various end-points associated with tilesets endpoints.
  • Fixed an invalid URL warning found during unit test

November 5, 2019

  • Updated the existing private property in the Tilesets API, which is now available to all Mapbox users and true by default.

September 24, 2019

August 26, 2019

August 1, 2019

June 5, 2019

  • Moved the Retrieve TileJSON metadata endpoint from the Maps API documentation to the Tilesets API documentation to better reflect the fact that TileJSON describes a tileset.

February 1, 2019

January 13, 2017

  • Document Tilesets API

Datasets API

July 14, 2022

  • Documented the Datasets API's default cache headers and linked to new troubleshooting page with tips on working with caching.

May 13, 2020

  • Documented new Datasets API sortby query parameter on the list endpoint, which allows you to sort by modified or created (default) dates.

November 2, 2016

  • Removed preview label for Datasets API.

October 17, 2016

  • Removed documentation for the bulk write endpoint for datasets.

September 8, 2016

  • Update Datasets listing endpoint scope to be datasets:list, instead of datasets:read

August 1, 2016

  • Specifies that the feature endpoint of the Datasets API does not yet support GeometryCollection geometries or features without geometries.

March 30, 2016

  • Fixes documentation for the Datasets API batch endpoint: the URL ends with /features and is a POST endpoint, not a PUT endpoint as written earlier.

Fonts API

July 14, 2022

  • Documented the Fonts API's default cache headers and linked to new troubleshooting page with tips on working with caching.

November 4, 2020

  • Added documentation for retrieving font metadata using the Fonts API.

October 30, 2020

  • Added documentation for updating font metadata using the Fonts API.

August 13, 2020

  • Added documentation for font deletion to the Fonts API.

January 8, 2020

Mapbox Standard Style

January 24, 2024

  • Fixed bugs for golf holes label layer styling issue, turning feature outline layer order and improved tunnel styling