post http://<host>:9100/api/versioned/v1/projects//taxonomy/categories
Create a category and add it to a categorization project
Creating a category only requires the path from the parent to the category, including the category. The name field is completely optional, and will be overwritten by the last item in the path.
{
"name": "Tier Two Category",
"path": [
"Tier One Category",
"Tier Two Category"
]
}
Parents and Paths
Creating a category will only be successful if the parent categories in the path have all already been created.
Response Fields
Retrieving a category will return a JSON object made up of information describing the category.
| Field | Description |
|---|---|
| id | The ID of the category. Unique across the entire deployment of Tamr. Ends with the numeric ID, which is the id that will be used for other dataset API operations. |
| name | The name of the category. |
| parent | The ID of the parent category. Only included if the node has a parent. |
| path | The path, by name, to the category. If the category has no parent, the list will only contain the category itself. |
| created | Metadata about the creation of the category. |
| lastModified | Metadata about the most recent modification of the category. |
| relativeId | The ID of the category stripped of the instance name. This ID can be used in API calls. |