squeleton api, need to define the mandatory fields and default