Skip to content
Rules/
/
Delete category
Last updated

Delete category

🔨 In Development — This section is still being developed and may change.
Permanently delete a custom rule category from your organization. This action cannot be undone and will affect how rules in this category are displayed and filtered.
DELETEhttps://api.freddy.aitronos.com/v1/organizations/{organization_id}/rules/categories/{category_id}

Remove a category from your organization. Categories can only be deleted if they contain no active rules. Default system categories cannot be deleted.

Path Parameters

organizationId string required

The organization identifier that owns the category.

category_id string required

The unique identifier of the category to delete. This is the name field from the category object.

Returns

A DeleteRuleResponse object containing the API response data.

Bash
curl -X DELETE "https://api.freddy.aitronos.com/v1/organizations/org_123/rules/categories/brand_voice" \
-H "Authorization: Bearer $FREDDY_API_KEY"

Response

Returns the deleted category object.

{
  "id": "cat_brand_voice_001",
  "name": "brand_voice",
  "display_name": "Brand Voice & Tone",
  "description": "Guidelines for maintaining consistent brand voice and communication style",
  "priority_range": "70-89",
  "recommended_limit": 4000,
  "rule_count": 0,
  "is_default": false,
  "is_active": false,
  "organization_id": "org_xyz789",
  "deleted_at": "2024-10-30T17:00:00Z",
  "deleted_by": "user_123",
  "created_by": "user_123",
  "created_at": "2024-10-04T12:00:00Z",
  "updated_at": "2024-10-04T12:00:00Z",
  "metadata": {
    "department": "marketing"
  }
}

Important Notes

  • Irreversible: Once deleted, categories cannot be recovered. Consider archiving important categories instead.
  • Active Rules: Categories containing active rules cannot be deleted. Move rules to other categories or delete them first.
  • System Categories: Default system categories (safety, professional, creative, technical, formatting, compliance) cannot be deleted.
  • Permissions: Organization and team categories require appropriate permissions. User categories can be deleted by their creator.
  • Audit Trail: All deletions are logged in the audit log with user attribution.
Previous page
Next page