Link relation taxonomies:create-entry-bulk

Overview

A bulk call to create a set of entries in the taxonomy.

HTTP method

POST

URL template parameters

-

Query parameters

-

Request body

A JSON array. Each item of the array is a taxonomies:entry resource with the information you want to set. If an ID is given for the entry, 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 contains the new ID.

Example body for two entries of an MediaCentral Asset Management legal list:

[
  {
    "labels": {
      "en": "New entry"
    },
    "attributes": [
      {
        "name": "index",
        "value": 3
      }
    ]
  },
  {
    "labels": {
      "en": "2nd new entry"
    }
  }
]

HTTP response

201 Created

Response body

An array with one result entry for each given entry. For each successfully handled entry, the result entry contains:

  • success: true

  • data: a taxonomies:entry resource for the entry.

  • httpStatus (optional): the same HTTP status code that the non-bulk call would return. Here usually 201 (Created): the entry was created.

For each requested entry that caused an error:

  • success: false

  • httpStatus: same response code as for the taxonomies:entry-by-entryid link rel. Typical example: 404 (Not Found).

  • errorCode (string, optional): machine-readable error code that the non-bulk call would return for this item

  • errorMessage (optional, string): human-readable error message that the non-bulk call would return for this item

Example response (abbreviated):

[
  {
    "success": true,
    "data": {
      "id": "17",
      "labels": {
        "en": "New entry"
      },
      "attributes": [
        {
          "name": "index",
          "value": 3
        }
      ],
      "_links": { ... }
    },
    "httpStatus": 201
  },
  {
    "success": true,
    "data": {
      "id": "18",
      "labels": {
        "en": "2nd new entry"
      },
      "_links": { ... }
    },
    "httpStatus": 201
  }
]

Available in

Description

A bulk call to create a set of entries in the taxonomy.