broke out the api-spec to seperate document
api-spec added, needs more details this is a draft