Delete Union

​

Authentication

Authorization: Bearer <token>

​

Authorization

​

Path Parameters

​

Response

​

Example Request

curl --request DELETE \
  --url https://api.example.com/api/unions/clx9876543210 \
  --header 'Authorization: Bearer <token>'

​

Example Response

{
  "success": true,
  "message": "Union deleted successfully"
}

​

Error Responses

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Access denied. Admin privileges required."
}

{
  "success": false,
  "message": "Union not found"
}

{
  "success": false,
  "message": "Failed to delete union"
}

​

Important Notes

​

Soft Delete Behavior

• The union record is not physically removed from the database
• The deletedAt field is set to the current timestamp
• The union will no longer appear in normal queries
• Related records (union members, loans) are preserved for historical data
• Audit logs maintain complete history

​

Cascade Considerations

• Union Members: Members associated with this union should be reassigned to another union first
• Loans: Active loans associated with this union may prevent deletion
• Audit Trail: All historical data and audit logs remain intact

​

Best Practices

1. Reassign Members First: Use the union member reassignment endpoint to move all members to another union
2. Check Active Loans: Ensure no active loans are associated with the union
3. Document Reason: Consider adding a note in audit logs explaining the deletion reason
4. Use Reassignment Instead: For organizational changes, consider reassigning the union to a different credit officer instead of deleting

​

Audit Log

• Actor user ID (admin who performed the deletion)
• Timestamp of deletion
• Union details before deletion
• IP address and user agent information

​

Related Endpoints

• To reassign union members before deletion: POST /api/union-members/:memberId/reassign
• To view audit history: Check AuditLog records for this union ID
• To assign union to different officer: POST /api/unions/:unionId/assign