STAC operations
STAC-compliant item and search endpoints.
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.
stac.collections.list
List STAC Collections owned by the caller’s organization (provider-compatible).
| Scope | items:read |
| Side-effect | read |
| HTTP | POST /v1/op/stac.collections.list · POST /v1/stac/collections/list |
| Python / TypeScript | client.stac.collections.list(…) |
| CLI | geopera stac collections list … |
Request — src__operations__stac__reads__CollectionsListInput
| Field | Type | Required | Description |
|---|---|---|---|
base_url | string | — |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.
stac.search
Cross-collection STAC search (CQL2-JSON / bbox / intersects), org-scoped.
| Scope | items:read |
| Side-effect | read |
| HTTP | POST /v1/op/stac.search · POST /v1/stac/search |
| Python / TypeScript | client.stac.search(…) |
| CLI | geopera stac search … |
Request — SearchInput
| Field | Type | Required | Description |
|---|---|---|---|
base_url | string | — | |
collections | array of string | — | |
ids | array of string | — | |
datetime | string | — | |
sortby | array of SortClause | — | |
limit | integer | — | |
page | integer | — | |
filter | object | — | |
filter-lang | string | — | |
bbox | array of number | — | |
intersects | object | — |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.