FR & AP spec update

@TODO API specifications