api: document socket

needs to not have the 's' i.e "content" not "contents"