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.
k