---
title: "Update Collection Mosaic"
method: PUT
path: "/stac/collections/{collectionId}/configurations/mosaics/{mosaicId}"
tags: ["STAC Collection Configuration"]
---

# Update Collection Mosaic

`PUT /stac/collections/{collectionId}/configurations/mosaics/{mosaicId}`

## Request

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

Update a mosaic definition from a given collection

## Path parameters

- `collectionId` string, required
- `mosaicId` string, required

## Query parameters

- `api-version` string, required

## Request body

- StacMosaic: Defines a named mosaic with filtering criteria.
  - `id` string, required: Unique identifier for the mosaic.
  - `name` string, required: Short descriptive name for the mosaic.
  - `description` string: Detailed description of the mosaic.
  - `cql` object[], required: A list of valid CQL2-JSON expressions used to filter the collection to moasic.

## Response `200`

The request has succeeded.

- StacMosaic: Defines a named mosaic with filtering criteria.
  - `id` string, required: Unique identifier for the mosaic.
  - `name` string, required: Short descriptive name for the mosaic.
  - `description` string: Detailed description of the mosaic.
  - `cql` object[], required: A list of valid CQL2-JSON expressions used to filter the collection to moasic.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-02-19** (2025-04-30-preview) `28e8cb365289`: 1 breaking, 1 info
  - removed the success response with the status `201`
  - api operation id `StacCollectionMosaics_CreateOrReplace` removed and replaced with `StacCollectionMosaics_Replace`
- **2025-05-15** (2025-04-30-preview) `00cbc3d6d8e0`: 2 info
  - api operation id `StacCollectionMosaics_Replace` removed and replaced with `StacCollectionMosaics_CreateOrReplace`
  - added the success response with the status `201`

[Operation history](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/changes/stac/collections/:collectionId/configurations/mosaics/:mosaicId/put.md)

---

[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)