pending specs for API resource linkages