WHISTLE-1510: add api_object(s) type, udpate spec / formatting