The API v3 object API is meant to be extremely low level. If you want to update a branch with a new commit, you'll have to:
* Create new blobs for the added/updated files.
* Create updated tree objects. This can get tedious. If you update a file in /a/b/c, there's at least 3 new tree objects that you'll need to update.
* Create a commit that points to the tree at /.
* Update the reference for that branch.
Whew! It's pretty clear we need some higher level API around viewing and updating files, like the Gist API.
Thanks for the feedback!