Link relation taxonomies:create-or-update-entry

Overview

Create or update an entry of the taxonomy.

HTTP method

PUT

URL template parameters

-

Query parameters

-

Request body

A taxonomies:entry resource

  • If the ID of the entry is null or empty, a new top-level entry is created.

  • If the ID is given and the entry exists, the entry is updated. The updated entry may receive a new ID and have a new self link. A client must evaluate the response body to learn of the ID of the entry after the update.

  • If the ID is given, but the entry doesn’t exist, a new top-level entry is created. The created entry may have the given ID. However, the client must not rely on that, because the system may decide to assign a different ID and generate a different self link. The response will contain the new ID.

Example:

{
  "id": null,
  "labels": {
    "en": "test"
  }
}

HTTP response

200 OK

Success

201 Created

Created

404 Not Found

Response body

The updated or created entry.

Available in

Description

Create or update an entry of the taxonomy.