<!-- Source: https://docs.geopera.com/api-reference/operations/mosaic · Markdown for LLMs -->

<!-- AUTO-GENERATED by scripts/generate-api-reference.cjs from the committed OpenAPI spec. Do not edit by hand. -->

# Mosaic operations

Each operation below is reachable at `POST /v1/op/{operation_id}` or the resource path `POST /v1/{resource}/{action}`, with a Bearer token (a `gpra_` API key or a session token). Back to the [Operations Reference](/api-reference/operations) index.

## `mosaic.register`

Register a pipeline-produced mosaic as a first-class STAC item with provenance.

| | |
|---|---|
| **Scope** | `items:write` |
| **Side-effect** | compute |
| **HTTP** | `POST /v1/op/mosaic.register`  ·  `POST /v1/mosaic/register` |
| **Python / TypeScript** | `client.mosaic.register(…)` |
| **CLI** | `geopera mosaic register …` |

**Request** — `MosaicRegisterInput`

| Field | Type | Required | Description |
|---|---|---|---|
| `project_id` | string | yes |  |
| `name` | string | yes |  |
| `stac_id` | string | — | Sets the STAC Feature id; otherwise one is generated. |
| `geometry` | object | — |  |
| `bbox` | array of number | — |  |
| `datetime` | string | — |  |
| `start_datetime` | string | — |  |
| `end_datetime` | string | — |  |
| `mosaic_method` | string | — | Compositing method (e.g. brightest, median, first). |
| `data_asset` | MosaicAsset | yes | The mosaic COG (referenced by href, not copied). |
| `provenance_asset` | MosaicAsset | — | Per-pixel source-index band. |
| `source_lookup` | array of MosaicSourceScene | — | Integer-to-scene lookup; inlined as classification:classes for 256 or fewer scenes. |
| `source_lookup_asset` | MosaicAsset | — | Sidecar lookup asset, used instead of inline when the list is large. |
| `manifest_asset` | MosaicAsset | — | STAC-GeoParquet contributing-scene manifest sidecar. |
| `source_collections` | array of string | — | Summary lineage; projected as derived_from links. |
| `collection_id` | string | — |  |
| `properties` | object | — |  |

**Response** — `IngestResult`.