api attribute optional