Update docs

@lob/api-engineering-lobsters ready for review. I kept the API.md separate but can merge it if that seems better to you guys. IMO, easier to read this way.
I think for a developer it is more likely to be searched by "jobs" since that is the endpoint