add conditional for query params and required fields
fill out all example requests and responses for every resource