---
title: "Update Collection Tile Settings"
method: PUT
path: "/stac/collections/{collectionId}/configurations/tile-settings"
tags: ["STAC Collection Configuration"]
---

# Update Collection Tile Settings

`PUT /stac/collections/{collectionId}/configurations/tile-settings`

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/stac/collections/{collectionId}/configurations/tile-settings`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `https://geocatalog.spatio.azure.com/.default`

Update the tile settings for a given collection

## Path parameters

- `collectionId` string, required

## Query parameters

- `api-version` string, required

## Request body

- TileSettings: Configuration for map tile visualization.
  - `minZoom` integer, required: The minimum zoom level that can be requested for this collection. Provides a hard limit for the tile servers to ensure they don't get requests for low zoom levels, which would cause many files to be fetched and the tile servers to hang.
  - `maxItemsPerTile` integer, required: Maximum number of items to include in a single tile.
  - `defaultLocation` DefaultLocation: Defines a default geographic location for map visualization.
    - `zoom` integer, required: Default zoom level for the map.
    - `coordinates` number[], required: Default center coordinates [latitude, longitude] for the map.

## Response `200`

The request has succeeded.

- TileSettings: Configuration for map tile visualization.
  - `minZoom` integer, required: The minimum zoom level that can be requested for this collection. Provides a hard limit for the tile servers to ensure they don't get requests for low zoom levels, which would cause many files to be fetched and the tile servers to hang.
  - `maxItemsPerTile` integer, required: Maximum number of items to include in a single tile.
  - `defaultLocation` DefaultLocation: Defines a default geographic location for map visualization.
    - `zoom` integer, required: Default zoom level for the map.
    - `coordinates` number[], required: Default center coordinates [latitude, longitude] for the map.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer.md) - [All operations](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/revisions/42447be18bc5?raw)
