woot! many thanks @jdalton why couldn't i find this in the API docs anywhere? such basic examples.