Delete a category group

DELETE

/content/management/v1/taxonomy/groups/{id}

const url = 'https://api.ebitex.io/content/management/v1/taxonomy/groups/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.ebitex.io/content/management/v1/taxonomy/groups/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

Deletes an empty group from the organization’s vocabulary, along with its metadata definition here. Nothing is deleted on your behalf: delete the group’s categories first, remove the group from any category field that restricts its values to it, and remove it from every other environment that uses it. The group is not silently removed from this environment when the delete is refused.

Key: a management key with content.management.authoring.

Authorizations

apiKey

Parameters

Path Parameters

required

string format: uuid

Responses

204

401

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired.

402

payment_required: the organization’s subscription needs attention.

403

permission_denied: the key’s role lacks content.taxonomy.manage. permission_denied: the key’s role lacks platform.taxonomy.manage, which changing the organization’s category groups and categories needs.

scope_denied: the key lacks this route’s scope. tier_required: the Content Management API needs the Pro plan or above. ip_denied: the caller’s address is outside the key’s allowed ranges. app_not_available: Content is not enabled for the organization.

404

No group has this id in the key’s environment.

409

group_not_empty: the group still has categories. group_in_use: another environment or app still uses the group — a contract’s category field names it, or an environment has added it; usages lists each usage as { sourceKind, sourceId, app, environmentId, environmentName, displayName }, gathered from every app that classifies with the vocabulary — app is content or assets, and environmentId/environmentName are set for a usage inside an environment. taxonomy_read_only: the group or category comes from a content provider and changes only when that provider is refreshed. inherited_read_only: the item is owned by a realm above the key’s own and can only be changed there; ownerRealmId names it.

429

Rate limit or quota exceeded; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.