Updated REST API docs

Just an update to docs ok to [merge]