initial API defs written