Create Empty Dataset Endpoint
Changed onCreate an empty dataset with user-defined columns.
Creates a PostGIS table in the data schema and a catalog record.
Request
- The document declares no server URL.
- Auth: one of:
- OAuth 2 (password, token URL /api/auth/login)
- API key in header X-Api-Key
- API key in query parameter api_key
Request body
Response
Successful Response
Parent catalog record UUID
Internal PostGIS table name
Current EPSG SRID of stored geometry
OGC geometry type, e.g. MultiPolygon
True when the underlying column is generic GEOMETRY (created sketch datasets): the dataset accepts ANY geometry subtype on write regardless of the display geometry_type above. Computed on the detail endpoint only; list endpoints always report false.
True if geometry has Z dimension
Number of coordinate dimensions (2, 3, or 4)
Minimum Z value across all features
Maximum Z value across all features
Bounding box [west, south, east, north] per RFC 7946 §5.2. west > east on an antimeridian-crossing extent.
Credit line the source's terms require to be displayed wherever the data is rendered. Shown verbatim in the map viewer's attribution control.
Start of temporal coverage
End of temporal coverage
Original file format, e.g. GPKG, SHP
Ordered vector-tile property allowlist; null uses zoom defaults, [] emits geometry-only tiles, list emits those properties at any zoom.
EPSG SRID of the uploaded source file
Monotonic version counter
URL the data was originally fetched from
How the data entered the catalog: upload, postgis, service, stac, or created. Computed from source_format and record_type, not stored; null for collections and VRTs, which have no origin of their own.
Machine-readable pointer back to the origin, written only by ingest and refresh. Distinct from source_url, which is editable descriptive metadata. Null for uploads and created datasets. It is also null for any reader who is neither the dataset's owner nor an admin — origin (above) and the freshness/health fields below are not gated and still describe the dataset's capabilities.
Typed per-origin payload with a kind discriminator, e.g. {"kind": "service", "service_type": "wfs", "url": "...", "layer_id": "0"}. Never contains credentials. owner-or-admin only, same redaction as origin_uri.
Last committed successful refresh — not the last attempt
Last time GeoLens contacted the origin at all, whether the attempt succeeded or failed
healthy, missing, inaccessible, or unknown. 'unknown' means never probed, or an origin kind with nothing to probe.
Why the origin is not healthy, as one of a fixed set of GeoLens codes: auth_required, blocked_by_policy, item_withdrawn, network_error, not_found, server_error, timeout, unauthorized, unexpected_status. Null when healthy or never probed. Never provider text, a URL, or a response body — nothing the origin sent is stored here.
none, drifted, or unknown. Set at refresh commit from the schema diff; 'unknown' until a refresh has run.
fresh, due, overdue, or unknown, computed from last_refreshed_at against the declared update_frequency: due past one declared period, overdue past two. 'unknown' when the origin cannot be refreshed at all (created), when no cadence is declared (asNeeded, irregular, notPlanned, unknown), or when nothing has been refreshed yet. Advisory only; never blocks an operation. Distinct from the quality score's own freshness, which measures quality_detail.computed_at rather than the source.
Access level: private, restricted, internal, public
Lifecycle status. Deliberately not pinned to an enum: the values come from the workflow extension's status_order(), so an overlay may define its own. Community default order: draft, ready, internal, published.
Free-text provenance / lineage statement
ISO maintenance frequency code
e.g. public, confidential, restricted
ISO topic category codes
Owning organization name
Record type: 'vector_dataset' (spatial features), 'raster_dataset' (single COG), 'vrt_dataset' (VRT mosaic), 'table' (non-spatial tabular), 'map' (saved map), 'service' (catalogued remote service), 'collection' (flat dataset group), 'tiles3d_dataset' (3D Tiles tileset), 'pointcloud_dataset' (COPC point cloud).
STAC-style asset dictionary
ISO 639-1 language code, e.g. en, fr
Advisory warnings produced by a metadata update — e.g. a visibility or status change exposing keywords inherited from an analysis source the new audience cannot open. Only ever set on the PATCH response; the change has already applied.
Changes
- info
added the optional property
//to the response with the status
- info
- info
added the optional property
to the response with the status
- info