/api/taxonomies
POST
Adds a new taxonomy archive given one or more entrypoints. The taxonomy archive is identified with an Archive ID (AID).
Parameters
| Name | Type | Description | Profile |
|---|---|---|---|
| profile-name | query | Specifies which profile to use, which will enable some parameters or modify hypercube queries accordingly. The default depends on the underlying repository | |
| format | query | Returns the results in the supplied format | |
| token | query | The token that allows you to use this API. Gives you read (GET) and/or write (POST, DELETE, PATCH) credentials. | |
| aid | query | Archive ID of the archive or taxonomy. | |
| eid | query | The EID (scheme + local name) of a company, to add a new taxonomy. | |
| timeout | query | Timeout for the operation. | |
| entrypoint | query | The URI of a taxonomy entrypoint. | |
| insert-entity | query | If false, and one or more of the archive entities are not present in the repository an error is raised. If true, the missing entity is inserted. (Default is true) |
Status codes
| Code | Description |
|---|---|
| 200 | Taxonomy archive has been added. |
| 400 | One of the supplied entrypoints is invalid. |
| 401 | Unauthorized: the specified project token is invalid, expired, or has insufficient privileges. |
| 403 | Access denied. |
| 404 | No such entity could be found. |
| 409 | Taxonomy archive already exists. |
| 500 | An internal error occurred during the processing of the request. |