Sign in
Write Features

Create or replace multiple features

Create or replace the provided features.

put/spaces/{spaceId}/features

Path parameters

spaceIdstring required

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

<br> Version references have the following syntax: <br> `[<branchName (optional, default: main)>:][<version (optional, default: HEAD)>] | [<tagName> (optional)]` <br> 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. <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: - `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

Response

An array of features and their modifications response.

Changes

Changed in 10 of the 50 revisions of this API.919

  • f8364de657ab1See the full diff
    • ○

      added the new optional query request parameter versionRef

      new-optional-request-parameter

  • 539d9580be991See the full diff
    • ▲

      for the query request parameter versionRef, default value main:HEAD was added

      request-parameter-default-value-added

  • c656e0e4c8dc11See the full diff
    • ▲

      removed the media type text/plain for the response with the status

      response-media-type-removed

    • ○

      added the media type application/json for the response with the status

      response-media-type-added

  • 5e6d40a27f1511See the full diff
    • ▲

      removed the media type text/plain for the response with the status

      response-media-type-removed

    • ○

      added the media type application/json for the response with the status

      response-media-type-added

  • 9af744fff11911See the full diff
    • ▲

      removed the media type application/json for the response with the status

      response-media-type-removed

    • ○

      added the media type text/plain for the response with the status

      response-media-type-added

  • ecac6e7956321See the full diff
    • ○

      added the media type application/x-empty for the response with the status

      response-media-type-added

  • ac66f55537d81See the full diff
    • ○

      media type application/json was changed to a more specific media type application/geo+json for the response status

      response-media-type-name-specialized

  • 15451501d2f431See the full diff
    • ▲

      media type application/geo+json was changed to a more general media type application/json for the response status

      response-media-type-name-generalized

    • ▲

      removed the media type application/x-empty for the response with the status

      response-media-type-removed

    • ▲

      removed the media type text/plain for the response with the status

      response-media-type-removed

    • ○

      added the media type application/json for the response with the status

      response-media-type-added

  • fc65c020795311See the full diff
    • ▲

      removed the media type application/json for the response with the status

      response-media-type-removed

    • ○

      added the media type text/plain for the response with the status

      response-media-type-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • fb8e107462aa111See the full diff
    • ▲

      removed the media type application/json for the response with the status

      response-media-type-removed

    • ●

      deleted the query request parameter versionRef

      request-parameter-removed

    • ○

      added the media type text/plain for the response with the status

      response-media-type-added

    This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog