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

`mosaic.register`


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.