post http://<host>:9100/api/versioned/POST /v1/projects//taxonomy/categories:bulk
Bulk upload categories to a categorization project
Bulk creating categories takes the same form as creating one category. It only requires the full path from the parent (root) to the category (node), including the category itself.
When creating a category with a parent, the parent category must already exist to be successful. 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"]}
Response Fields
If the call is successful, it will return metadata concerning the creation.
| Field | Description |
|---|---|
| numCategoriesCreated | The number of newly created categories. |
| allCategoriesSuccessful | Boolean. True if all categories were successfully created or already exist. |
If the call fails, it will attempt to return a detailed error message describing the issue.