Write Features

Create or replace a feature

Changed on Sep 25, 2025

Creates or replaces a feature in the space.

put/spaces/{spaceId}/features/{featureId}

Request

Base URL
/hub (relative, and the document was published on a file host, not at the API’s origin)
URL
/hub/spaces/{spaceId}/features/{featureId}
Auth
- API key in query parameter access_token
- or HTTP bearer

Path parameters

spaceIdstring required

The unique identifier of the space.

featureIdstring required

The unique identifier of a feature in the space.

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 branch and/or a version within that target branch.

Default is: main:HEAD

Version references have the following syntax: `[<branchName (optional, default: main)>:][<version (optional, default: HEAD)>] | [<tagName> (optional)]` The "main"-branch is pointing to the space itself as it has been created in the first place. Defining the branch as part of the reference only becomes necessary if further branches have been created for the space, which should be addressed by the ref. 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.

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

Request body

typestring required

bboxnumber[]

Describes the coordinate range of the GeoJSON object.

idstring

The unique identifier 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.