adding scope example to api docs