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.
It's there, just got caught in GitHub's code folding thing