post http://localhost:9100/api/versioned/v1/projects//taxonomy/categories:bulk
Bulk creating categories takes the same form as creating one category. It requires a path for each category you want to add from the parent (root) to the category (node), including the category itself.
Each parent category must already exist. However, both parents and children can be created in the same call as long as the parent is created before the child in the ordering of the body. For example:
{"path":["Tier One Category"]}
{"path":["Tier One Category", "Tier Two Category"]}
{"path":["Another Tier One Category"]}
{"path":["Another Tier One Category", "Other Tier Two Category"]}
{"path":["Tier One Category", "Tier Two Category", "Tier Three Category"]}
The call returns an object with metadata concerning the creation.
Key | Value Description |
---|---|
numCategoriesCreated | The number of newly created categories. |
allCategoriesSuccessful | Boolean. True if all categories were successfully created or already exist. |
validationErrors | If the call fails, a detailed error message describing the issue. |