Create a taxonomy
POST/taxonomies
Creates a taxonomy. A taxonomy is independent of any pipeline, so one taxonomy can serve several pipelines. Entries are added with a separate operation. The response body is the new taxonomy.
Permissions. Write on the taxonomies object type. The key that creates the taxonomy receives read, write and execute permission on the new taxonomy.
See Metadata, filters and taxonomies.
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 422
The taxonomy was created. The body is the new taxonomy.
The body is not valid JSON.
The authentication headers are missing or invalid, or the API key is inactive or expired. Errors lists the messages.
The key lacks write permission on the taxonomies object type (Unauthorized: write access to Taxonomy required), the license is not valid (Invalid license: <reason>) or the license does not allow another taxonomy (License limits exceeded for Taxonomy).
A taxonomy with this name already exists (Conflict unique error).
The body does not match the request schema, for example a missing name or an unknown field.