add guardrails to specific apis/types to ensure paths are right type

now that the specific apis are available- we should add guardrails and type safety to ensure that folks have passed the path type they tell us they passed. the agnostic api is stringly typed to give input flexibility, but the specific APIs should use Path and URL