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

# Add Collection Mosaic

`POST /stac/collections/{collectionId}/configurations/mosaics`

Add a mosaic definition to a given collection

## Path parameters

- `collectionId` 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 `201`

The request has succeeded and a new resource has been created as a result.

- 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.

---

[API](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/versions/42447be18bc5/schema)