Sign in
Maps

Create Layer Endpoint

Create a new empty spatial layer.

Creates a PostGIS table with a typed geometry column, runs the full post-processing pipeline (geom_4326, spatial index, reader grants), and registers the layer as a catalog dataset.

Requires editor or admin role.

post/layers/

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

titlestring required

Display name for the new layer

geometry_typestring required

OGC geometry type: Point, MultiPoint, LineString, MultiLineString, Polygon, or MultiPolygon

summarystring nullable

Optional text description of the layer

Example request

{
  "title": "Survey Points",
  "geometry_type": "Point"
}

Response

Successful Response

idstring uuid required

Dataset ID of the created layer

titlestring required

Display name

table_namestring required

PostGIS table name in the data schema

geometry_typestring required

OGC geometry type

feature_countinteger required

Number of features (0 for new layers)

visibilitystring required

Visibility level: private, internal, or public

created_atstring date-time required

Creation timestamp

Changes

No recorded changes to this operation across all 50 revisions of this API.