GET /ogc/features/
Get OGC API Features landing page
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Landing page information
Provenance: this reference is generated from the live demo server's published OpenAPI documents — trunk, not a versioned release. Documents were fetched from demo.honua.io/docs ↗ (the live API console) on 2026-08-10 (UTC); every document reports info.version 1.0.0. Endpoints can change as trunk moves — the console and the raw documents linked below are always current, this page is a dated snapshot.
Honua publishes 8 OpenAPI documents, one per protocol surface. The six OGC and STAC documents are rendered in full below: 68 operations across 62 paths, each with its parameters, request body, and response codes. The Server Management API document is larger (395 operations across 319 paths), so it is summarized: every operation appears with its method, path, and summary, grouped by tag — parameter and schema detail for those lives in the raw document and the live console. Nothing is omitted from the endpoint listings; only the admin parameter tables are.
| Document | Base path | Version | Operations | On this page | Raw document |
|---|---|---|---|---|---|
| OGC API Features | /ogc/features | 1.0.0 | 19 | Full: parameters, bodies, responses | openapi.json ↗ |
| OGC API Coverages | /ogc/coverages | 1.0.0 | 8 | Full: parameters, bodies, responses | openapi.json ↗ |
| OGC API Tiles | /ogc/tiles | 1.0.0 | 13 | Full: parameters, bodies, responses | openapi.json ↗ |
| OGC API Maps | /ogc/maps | 1.0.0 | 8 | Full: parameters, bodies, responses | openapi.json ↗ |
| OGC API Styles | /ogc/styles | 1.0.0 | 0 | No operations published | openapi.json ↗ |
| OGC API Processes | /ogc/processes | 1.0.0 | 10 | Full: parameters, bodies, responses | openapi.json ↗ |
| STAC API | /stac | 1.0.0 | 10 | Full: parameters, bodies, responses | openapi.json ↗ |
| Server Management API (admin) | /api/v1/admin | 1.0.0 | 395 | Summary: method, path, summary | openapi.json ↗ |
source: https://demo.honua.io/docs · fetched 2026-08-10 UTC · base URL for every example: https://demo.honua.io
Each section starts with the server-reported document description, the base URL, and one runnable request against the public demo server. No authentication is required for the read paths shown in the examples; transactional operations (create, update, delete) require credentials on the demo server.
OGC API Features implementation for geospatial data access. Mounted at https://demo.honua.io/ogc/features · document version 1.0.0 · raw OpenAPI document ↗
curl -sS "https://demo.honua.io/ogc/features/collections?f=json"
/ogc/features/Get OGC API Features landing page
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Landing page information
/ogc/features/apiGet OpenAPI 3.0 specification for OGC API Features
No parameters.
Responses 200 OpenAPI specification document · 404 Specification not found
/ogc/features/schemas/honua-ogcapi-features.xsdGet OGC API Features GML application schema
No parameters.
Responses 200 GML application schema
/ogc/features/conformanceGet OGC API Features conformance declaration
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Conformance declaration
/ogc/features/collectionsGet OGC API Features collections
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Collections list
/ogc/features/collections/{collectionId}/itemsGet features from a collection
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
f | query | no | string (enum: json, geojson, gml, xml, csv, html) | Output format (json, geojson, gml, xml, csv, or html) |
limit | query | no | integer (default 1000; 1–2000) | Maximum number of features to return |
offset | query | no | integer (min 0) | Number of features to skip |
bbox | query | no | array<number> | Bounding box filter (minx,miny,maxx,maxy or minx,miny,minz,maxx,maxy,maxz) |
bbox-crs | query | no | string (uri) | CRS for the bbox coordinates |
crs | query | no | string (uri) | Coordinate reference system URI for response geometry |
datetime | query | no | string | Temporal filter (RFC 3339 instant or interval) |
filter | query | no | string | CQL2 filter expression |
filter-lang | query | no | string (enum: cql2-text, cql2-json) | Filter language (default cql2-text) |
filter-crs | query | no | string (uri) | CRS for filter geometries |
Responses 200 FeatureCollection · 400 Invalid request · 404 Collection not found
/ogc/features/collections/{collectionId}/itemsCreate a new feature in a collection
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
Content-Crs | header | no | string (uri) | Coordinate reference system URI for request geometry. Must be one of the collection-advertised CRSs. |
Request body application/geo+json, application/json (required) · GeoJsonFeature
Responses 201 Feature created · 400 Invalid request · 401 Authentication required · 403 Authenticated caller is not authorized to create features in this collection · 404 Collection not found · 409 Conflict
/ogc/features/collections/{collectionId}/items/batchExecute batch feature operations
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
Content-Crs | header | no | string (uri) | Coordinate reference system URI applied to every GeoJSON feature in the batch payload. Must be one of the collection-advertised CRSs. |
Request body application/json (required) · BatchRequest
Responses 200 Batch operation completed · 207 Batch operation completed with mixed results · 400 Invalid request · 401 Authentication required · 403 Authenticated caller is not authorized to modify this collection · 404 Collection not found
/ogc/features/collections/{collectionId}Get OGC API Features collection metadata
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Collection metadata · 404 Collection not found
/ogc/features/collections/{collectionId}/queryablesGet queryable properties for a collection
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
f | query | no | string (enum: json, schemajson, schema+json, html) | Output format (json, schemajson, schema+json, or html) |
Responses 200 Queryables schema · 404 Collection not found
/ogc/features/collections/{collectionId}/items/{featureId}Get a specific feature from a collection
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
featureId | path | yes | string | Feature identifier |
f | query | no | string (enum: json, geojson, gml, xml, csv, html) | Output format (json, geojson, gml, xml, csv, or html) |
crs | query | no | string (uri) | Coordinate reference system URI for response geometry |
Responses 200 Feature · 404 Feature not found
/ogc/features/collections/{collectionId}/items/{featureId}Update an existing feature
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
featureId | path | yes | string | Feature identifier |
Content-Crs | header | no | string (uri) | Coordinate reference system URI for request geometry. Must be one of the collection-advertised CRSs. |
If-Match | header | no | string | Strong ETag from a prior GET item response for optimistic concurrency control. |
Request body application/geo+json, application/json (required) · GeoJsonFeature
Responses 200 Feature updated · 400 Invalid request · 401 Authentication required · 403 Authenticated caller is not authorized to replace this feature · 404 Feature not found · 412 ETag precondition failed - the feature has been modified since the provided ETag
/ogc/features/collections/{collectionId}/items/{featureId}Partially update an existing feature
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
featureId | path | yes | string | Feature identifier |
Content-Crs | header | no | string (uri) | Coordinate reference system URI for request geometry. Must be one of the collection-advertised CRSs. |
If-Match | header | no | string | Strong ETag from a prior GET item response for optimistic concurrency control. |
Request body application/geo+json, application/json, application/merge-patch+json (required) · GeoJsonFeature
Responses 200 Feature updated · 400 Invalid request · 401 Authentication required · 403 Authenticated caller is not authorized to patch this feature · 404 Feature not found · 412 ETag precondition failed - the feature has been modified since the provided ETag
/ogc/features/collections/{collectionId}/items/{featureId}Delete a feature from a collection
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
featureId | path | yes | string | Feature identifier |
Responses 204 Feature deleted · 400 Invalid request · 401 Authentication required · 403 Authenticated caller is not authorized to delete this feature · 404 Feature not found
/ogc/features/collections/{collectionId}/h3H3 hexagonal grid aggregation for a collection
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
resolution | query | yes | integer (0–15) | H3 resolution level (0-15) |
Responses 200 H3 aggregation as GeoJSON FeatureCollection · 400 Invalid parameters · 404 Collection not found · 501 H3 extension not available — the h3-pg PostgreSQL extension is not installed · 503 H3 capability check failed — the database may be temporarily unreachable
/ogc/features/collections/{collectionId}/clustersSpatial clustering for a collection (Pro)
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
Request body application/json (required) — Clustering request payload (algorithm, parameters, and optional shared filters)
Responses 200 Cluster assignments or hulls as GeoJSON FeatureCollection · 400 Invalid clustering parameters or filter syntax · 402 Pro-tier license required · 404 Collection not found · 501 Spatial analytics backend not available — the active feature-store provider does not ship a spatial analytics reader (for example, the DuckDB read-only provider). Permanent condition until providers are switched; not a transient failure.
/ogc/features/collections/{collectionId}/spatial-joinSpatial join against a target collection (Pro)
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Source (target) collection identifier |
Request body application/json (required) — Spatial join request payload (join layer id, predicate, optional distance, carry fields, outStatistics, and shared filters)
Responses 200 Joined features as GeoJSON FeatureCollection · 400 Invalid join parameters · 402 Pro-tier license required · 404 Collection not found · 501 Spatial analytics backend not available — the active feature-store provider does not ship a spatial analytics reader (for example, the DuckDB read-only provider). Permanent condition until providers are switched; not a transient failure.
/ogc/features/collections/{collectionId}/buffer-aggregateBuffer + aggregate for a collection (Pro)
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
Request body application/json (required) — Buffer aggregate request payload (distance, unit, dissolve flag, optional groupByFields, outStatistics, and shared filters)
Responses 200 Buffered features as GeoJSON FeatureCollection · 400 Invalid buffer parameters · 402 Pro-tier license required · 404 Collection not found · 501 Spatial analytics backend not available — the active feature-store provider does not ship a spatial analytics reader (for example, the DuckDB read-only provider). Permanent condition until providers are switched; not a transient failure.
/ogc/features/collections/{collectionId}/densityDensity binning for a collection (Pro)
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | Collection identifier |
Request body application/json (required) — Density request payload (grid mode, cell size, optional weight field, and shared filters)
Responses 200 Density bins as GeoJSON FeatureCollection · 400 Invalid density parameters · 402 Pro-tier license required · 404 Collection not found · 501 Spatial analytics backend not available — the active feature-store provider does not ship a spatial analytics reader (for example, the DuckDB read-only provider). Permanent condition until providers are switched; not a transient failure.
OGC API Coverages implementation for raster coverage discovery, schema metadata, and coverage retrieval. Mounted at https://demo.honua.io/ogc/coverages · document version 1.0.0 · raw OpenAPI document ↗
curl -sS "https://demo.honua.io/ogc/coverages/collections"
/ogc/coverages/Landing page
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Metadata representation. Defaults to JSON when no explicit format or Accept header is supplied. |
Responses 200 Landing page
/ogc/coverages/conformanceConformance declaration
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Metadata representation. Defaults to JSON when no explicit format or Accept header is supplied. |
Responses 200 Conformance classes
/ogc/coverages/apiOpenAPI document
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json) | OpenAPI document representation. Defaults to application/vnd.oai.openapi+json;version=3.0. |
Responses 200 OpenAPI document
/ogc/coverages/openapi.jsonOpenAPI document
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json) | OpenAPI document representation. Defaults to application/vnd.oai.openapi+json;version=3.0. |
Responses 200 OpenAPI document
/ogc/coverages/collectionsList coverage collections
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Metadata representation. Defaults to JSON when no explicit format or Accept header is supplied. |
Responses 200 Accessible raster coverage collections · 400 · 500
/ogc/coverages/collections/{collectionId}Get coverage collection metadata
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | |
f | query | no | string (enum: json, html) | Metadata representation. Defaults to JSON when no explicit format or Accept header is supplied. |
Responses 200 Coverage collection metadata · 400 · 404 · 500
/ogc/coverages/collections/{collectionId}/schemaGet coverage schema
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | |
f | query | no | string (enum: json, html) | Metadata representation. Defaults to JSON when no explicit format or Accept header is supplied. |
Responses 200 Coverage field-selection schema · 400 · 404 · 500
/ogc/coverages/collections/{collectionId}/coverageGet coverage data
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | |
bbox | query | no | string | Spatial subset as xmin,ymin,xmax,ymax. Coordinates are CRS84 unless bbox-crs is supplied; geographic antimeridian crossings are represented with east/west clip polygons. |
bbox-crs | query | no | string | CRS identifier for bbox coordinates. Must resolve to one of the collection's advertised CRS identifiers. |
crs | query | no | string | Output CRS identifier. Must resolve to one of the collection's advertised CRS identifiers. |
properties | query | no | string | Comma-separated band fields, for example band_1,band_3. |
resolution | query | no | string | Positive native/storage CRS pixel size as one value or width,height. Maps to RasterQuery.PixelSize before output reprojection. The derived output must not exceed 8192 pixels on either axis, checked in storage CRS against the requested bbox when supplied and otherwise against coverage extent or native grid metadata. |
scale-factor | query | no | number | Positive multiplier for the native pixel size. The derived output must not exceed 8192 pixels on either axis, checked in storage CRS against the requested bbox when supplied and otherwise against coverage extent or native grid metadata. |
scale-size | query | no | string | Output size as width,height or axis-size pairs such as x(512),y(512), with each axis from 1 through 8192 pixels. |
f | query | no | string (enum: geotiff, tiff, tif, image/tiff, png, image/png) | Coverage encoding. Defaults to GeoTIFF when no explicit format or Accept header is supplied. |
Responses 200 Coverage payload · 400 · 404 · 406 · 500
OGC API Tiles implementation for vector tiles. Mounted at https://demo.honua.io/ogc/tiles · document version 1.0.0 · raw OpenAPI document ↗
curl -sS "https://demo.honua.io/ogc/tiles/tileMatrixSets"
/ogc/tiles/Landing page
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Landing page information
/ogc/tiles/conformanceConformance declaration
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Conformance declaration
/ogc/tiles/openapi.jsonOpenAPI specification
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json) | Output format (json) |
Responses 200 OpenAPI document
/ogc/tiles/collectionsCollections list
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Collections list · 401 Authentication required to access the available collections · 403 Available collections are not accessible
/ogc/tiles/collections/{collectionId}Collection metadata
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | integer (min 0) | |
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Collection metadata · 400 Invalid collection metadata query parameters · 401 Authentication required for the requested collection · 403 Requested collection is not accessible · 404 Not found · 406 Requested metadata format is not acceptable
/ogc/tiles/tilesDataset tilesets list
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Tilesets list · 400 Invalid tilesets query parameters · 401 Authentication required to access the available dataset tilesets · 403 Available dataset tilesets are not accessible · 406 Requested metadata format is not acceptable
/ogc/tiles/tiles/{tileMatrixSetId}Dataset tileset metadata
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
tileMatrixSetId | path | yes | string | |
f | query | no | string (enum: json, html) | Output format (json or html) |
collections | query | no | array<string> | Comma-separated collection identifiers |
Responses 200 Tileset metadata · 400 Invalid tileset query parameters · 401 Authentication required to access the requested dataset tileset · 403 Requested dataset tileset is not accessible · 404 Not found · 406 Requested metadata format is not acceptable
/ogc/tiles/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}Dataset tile
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
tileMatrixSetId | path | yes | string | |
tileMatrix | path | yes | string | |
tileRow | path | yes | integer (min 0) | |
tileCol | path | yes | integer (min 0) | |
f | query | no | string (enum: mvt, png) | Tile format (mvt or png) |
datetime | query | no | string | |
subset | query | no | string | |
crs | query | no | string (uri) | |
subset-crs | query | no | string (uri) | |
collections | query | no | array<string> | Comma-separated collection identifiers |
Responses 200 Vector or raster tile · 204 No content · 400 Invalid tile matrix, tile coordinates, or query parameters · 401 Authentication required for at least one requested collection · 403 Requested collections are not accessible · 404 Tile matrix set or requested collections not found · 406 Requested tile format is not acceptable
/ogc/tiles/collections/{collectionId}/tilesCollection tilesets list
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | integer (min 0) | |
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Tilesets list · 400 Invalid collection tilesets query parameters · 401 Authentication required for the requested collection · 403 Requested collection is not accessible · 404 Not found · 406 Requested metadata format is not acceptable
/ogc/tiles/collections/{collectionId}/tiles/{tileMatrixSetId}Collection tileset metadata
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | integer (min 0) | |
tileMatrixSetId | path | yes | string | |
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Tileset metadata · 400 Invalid collection tileset query parameters · 401 Authentication required for the requested collection · 403 Requested collection is not accessible · 404 Not found · 406 Requested metadata format is not acceptable
/ogc/tiles/collections/{collectionId}/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}Collection tile
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | integer (min 0) | |
tileMatrixSetId | path | yes | string | |
tileMatrix | path | yes | string | |
tileRow | path | yes | integer (min 0) | |
tileCol | path | yes | integer (min 0) | |
f | query | no | string (enum: mvt, png) | Tile format (mvt or png) |
datetime | query | no | string | |
subset | query | no | string | |
crs | query | no | string (uri) | |
subset-crs | query | no | string (uri) |
Responses 200 Vector or raster tile · 204 No content · 400 Invalid tile matrix, tile coordinates, or query parameters · 401 Authentication required for the requested collection · 403 Requested collection is not accessible · 404 Collection or tile matrix set not found · 406 Requested tile format is not acceptable
/ogc/tiles/tileMatrixSetsTile matrix sets list
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Tile matrix sets list · 400 Invalid tile matrix sets query parameters · 406 Requested metadata format is not acceptable
/ogc/tiles/tileMatrixSets/{tileMatrixSetId}Tile matrix set definition
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
tileMatrixSetId | path | yes | string | |
f | query | no | string (enum: json, html) | Output format (json or html) |
Responses 200 Tile matrix set · 400 Invalid tile matrix set query parameters · 404 Not found · 406 Requested metadata format is not acceptable
OGC API Maps implementation for server-rendered imagery. Mounted at https://demo.honua.io/ogc/maps · document version 1.0.0 · raw OpenAPI document ↗
curl -sS "https://demo.honua.io/ogc/maps/conformance"
/ogc/mapsGet OGC API Maps landing page
No parameters.
Responses 200 Landing page
/ogc/maps/conformanceGet OGC API Maps conformance declaration
No parameters.
Responses 200 Conformance declaration
/ogc/maps/openapi.jsonGet OGC API Maps OpenAPI document
No parameters.
Responses 200 OpenAPI document
/ogc/maps/mapRender a dataset map
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collections | query | no | string | Comma-separated collection identifiers to include in a dataset map request. When omitted, all accessible map-enabled collections are considered. |
bbox | query | no | string | Bounding box as minX,minY,maxX,maxY in the bbox-crs coordinate reference system. |
bbox-crs | query | no | string | Coordinate reference system for bbox coordinates. Supports EPSG codes and OGC CRS URIs. |
crs | query | no | string | Coordinate reference system for the rendered map response. Supports EPSG codes and OGC CRS URIs. |
width | query | no | integer (1–4096) | Rendered image width in pixels. |
height | query | no | integer (1–4096) | Rendered image height in pixels. |
f | query | no | string (enum: png, jpeg, jpg, tiff, tif) | Short output image format. When omitted, HTTP Accept negotiation is used. |
quality | query | no | integer (1–100) | Lossy compression quality for JPEG output. |
datetime | query | no | string | RFC 3339 instant or interval used to select temporal raster mosaic frames. Accepts a single instant (e.g. 2024-02-15T00:00:00Z), a closed interval (start/end), and half-open intervals (start/.., ../end). Honua selects the newest effective acquisition batch within the bounded range across the addressed collection or dataset, then applies bbox windowing and renders rasters from that batch only. Requires the raster.temporal-mosaic entitlement; inactive entitlements return 402 Payment Required. |
Responses 200 Rendered map image · 400 Invalid map request parameters · 401 Authentication required for at least one requested collection · 402 Payment required when datetime rendering needs the raster.temporal-mosaic entitlement · 403 Requested collections are not accessible · 404 No renderable collections were found
/ogc/maps/collections/{collectionId}/mapRender a collection map
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | integer (min 0) | |
bbox | query | no | string | Bounding box as minX,minY,maxX,maxY in the bbox-crs coordinate reference system. |
bbox-crs | query | no | string | Coordinate reference system for bbox coordinates. Supports EPSG codes and OGC CRS URIs. |
crs | query | no | string | Coordinate reference system for the rendered map response. Supports EPSG codes and OGC CRS URIs. |
width | query | no | integer (1–4096) | Rendered image width in pixels. |
height | query | no | integer (1–4096) | Rendered image height in pixels. |
f | query | no | string (enum: png, jpeg, jpg, tiff, tif) | Short output image format. When omitted, HTTP Accept negotiation is used. |
quality | query | no | integer (1–100) | Lossy compression quality for JPEG output. |
datetime | query | no | string | RFC 3339 instant or interval used to select temporal raster mosaic frames. Accepts a single instant (e.g. 2024-02-15T00:00:00Z), a closed interval (start/end), and half-open intervals (start/.., ../end). Honua selects the newest effective acquisition batch within the bounded range across the addressed collection or dataset, then applies bbox windowing and renders rasters from that batch only. Requires the raster.temporal-mosaic entitlement; inactive entitlements return 402 Payment Required. |
Responses 200 Rendered map image · 400 Invalid collection identifier or map request parameters · 401 Authentication required for the requested collection · 402 Payment required when datetime rendering needs the raster.temporal-mosaic entitlement · 403 Requested collection is not accessible · 404 Collection not found or has no renderable map data
/ogc/maps/collections/{collectionId}/styles/{styleId}/mapRender a styled collection map
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | integer (min 0) | |
styleId | path | yes | string | |
bbox | query | no | string | Bounding box as minX,minY,maxX,maxY in the bbox-crs coordinate reference system. |
bbox-crs | query | no | string | Coordinate reference system for bbox coordinates. Supports EPSG codes and OGC CRS URIs. |
crs | query | no | string | Coordinate reference system for the rendered map response. Supports EPSG codes and OGC CRS URIs. |
width | query | no | integer (1–4096) | Rendered image width in pixels. |
height | query | no | integer (1–4096) | Rendered image height in pixels. |
f | query | no | string (enum: png, jpeg, jpg, tiff, tif) | Short output image format. When omitted, HTTP Accept negotiation is used. |
quality | query | no | integer (1–100) | Lossy compression quality for JPEG output. |
datetime | query | no | string | RFC 3339 instant or interval used to select temporal raster mosaic frames. Accepts a single instant (e.g. 2024-02-15T00:00:00Z), a closed interval (start/end), and half-open intervals (start/.., ../end). Honua selects the newest effective acquisition batch within the bounded range across the addressed collection or dataset, then applies bbox windowing and renders rasters from that batch only. Requires the raster.temporal-mosaic entitlement; inactive entitlements return 402 Payment Required. |
Responses 200 Rendered styled map image · 400 Invalid collection identifier or map request parameters · 401 Authentication required for the requested collection · 402 Payment required when datetime rendering needs the raster.temporal-mosaic entitlement · 403 Requested collection is not accessible · 404 Collection not found or has no renderable map data · 501 Styled map rendering is not implemented for this collection type
/ogc/maps/collections/{collectionId}/map/tilesGet collection map tilesets
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | integer (min 0) |
Responses 200 Tileset metadata · 400 Invalid collection identifier · 401 Authentication required for the requested collection · 403 Requested collection is not accessible · 404 Collection not found
/ogc/maps/collections/{collectionId}/map/tiles/{tileMatrixSetId}Get collection map tileset
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | integer (min 0) | |
tileMatrixSetId | path | yes | string |
Responses 200 Tileset metadata · 400 Invalid collection identifier · 401 Authentication required for the requested collection · 403 Requested collection is not accessible · 404 Collection or tile matrix set not found
OGC API Processes adapter over the Honua canonical geoprocessing runtime. Mounted at https://demo.honua.io/ogc/processes · document version 1.0.0 · raw OpenAPI document ↗
curl -sS "https://demo.honua.io/ogc/processes/processes"
/ogc/processesOGC API Processes landing page
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Metadata response format. |
Responses 200 Landing page
/ogc/processes/conformanceOGC API Processes conformance declaration
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json, html) | Metadata response format. |
Responses 200 Conformance declaration
/ogc/processes/openapi.jsonGet OGC API Processes OpenAPI document
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
f | query | no | string (enum: json) | OpenAPI document response format. |
Responses 200 OpenAPI document · 404 OpenAPI document not found
/ogc/processes/processesList available processes
No parameters.
Responses 200 Process list
/ogc/processes/processes/{processId}Get process description
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
processId | path | yes | string |
Responses 200 Process description · 404 No such process
/ogc/processes/processes/{processId}/executionExecute a process
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
processId | path | yes | string | |
Prefer | header | no | string | Optional preference hint. Async execution is the default for this process; 'respond-async' is accepted and echoed via Preference-Applied when supplied. |
Request body application/json (required) · Execute
Responses 201 Async job created · 400 Invalid request · 401 Authentication required · 403 Permission denied or approval required · 404 No such process · 501 Unsupported response mode in V1 · 503 Durable job storage unavailable
/ogc/processes/jobsList jobs
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
limit | query | no | integer (min 1) |
Responses 200 Job list · 400 Invalid request (e.g. limit <= 0) · 401 Authentication required · 403 Permission denied · 503 Durable job storage unavailable
/ogc/processes/jobs/{jobId}Get job status
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
jobId | path | yes | string |
Responses 200 Job status · 401 Authentication required · 403 Permission denied · 404 No such job · 503 Durable job storage unavailable
/ogc/processes/jobs/{jobId}Request dismissal of a job
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
jobId | path | yes | string |
Responses 200 Job dismissal confirmed · 401 Authentication required · 403 Permission denied · 404 No such job · 409 Dismiss could not be applied or confirmed · 503 Durable job storage unavailable
/ogc/processes/jobs/{jobId}/resultsGet job results
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
jobId | path | yes | string |
Responses 200 Job succeeded. Document-mode results keyed by output identifier per OGC API Processes Part 1 §7.11.1. V1 declares no value-typed outputs on the canonical process, so the body is an empty object; populated entries land here once result storage ships. · 401 Authentication required · 403 Permission denied · 404 Job not found or not yet in a terminal state · 410 Job has been dismissed · 500 Job failed during execution · 503 Durable job storage unavailable
STAC API surface for Honua geospatial discovery. Mounted at https://demo.honua.io/stac · document version 1.0.0 · raw OpenAPI document ↗
curl -sS "https://demo.honua.io/stac"
/stacSTAC root catalog
No parameters.
Responses 200 STAC Catalog
/stac/conformanceSTAC conformance declaration
No parameters.
Responses 200 Conformance declaration
/stac/collectionsSTAC collections
No parameters.
Responses 200 STAC Collections response
/stac/collections/{collectionId}STAC collection
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string |
Responses 200 STAC Collection
/stac/collections/{collectionId}/itemsSTAC collection items
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string |
Responses 200 STAC ItemCollection
/stac/collections/{collectionId}/items/{itemId}STAC item
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string | |
itemId | path | yes | string |
Responses 200 STAC Item
/stac/queryablesSTAC catalog queryables
No parameters.
Responses 200 Queryables JSON Schema
/stac/collections/{collectionId}/queryablesSTAC collection queryables
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
collectionId | path | yes | string |
Responses 200 Queryables JSON Schema
/stac/searchSTAC item search
No parameters.
Responses 200 STAC ItemCollection
/stac/searchSTAC item search
No parameters.
Responses 200 STAC ItemCollection
OGC API Styles adapter over Honua per-layer style storage (ADR-0048, Phase 1) · document version 1.0.0 · raw OpenAPI document ↗
The demo server's OGC API Styles document currently publishes no paths ("paths": {}). There is nothing to render for this surface yet; the document exists as a placeholder for the styles adapter. Style management endpoints are available under the Server Management API (Styles tag).
Curated OpenAPI snapshot of key Honua Server administrative endpoints for configuration, import scanning, connections, layers, styles, observability, realtime alert management, durable job viewing, package validation and preview planning, runtime licensing, deploy control, and native client-certificate trust management. For full runtime endpoint discovery, use /api/v1/admin/config and the Control Plane guide.
Base URL https://demo.honua.io/api/v1/admin · document version 1.0.0 · raw OpenAPI document ↗
Summarized on purpose: this document describes 395 operations across 319 paths in 50 tag groups. Every operation is listed below with its method, path, and summary — nothing is dropped — but parameter tables, request bodies, and per-operation response codes are not repeated here. For those, open the live console ↗ or the raw document. All admin endpoints require authentication (API key, bearer token, or basic auth); unauthenticated requests return 401.
curl -sS -H "X-API-Key: $HONUA_API_KEY" "https://demo.honua.io/api/v1/admin/capabilities"
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/alerts/zones | List Alert Zones |
| POST | /api/v1/admin/alerts/zones | Create Alert Zone |
| GET | /api/v1/admin/alerts/zones/{zoneId} | Get Alert Zone |
| PUT | /api/v1/admin/alerts/zones/{zoneId} | Update Alert Zone |
| DELETE | /api/v1/admin/alerts/zones/{zoneId} | Delete Alert Zone |
| GET | /api/v1/admin/alerts/rules | List Alert Rules |
| POST | /api/v1/admin/alerts/rules | Create Alert Rule |
| POST | /api/v1/admin/alerts/rules/test | Test Alert Rule |
| GET | /api/v1/admin/alerts/rules/{ruleId} | Get Alert Rule |
| PUT | /api/v1/admin/alerts/rules/{ruleId} | Update Alert Rule |
| DELETE | /api/v1/admin/alerts/rules/{ruleId} | Delete Alert Rule |
| PUT | /api/v1/admin/alerts/rules/{ruleId}/enabled | Set Alert Rule Enabled State |
| GET | /api/v1/admin/alerts/rules/{ruleId}/health | Get Alert Rule Health |
| GET | /api/v1/admin/alerts/channels | List Alert Channel States |
| POST | /api/v1/admin/alerts/channels/{channel}/pause | Pause Alert Channel |
| POST | /api/v1/admin/alerts/channels/{channel}/resume | Resume Alert Channel |
| POST | /api/v1/admin/alerts/dispatch/redrive | Redrive Alert Dead-Letters |
| GET | /api/v1/admin/alerts/rules/{ruleId}/events | List Alert Rule Events |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/api-keys | List Admin API Keys |
| POST | /api/v1/admin/api-keys | Create Admin API Key |
| POST | /api/v1/admin/api-keys/{id}/rotate | Rotate Admin API Key |
| POST | /api/v1/admin/api-keys/{id}/revoke | Revoke Admin API Key |
| GET | /api/v1/admin/api-keys/{id}/effective-permissions | Get Admin API Key Effective Permissions |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/cache/status | Get cache health status |
| POST | /api/v1/admin/cache/invalidate | Invalidate cached responses by scope |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/cloud-rasters | List Cloud Rasters |
| POST | /api/v1/admin/cloud-rasters | Register Cloud Raster |
| GET | /api/v1/admin/cloud-rasters/{id} | Get Cloud Raster |
| DELETE | /api/v1/admin/cloud-rasters/{id} | Unregister Cloud Raster |
| POST | /api/v1/admin/cloud-rasters/{id}/refresh | Refresh Cloud Raster Metadata |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/compliance/dashboard | Get Compliance Dashboard |
| GET | /api/v1/admin/compliance/report | Export Compliance Report |
| POST | /api/v1/admin/compliance/residency/evaluate | Evaluate Residency Policy |
| POST | /api/v1/admin/compliance/encryption/rotate-key | Advance Compliance Key-Version Posture |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/config | Get Configuration Documentation |
| GET | /api/v1/admin/openapi.json | Get Admin OpenAPI Specification |
| GET | /api/v1/admin/configuration/discover | Discover Configuration |
| GET | /api/v1/admin/configuration/metadata | Get Configuration Metadata |
| GET | /api/v1/admin/configuration/auto-documentation | Get Configuration Auto-Documentation |
| GET | /api/v1/admin/configuration/secrets/validate | Validate Configuration Secrets |
| GET | /api/v1/admin/configuration/audit | Get Configuration Audit Info |
| GET | /api/v1/admin/configuration/summary | Get Configuration Summary |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/connections | List Secure Connections |
| POST | /api/v1/admin/connections | Create Secure Connection |
| GET | /api/v1/admin/connections/{id} | Get Secure Connection |
| PUT | /api/v1/admin/connections/{id} | Update Secure Connection |
| DELETE | /api/v1/admin/connections/{id} | Delete Secure Connection |
| GET | /api/v1/admin/connections/{id}/tables | Get Connection Tables |
| POST | /api/v1/admin/connections/test | Test Draft Connection |
| POST | /api/v1/admin/connections/{id}/test | Test Saved Connection |
| POST | /api/v1/admin/connections/encryption/validate | Validate Encryption Service |
| POST | /api/v1/admin/connections/encryption/rotate-key | Rotate Encryption Key |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/deploy/preflight | Get Deploy Preflight |
| POST | /api/v1/admin/deploy/plan | Plan Deploy Operation |
| GET | /api/v1/admin/deploy/operations | List Deploy Operations |
| POST | /api/v1/admin/deploy/operations | Create Deploy Operation |
| GET | /api/v1/admin/deploy/operations/{operationId} | Get Deploy Operation |
| POST | /api/v1/admin/deploy/operations/{operationId}/submit | Submit Deploy Operation |
| POST | /api/v1/admin/deploy/operations/{operationId}/rollback | Rollback Deploy Operation |
| POST | /api/v1/admin/deploy/operations/{operationId}/promote | Promote Deploy Operation |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/embed/keys | List Embed Keys |
| POST | /api/v1/admin/embed/keys | Create Embed Key |
| GET | /api/v1/admin/embed/keys/{id} | Get Embed Key |
| POST | /api/v1/admin/embed/keys/{id}/rotate | Rotate Embed Key |
| POST | /api/v1/admin/embed/keys/{id}/revoke | Revoke Embed Key |
| GET | /api/v1/admin/embed/usage | Query Embed Usage |
| Method | Path | Summary |
|---|---|---|
| POST | /api/v1/admin/external-services/discover | Discover External Service |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/feature-events/replay | Replay feature-change events |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/features | Get Feature Overview |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/federation/sources | List Federated Sources |
| GET | /api/v1/admin/federation/sources/{id}/plan | Plan Federated Query |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/field-mask-policies | List Field-Mask Policies |
| POST | /api/v1/admin/field-mask-policies | Create Field-Mask Policy |
| GET | /api/v1/admin/field-mask-policies/{id} | Get Field-Mask Policy |
| DELETE | /api/v1/admin/field-mask-policies/{id} | Delete Field-Mask Policy |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/field-workflows/submissions | List Field Submissions |
| GET | /api/v1/admin/field-workflows/submissions/{submissionId} | Get Field Submission |
| POST | /api/v1/admin/field-workflows/submissions/{submissionId}/assignment | Assign Field Submission |
| POST | /api/v1/admin/field-workflows/submissions/{submissionId}/decision | Decide Field Submission |
| POST | /api/v1/admin/field-workflows/submissions/{submissionId}/comments | Comment On Field Submission |
| GET | /api/v1/admin/field-workflows/exports | List Field Exports |
| POST | /api/v1/admin/field-workflows/exports | Create Field Export |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/forms/packages | List Form Packages |
| POST | /api/v1/admin/forms/packages | Create Form Package Draft |
| POST | /api/v1/admin/forms/packages/generate | Generate Form Package |
| GET | /api/v1/admin/forms/packages/{formId} | Get Current Form Package |
| GET | /api/v1/admin/forms/packages/{formId}/versions | List Form Package Versions |
| GET | /api/v1/admin/forms/packages/{formId}/versions/{packageVersion} | Get Form Package Version |
| PUT | /api/v1/admin/forms/packages/{formId}/versions/{packageVersion} | Update Form Package Draft |
| POST | /api/v1/admin/forms/packages/{formId}/versions/{packageVersion}/validate | Validate Form Package Version |
| POST | /api/v1/admin/forms/packages/{formId}/versions/{packageVersion}/publish | Publish Form Package Version |
| POST | /api/v1/admin/forms/packages/{formId}/versions/{packageVersion}/reopen | Reopen Form Package Version |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/geocoding/providers | Get Geocoding Providers |
| POST | /api/v1/admin/geocoding/reference-data/import | Import Geocoder Reference Data |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/geoprocessing/tools/usage-ranking | Get geoprocessing tool usage ranking |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/identity/providers | Get Identity Providers |
| GET | /api/v1/admin/identity/providers/{providerType}/test | Test Identity Provider Connectivity |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/import/formats | Get Supported Import Formats |
| POST | /api/v1/admin/import/toolbox/translation/validate | Validate a Translated Toolbox Manifest |
| POST | /api/v1/admin/import/preview | Preview a Geospatial File |
| POST | /api/v1/admin/import/preview-url | Preview a Geospatial File from a URL |
| POST | /api/v1/admin/import/upload-url | Import a Geospatial File from a URL |
| GET | /api/v1/admin/import/limits | Get Import Limits |
| GET | /api/v1/admin/import/jobs | List Active Import Jobs |
| GET | /api/v1/admin/import/jobs/{jobId} | Get Import Job Status |
| POST | /api/v1/admin/import/jobs/{jobId}/cancel | Cancel an Import Job |
| POST | /api/v1/admin/import/upload | Upload and Import a Geospatial File |
| POST | /api/v1/admin/import/scan | Scan Migration Source |
| GET | /api/v1/admin/import/arcgis/migrations | List ArcGIS Migration Runs |
| GET | /api/v1/admin/import/arcgis/migrations/{runId}/manifest | Get ArcGIS Migration Manifest |
| POST | /api/v1/admin/import/arcgis/migrations/{runId}/manifest | Record ArcGIS Migration Manifest |
| GET | /api/v1/admin/import/arcgis/migrations/{runId}/parity | Get ArcGIS Migration Parity |
| POST | /api/v1/admin/import/arcgis/migrations/{runId}/parity | Record ArcGIS Migration Parity |
| POST | /api/v1/admin/import/geoserver/discover | Discover GeoServer Service |
| POST | /api/v1/admin/import/geoserver/start | Start GeoServer Import |
| GET | /api/v1/admin/import/geoserver/jobs | List GeoServer Import Jobs |
| GET | /api/v1/admin/import/geoserver/jobs/{jobId} | Get GeoServer Import Job |
| POST | /api/v1/admin/import/geoserver/jobs/{jobId}/cancel | Cancel GeoServer Import Job |
| POST | /api/v1/admin/import/geoservices/discover | Discover GeoServices Service |
| POST | /api/v1/admin/import/geoservices/start | Start GeoServices Import |
| GET | /api/v1/admin/import/geoservices/jobs | List GeoServices Import Jobs |
| GET | /api/v1/admin/import/geoservices/jobs/{jobId} | Get GeoServices Import Job |
| POST | /api/v1/admin/import/geoservices/jobs/{jobId}/cancel | Cancel GeoServices Import Job |
| POST | /api/v1/admin/import/migrations | Start Migration Batch |
| GET | /api/v1/admin/import/migrations/{batchId} | Get Migration Batch |
| POST | /api/v1/admin/import/ogc-api-features/collection | Import OGC API Features Collection |
| POST | /api/v1/admin/import/ogc-tiles/export | Export OGC WMTS Tile Cache |
| POST | /api/v1/admin/import/ogc-wcs/import | Import Legacy WCS Coverages |
| POST | /api/v1/admin/import/ogc-wfs/start | Start OGC WFS Import |
| POST | /api/v1/admin/import/ogc/coverages/import | Import OGC Coverages |
| POST | /api/v1/admin/import/raster | Import Raster File |
| GET | /api/v1/admin/import/raster/formats | Get Raster Import Formats |
| PATCH | /api/v1/admin/import/raster/{rasterId} | Update Imported Raster |
| DELETE | /api/v1/admin/import/raster/{rasterId} | Delete Imported Raster |
| POST | /api/v1/admin/import/tile-package | Import Tile Cache Package |
| GET | /api/v1/admin/import/uploads | List Active Import Uploads |
| POST | /api/v1/admin/import/uploads/{uploadId}/cancel | Cancel Import Upload |
| GET | /api/v1/admin/import/uploads/{uploadId}/progress | Get Import Upload Progress |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/investigations | List Investigations |
| POST | /api/v1/admin/investigations | Create Investigation |
| GET | /api/v1/admin/investigations/{investigationId} | Get Investigation |
| PATCH | /api/v1/admin/investigations/{investigationId} | Update Investigation |
| POST | /api/v1/admin/investigations/{investigationId}/links | Link Resource To Investigation |
| DELETE | /api/v1/admin/investigations/{investigationId}/links/{linkId} | Remove Investigation Link |
| POST | /api/v1/admin/investigations/{investigationId}/pins | Pin Event To Investigation |
| DELETE | /api/v1/admin/investigations/{investigationId}/pins/{pinId} | Remove Investigation Pin |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/jobs | List Console Jobs |
| GET | /api/v1/admin/jobs/{jobId} | Get Console Job Detail |
| GET | /api/v1/admin/jobs/{jobId}/logs | Get Console Job Logs |
| GET | /api/v1/admin/jobs/{jobId}/artifacts | Get Console Job Artifacts |
| GET | /api/v1/admin/jobs/{jobId}/actions | Get Console Job Actions |
| POST | /api/v1/admin/jobs/{jobId}/cancel | Cancel Console Job |
| POST | /api/v1/admin/jobs/{jobId}/retry | Retry Console Job |
| GET | /api/v1/admin/jobs/{jobId}/steps | Get Console Job Steps |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/connections/{id}/layers | List Published Layers |
| POST | /api/v1/admin/connections/{id}/layers | Publish Layer |
| PUT | /api/v1/admin/connections/{id}/layers/{layerId}/enabled | Set Layer Enabled |
| PUT | /api/v1/admin/connections/{id}/layers/enabled | Set Service Layers Enabled |
| POST | /api/v1/admin/connections/{id}/tables/validate | Validate Table For Layer Publishing |
| POST | /api/v1/admin/connections/{id}/layers/extents/refresh | Refresh Layer Extents |
| POST | /api/v1/admin/connections/{id}/layers/{layerId}/features/refresh | Refresh Layer Feature Snapshot |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/license | Get License Status |
| POST | /api/v1/admin/license | Upload License |
| GET | /api/v1/admin/license/entitlements | Get License Entitlements |
| GET | /api/v1/admin/license/status | Get Platform License Status |
| GET | /api/v1/admin/license/features | Get License Feature Entitlements |
| POST | /api/v1/admin/license/upload | Upload License File |
| GET | /api/v1/admin/license/capacity | Get License Capacity State |
| POST | /api/v1/admin/license/capacity/surge | Set License Surge Mode |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/capabilities | Get Admin Capabilities |
| GET | /api/v1/admin/version | Get Admin Version Info |
| GET | /api/v1/admin/metadata/environments/{environment}/inventory | Get Metadata Semantic Inventory |
| POST | /api/v1/admin/metadata/environment-bindings/query | Query Metadata Environment Bindings |
| GET | /api/v1/admin/metadata/release-packages | List Metadata Release Packages |
| POST | /api/v1/admin/metadata/release-packages | Create Metadata Release Package |
| GET | /api/v1/admin/metadata/release-packages/{packageId} | Get Metadata Release Package |
| GET | /api/v1/admin/metadata/release-packages/{packageId}/gitops-manifest | Get Metadata Release GitOps Manifest |
| GET | /api/v1/admin/metadata/releases/{packageId}/operation | Get Metadata Release Operation |
| POST | /api/v1/admin/metadata/prevalidate | Prevalidate Metadata Release Package Compatibility |
| POST | /api/v1/admin/metadata/coordinated-releases/operations | Create Coordinated Release Operation |
| POST | /api/v1/admin/metadata/coordinated-releases/operations/{operationId}/approve/{gate} | Approve Coordinated Release Gate |
| POST | /api/v1/admin/metadata/coordinated-releases/operations/{operationId}/rollback | Roll Back Coordinated Release |
| GET | /api/v1/admin/metadata/coordinated-releases/{packageId}/operation | Get Coordinated Release Operation |
| POST | /api/v1/admin/metadata/releases/operations | Create Metadata Release Operation |
| GET | /api/v1/admin/metadata/layers/{layerId}/popup-info | Get Layer Popup Info |
| PUT | /api/v1/admin/metadata/layers/{layerId}/popup-info | Set Layer Popup Info |
| GET | /api/v1/admin/metadata/layers/{layerId}/drawing-info | Get Layer Drawing Info |
| PUT | /api/v1/admin/metadata/layers/{layerId}/drawing-info | Set Layer Drawing Info |
| GET | /api/v1/admin/metadata/layers/{layerId}/relationships | Get Layer Relationships |
| PUT | /api/v1/admin/metadata/layers/{layerId}/relationships | Set Layer Relationships |
| GET | /api/v1/admin/metadata/layers/{layerId}/fields | Get Layer Field Configuration |
| PUT | /api/v1/admin/metadata/layers/{layerId}/fields | Update Layer Field Configuration |
| GET | /api/v1/admin/metadata/layers/{layerId}/filter | Get Layer Permanent Filter |
| PUT | /api/v1/admin/metadata/layers/{layerId}/filter | Update Layer Permanent Filter |
| GET | /api/v1/admin/metadata/layers/{layerId}/validation | Validate Layer Metadata |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/migration/performance-evidence/latest | Get Latest Migration Performance Evidence |
| GET | /api/v1/admin/migration/performance-evidence/history | List Migration Performance Evidence History |
| GET | /api/v1/admin/migration/performance-evidence/{evidenceId} | Get Migration Performance Evidence |
| GET | /api/v1/admin/migration/runs | List Migration Runs |
| POST | /api/v1/admin/migration/runs | Record Migration Run Started |
| GET | /api/v1/admin/migration/runs/{runId} | Get Migration Run |
| POST | /api/v1/admin/migration/runs/{runId}/complete | Record Migration Run Completed |
| POST | /api/v1/admin/migration/runs/{runId}/cancel | Cancel Migration Run |
| GET | /api/v1/admin/migration/runs/{runId}/evidence-pack | Download Migration Run Evidence Pack |
| GET | /api/v1/admin/migration/runs/{runId}/scorecard | Download Migration Run Reconciliation Scorecard |
| POST | /api/v1/admin/migration/runs/{runId}/scorecard | Record Migration Run Reconciliation Scorecard |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/multidim-coverages | List Multidimensional Coverages |
| POST | /api/v1/admin/multidim-coverages | Register Multidimensional Coverage |
| GET | /api/v1/admin/multidim-coverages/jobs/{jobId} | Get Multidimensional Coverage Scan Job |
| GET | /api/v1/admin/multidim-coverages/{id} | Get Multidimensional Coverage |
| DELETE | /api/v1/admin/multidim-coverages/{id} | Unregister Multidimensional Coverage |
| POST | /api/v1/admin/multidim-coverages/{id}/refresh | Refresh Multidimensional Coverage Metadata |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/network-datasets | List Network Datasets |
| POST | /api/v1/admin/network-datasets | Register Network Dataset |
| GET | /api/v1/admin/network-datasets/{id} | Get Network Dataset |
| PUT | /api/v1/admin/network-datasets/{id} | Update Network Dataset |
| DELETE | /api/v1/admin/network-datasets/{id} | Delete Network Dataset |
| GET | /api/v1/admin/network-datasets/{id}/generations | List Topology Generations |
| POST | /api/v1/admin/network-datasets/{id}/generations | Allocate Draft Topology Generation |
| POST | /api/v1/admin/network-datasets/{id}/generations/{generation}/edits | Apply Topology Edit Batch |
| POST | /api/v1/admin/network-datasets/{id}/generations/{generation}/rebuild | Submit Topology Rebuild |
| GET | /api/v1/admin/network-datasets/{id}/generations/{generation}/rebuild/{attempt} | Get Topology Rebuild Attempt |
| POST | /api/v1/admin/network-datasets/{id}/promote | Promote Topology Generation |
| POST | /api/v1/admin/network-datasets/{id}/rollback | Roll Back Topology Generation |
| GET | /api/v1/admin/network-datasets/{id}/promotions | List Topology Promotions |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/oauth-clients | List OAuth Clients |
| POST | /api/v1/admin/oauth-clients | Register OAuth Client |
| GET | /api/v1/admin/oauth-clients/{id} | Get OAuth Client |
| DELETE | /api/v1/admin/oauth-clients/{id} | Delete OAuth Client |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/oauth-scopes | List OAuth Scopes |
| PUT | /api/v1/admin/oauth-scopes | Define OAuth Scope |
| DELETE | /api/v1/admin/oauth-scopes/{scope} | Delete OAuth Scope |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/observability/errors | Get Recent Errors |
| GET | /api/v1/admin/observability/telemetry | Get Telemetry Status |
| GET | /api/v1/admin/observability/migrations | Get Migration Status |
| GET | /api/v1/admin/observability/alerts | List Observability Alerts |
| GET | /api/v1/admin/observability/alerts/{eventId} | Get Observability Alert |
| POST | /api/v1/admin/observability/alerts/{eventId}/acknowledge | Acknowledge Observability Alert |
| POST | /api/v1/admin/observability/alerts/{eventId}/resolve | Resolve Observability Alert |
| POST | /api/v1/admin/observability/alerts/{eventId}/suppress | Suppress Observability Alert |
| GET | /api/v1/admin/observability/audit | List Audit Log Entries |
| GET | /api/v1/admin/observability/audit/export | Export Audit Trail (SIEM) |
| GET | /api/v1/admin/observability/audit/verify | Verify Audit Trail Integrity |
| GET | /api/v1/admin/observability/autonomy/policies | List Ops Autonomy Policies |
| GET | /api/v1/admin/observability/autonomy/policies/{rule} | Get Ops Autonomy Policy |
| PUT | /api/v1/admin/observability/autonomy/policies/{rule} | Set Ops Autonomy Policy |
| GET | /api/v1/admin/observability/autonomy/settings | Get Ops Autonomy Settings |
| PUT | /api/v1/admin/observability/autonomy/settings | Set Ops Autonomy Settings |
| GET | /api/v1/admin/observability/events | List Operate Events |
| GET | /api/v1/admin/observability/findings | Get Ops Findings |
| POST | /api/v1/admin/observability/findings/{findingId}/propose | Propose Ops Finding Action |
| GET | /api/v1/admin/observability/logs | List Recent Server Logs |
| GET | /api/v1/admin/observability/ops-health | Get Ops Health Snapshot |
| GET | /api/v1/admin/observability/ops-health/history | Get Ops Health History |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/oidc/providers | List OIDC Providers |
| POST | /api/v1/admin/oidc/providers | Create OIDC Provider |
| GET | /api/v1/admin/oidc/providers/{id} | Get OIDC Provider |
| PUT | /api/v1/admin/oidc/providers/{id} | Update OIDC Provider |
| DELETE | /api/v1/admin/oidc/providers/{id} | Delete OIDC Provider |
| POST | /api/v1/admin/oidc/providers/{id}/test | Test OIDC Provider Connection |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/operations/cache/health | Get Cache Health |
| GET | /api/v1/admin/operations/cache/statistics | Get Cache Statistics |
| GET | /api/v1/admin/operations/cache/redis | Get Redis Connection Metrics |
| POST | /api/v1/admin/operations/cache/invalidate | Invalidate Cache |
| GET | /api/v1/admin/operations/geocoding/providers | Get Geocoding Provider Status |
| GET | /api/v1/admin/operations/geocoding/configuration | Get Geocoding Configuration |
| GET | /api/v1/admin/operations/streaming/subscribers | List Streaming Subscribers |
| GET | /api/v1/admin/operations/streaming/alerts | Stream Alert Notifications |
| DELETE | /api/v1/admin/operations/streaming/subscribers/{subscriberId} | Disconnect Streaming Subscriber |
| GET | /api/v1/admin/operations/active | List Active Operations |
| GET | /api/v1/admin/operations/type/{operationType} | Get Operations By Type |
| GET | /api/v1/admin/operations/{operationId} | Get Operation Status |
| POST | /api/v1/admin/operations/{operationId}/cancel | Cancel Operation |
| Method | Path | Summary |
|---|---|---|
| POST | /api/v1/admin/packages/validate | Validate Package |
| POST | /api/v1/admin/packages/preview | Preview Package |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/performance/database/query-cache/statistics | Get prepared statement cache statistics |
| GET | /api/v1/admin/performance/enhanced/database/query-performance | Get database query performance statistics |
| GET | /api/v1/admin/performance/enhanced/database/slow-queries | Get recent slow queries |
| GET | /api/v1/admin/performance/enhanced/resources/tracking | Get resource tracking statistics |
| GET | /api/v1/admin/performance/enhanced/resources/potential-leaks | Get potential resource leaks |
| POST | /api/v1/admin/performance/enhanced/resources/scan-leaks | Scan for resource leaks |
| GET | /api/v1/admin/performance/enhanced/exceptions/statistics | Get exception statistics |
| GET | /api/v1/admin/performance/enhanced/exceptions/recent | Get recent exceptions |
| GET | /api/v1/admin/performance/enhanced/cache/statistics | Get query-result cache statistics |
| GET | /api/v1/admin/performance/enhanced/cache/effectiveness | Get cache effectiveness metrics |
| DELETE | /api/v1/admin/performance/enhanced/cache/invalidate | Invalidate query-result cache entries |
| GET | /api/v1/admin/performance/enhanced/summary | Get overall performance summary |
| Method | Path | Summary |
|---|---|---|
| POST | /api/v1/admin/platform-release/converge | Converge Platform Release |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/proposals | List Operation Proposals |
| GET | /api/v1/admin/proposals/{id} | Get Operation Proposal |
| POST | /api/v1/admin/proposals/{id}/approve | Approve Operation Proposal |
| POST | /api/v1/admin/proposals/{id}/reject | Reject Operation Proposal |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/rate-limits | List Rate Limit Policies |
| POST | /api/v1/admin/rate-limits | Create Rate Limit Policy |
| GET | /api/v1/admin/rate-limits/status | Get Rate Limit Status |
| GET | /api/v1/admin/rate-limits/{id} | Get Rate Limit Policy |
| PUT | /api/v1/admin/rate-limits/{id} | Update Rate Limit Policy |
| DELETE | /api/v1/admin/rate-limits/{id} | Delete Rate Limit Policy |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/rls-policies | List RLS Policies |
| POST | /api/v1/admin/rls-policies | Create RLS Policy |
| GET | /api/v1/admin/rls-policies/{id} | Get RLS Policy |
| DELETE | /api/v1/admin/rls-policies/{id} | Delete RLS Policy |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/roles | List Roles |
| POST | /api/v1/admin/roles | Create Role |
| GET | /api/v1/admin/roles/{id} | Get Role |
| PUT | /api/v1/admin/roles/{id} | Update Role |
| DELETE | /api/v1/admin/roles/{id} | Delete Role |
| GET | /api/v1/admin/roles/{id}/permissions | Get Role Permissions |
| PUT | /api/v1/admin/roles/{id}/permissions | Set Role Permissions |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/scenes | List Scene Datasets |
| POST | /api/v1/admin/scenes | Register Scene Dataset |
| POST | /api/v1/admin/scenes/generate | Generate Scene From Feature Layer |
| POST | /api/v1/admin/scenes/ingest/citygml | Ingest CityGML Scene |
| POST | /api/v1/admin/scenes/ingest/pointcloud | Ingest Point Cloud Scene |
| GET | /api/v1/admin/scenes/{id} | Get Scene Dataset |
| PUT | /api/v1/admin/scenes/{id} | Update Scene Dataset |
| DELETE | /api/v1/admin/scenes/{id} | Deactivate Scene Dataset |
| GET | /api/v1/admin/scenes/{id}/resolve | Resolve Scene Dataset |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/auth/config | Get Admin Auth Configuration |
| GET | /api/v1/admin/security/client-certificates/profiles | List Client Certificate Trust Profiles |
| POST | /api/v1/admin/security/client-certificates/profiles | Create Client Certificate Trust Profile |
| GET | /api/v1/admin/security/client-certificates/profiles/{profileId} | Get Client Certificate Trust Profile |
| PUT | /api/v1/admin/security/client-certificates/profiles/{profileId} | Update Client Certificate Trust Profile |
| DELETE | /api/v1/admin/security/client-certificates/profiles/{profileId} | Disable Client Certificate Trust Profile |
| GET | /api/v1/admin/security/client-certificates/profiles/{profileId}/mappings | List Client Certificate Principal Mappings |
| POST | /api/v1/admin/security/client-certificates/profiles/{profileId}/mappings | Create Client Certificate Principal Mapping |
| PUT | /api/v1/admin/security/client-certificates/profiles/{profileId}/mappings/{mappingId} | Update Client Certificate Principal Mapping |
| DELETE | /api/v1/admin/security/client-certificates/profiles/{profileId}/mappings/{mappingId} | Disable Client Certificate Principal Mapping |
| GET | /api/v1/admin/security/client-certificates/profiles/{profileId}/revocations | List Client Certificate Revocations |
| POST | /api/v1/admin/security/client-certificates/profiles/{profileId}/revocations | Add Client Certificate Revocation |
| DELETE | /api/v1/admin/security/client-certificates/profiles/{profileId}/revocations/{revocationId} | Remove Client Certificate Revocation |
| POST | /api/v1/admin/security/client-certificates/validate | Validate Client Certificate |
| GET | /api/v1/admin/auth/session | Get Admin Auth Session |
| POST | /api/v1/admin/auth/bearer | Issue Console Operator Bearer |
| POST | /api/v1/admin/auth/logout | Logout Admin Auth Session |
| POST | /api/v1/admin/auth/providers/{providerKey}/authorize-url | Create Admin Auth Authorize Url |
| POST | /api/v1/admin/auth/providers/{providerKey}/token | Request Admin Auth Token |
| GET | /api/v1/admin/auth/providers/{providerKey}/logout-url | Get Admin Auth Logout Url |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/services | List Services |
| GET | /api/v1/admin/services/{serviceName}/settings | Get Service Settings |
| PUT | /api/v1/admin/services/{serviceName}/protocols | Update Service Protocols |
| PUT | /api/v1/admin/services/{serviceName}/mapserver | Update MapServer Settings |
| PUT | /api/v1/admin/services/{serviceName}/access-policy | Update Service Access Policy |
| PUT | /api/v1/admin/services/{serviceName}/timeinfo | Update Service Time Info |
| PUT | /api/v1/admin/services/{serviceName}/layers/{layerId}/metadata | Update Layer Metadata |
| GET | /api/v1/admin/services/{serviceId}/replicas | List Service Replicas |
| GET | /api/v1/admin/services/{serviceId}/replicas/{replicaId} | Get Service Replica |
| GET | /api/v1/admin/services/{serviceId}/replicas/{replicaId}/conflicts | List Replica Conflicts |
| GET | /api/v1/admin/services/{serviceId}/replicas/{replicaId}/conflicts/{conflictId} | Get Replica Conflict |
| POST | /api/v1/admin/services/{serviceId}/replicas/{replicaId}/conflicts/{conflictId}/resolve | Resolve Replica Conflict |
| GET | /api/v1/admin/services/{serviceName}/layers/{layerId}/export | Export Layer Data |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/streaming/features/sessions | List feature stream sessions |
| DELETE | /api/v1/admin/streaming/features/sessions/{sessionId} | Disconnect a feature stream session |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/metadata/layers/{layerId}/style | Get Layer Style |
| PUT | /api/v1/admin/metadata/layers/{layerId}/style | Update Layer Style |
| POST | /api/v1/admin/metadata/layers/{layerId}/style/import-sld | Import SLD Layer Style |
| GET | /api/v1/admin/metadata/layers/{layerId}/style/export-sld | Export Layer Style as SLD |
| POST | /api/v1/admin/metadata/layers/{layerId}/suggest-style | Suggest Layer Style |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/tenants | List Tenants |
| POST | /api/v1/admin/tenants | Create Tenant |
| GET | /api/v1/admin/tenants/usage | Export Tenant Billing Usage |
| GET | /api/v1/admin/tenants/{tenantId} | Get Tenant |
| DELETE | /api/v1/admin/tenants/{tenantId} | Delete Tenant |
| POST | /api/v1/admin/tenants/{tenantId}/suspend | Suspend Tenant |
| POST | /api/v1/admin/tenants/{tenantId}/resume | Resume Tenant |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/tile-operations/jobs | List Tile Operation Jobs |
| POST | /api/v1/admin/tile-operations/jobs | Start Tile Operation Job |
| GET | /api/v1/admin/tile-operations/jobs/{jobId} | Get Tile Operation Job Status |
| POST | /api/v1/admin/tile-operations/jobs/{jobId}/cancel | Cancel Tile Operation Job |
| POST | /api/v1/admin/tile-operations/jobs/{jobId}/retry | Retry Tile Operation Job |
| POST | /api/v1/admin/tile-operations/evict | Evict Tile Cache |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/users | List Users |
| GET | /api/v1/admin/users/{id} | Get User |
| DELETE | /api/v1/admin/users/{id} | Deprovision User |
| PUT | /api/v1/admin/users/{id}/roles | Update User Roles |
| GET | /api/v1/admin/users/{id}/effective-permissions | Get User Effective Permissions |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/admin/zarr-stores | List Zarr Stores |
| POST | /api/v1/admin/zarr-stores | Register Zarr Store |
| GET | /api/v1/admin/zarr-stores/{id} | Get Zarr Store |
| DELETE | /api/v1/admin/zarr-stores/{id} | Unregister Zarr Store |
| POST | /api/v1/admin/zarr-stores/{id}/refresh | Refresh Zarr Store Metadata |
The demo server's console publishes OpenAPI documents for the surfaces above only. The GeoServices REST surface (FeatureServer, MapServer, ImageServer, VectorTileServer, GeocodeServer, and the Geometry Service) is not described by a published OpenAPI document, so it does not appear on this page — its operation-level coverage is documented in the Esri → Honua compatibility matrix with request-level evidence in the claims matrix. The console also lists an aggregate “All protocols” document (/docs/protocols.openapi.json) which returned 405 Method Not Allowed when fetched on 2026-08-10; this page therefore renders the per-protocol documents directly.
Guides and narrative documentation live in the full documentation ↗; machine-readable SDK docs ship at /llms.txt and /llms-full.txt. For client and SDK coverage, see client and SDK compatibility.
Snapshot fetched 2026-08-10 (UTC) from the public demo server. Regenerate by re-fetching the raw documents linked above.