Hierarchy Validator

List recent validation results for an organization

{
  "data": [
    {
      "validation_id": "val-001",
      "organization_id": "org-42",
      "check_type": "no_circle",
      "passed": true,
      "checked_at": "2026-03-25T08:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5
  }
}

Get a specific validation result

{
  "validation_id": "val-001",
  "organization_id": "org-42",
  "unit_id": "unit-002",
  "check_type": "no_circle",
  "passed": true,
  "details": null,
  "checked_at": "2026-03-25T08:00:00Z"
}

Validate that setting a new parent does not create a circular reference

{
  "unit_id": "unit-019",
  "new_parent_id": "unit-002"
}

{
  "valid": true,
  "unit_id": "unit-019",
  "new_parent_id": "unit-002",
  "message": "No circular reference detected"
}

Validate that adding a unit does not exceed max hierarchy depth

{
  "unit_id": "unit-019",
  "max_depth": 4
}

{
  "valid": true,
  "unit_id": "unit-019",
  "current_depth": 2,
  "max_depth": 4,
  "message": "Depth within allowed limit"
}

Validate that deleting a unit leaves no orphaned children

{
  "deleted_unit_id": "unit-019"
}

{
  "valid": false,
  "deleted_unit_id": "unit-019",
  "orphaned_children": [
    "unit-030",
    "unit-031"
  ],
  "message": "Deletion would orphan 2 child units"
}

Update a validation record (e.g. annotate with resolution)

{
  "resolution_note": "Orphans reassigned to unit-001 before deletion"
}

{
  "validation_id": "val-009",
  "resolution_note": "Orphans reassigned to unit-001 before deletion",
  "updated_at": "2026-03-26T15:00:00Z"
}

Delete a validation log entry

{
  "deleted": true,
  "validation_id": "val-001"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}