In trying to educate people on how to use the REST API, it's often helpful to "do the same thing" using the node-smartdc tools, and examine the POST payloads, for example.
I often do this by setting my SDC_URL to something like http://localhost:6666 , and then "catching" that request with "nc -l 6666" ... that's an ugly hack, though.
Could we get the equivalent of the debugging info you'd get from something like "curl -vvv" , so people could use the sdc-* commands, and see the REST traffic they generate? Right now, the --debug flag does nothing, it seems.