a few small api specs