update API with relationship methods