Updated docs

Added more specifications to the REST API section of docs.