Write Features

Create or replace a feature

Creates or replaces a feature in the layer.

put/layers/{layerId}/features/{featureId}

Request

Base URL
https://use.apilookup.for.a.base.url
URL
https://use.apilookup.for.a.base.url/layers/{layerId}/features/{featureId}
Auth
HTTP bearer

Path parameters

layerIdstring required

The unique identifier of the layer.

featureIdstring required

The unique identifier of a feature in the layer.

Query parameters

versionRefstring

The query parameter used to specify the target version reference when reading or writing features. A reference describes a target tag or a version.

Default is: HEAD

<br> Depending on the use-case it can be necessary to specify a range of versions rather than only one version. In such a case the version part of the Ref would look like: `<start>..<end>`

Where <start> is the start of the range (exclusive) and <end> is the end of the range (inclusive).

Another way of specifying a version range is using the star-symbol: *

Using * refers to "all available versions" in the space or branch and is only applicable in the cases in which a version range may be provided.

<br> Samples: - `42` points to version 42 - `HEAD` points to the latest version - `myTag` points to the version of the tag with ID "myTag" - `0..HEAD` points to all available versions - `*` also points to all versions (short form) - `5..10` points to the versions in the interval `]5, 10]`

Request body

typestring required

bboxnumber[]

Describes the coordinate range of the GeoJSON object.

idstring

The unique identifier of the feature.

propertiesobject

The properties of the feature.

Example request

{
  "type": "Feature",
  "id": "BfiimUxHjj",
  "geometry": {
    "type": "Point",
    "coordinates": [
      -2.960847,
      53.430828
    ]
  },
  "properties": {
    "name": "Anfield",
    "amenity": "Football Stadium",
    "capacity": 54074,
    "description": "Home of the Liverpool Football Club."
  }
}

Response

A feature response.