Delete a taxonomy
delete
/content/management/api/v1.1/taxonomies/{id}
The following options can be used to delete versions of the taxonomy: draft, promoted or all.
Request
Path Parameters
-
id: string
id of the taxonomy.
Query Parameters
-
q(optional): string
This parameter accepts a query expression condition that matches the field values. Query conditions can be joined using AND operators and grouped with parentheses. The value of a query condition follows the format of {fieldName} {operator} "{fieldValue}". The only field name allowed is status. A query cannot include multiple status fieldNames.
If no value is provided for status it defaults to "promoted". When deleting a taxonomy, status can be equal to "draft", "promoted" or "all". If status is equals to "all", all versions of the taxonomy will be deleted.
The only value allowed in the operator is eq (Equals) for status.
When deleting a taxonomy, the query parameter should always be provided with the specific version to be deleted as the default status is "promoted".
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}?q=(status eq "draft")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}?q=(status eq "promoted")
Example:
https://{cecsdomain}/content/management/api/v1.1/taxonomies/{id}?q=(status eq "all")
A taxonomy cannot be published and a taxonomy cannot be assigned to any repository when deleting the "promoted" version.
Header Parameters
-
X-Requested-With: string
A custom header to mitigate CSRF attacks.Allowed Values:
[ "XMLHttpRequest" ]
Response
204 Response
OK.
400 Response
Bad request.
403 Response
Forbidden.
404 Response
Taxonomy not found. The requested resource not found.
409 Response
The requested resource operation is temporarily unavailable
500 Response
Internal server error.
Examples
The following example shows how to delete a taxonomy by submitting a DELETE request on the REST resource using cURL.
curl -i -X DELETE -H 'X-Requested-With: XMLHttpRequest' 'https://host:port/content/management/api/v1.1/taxonomies/{id}?q=(status eq \"draft\")'
Example:
This deletes a taxonomy identified by the taxonomy ID.
Note:
Only draft taxonomies can be deleted. Therefore, the query field status must be specified as draft./content/management/api/v1.1/taxonomies/3F6C5D0EEFDD4C34B9908EB996696BE1?q=(status eq \"draft\")"