complete api spec

Signed-off-by: Adam Stokes <adam.stokes@ubuntu.com>
v0.4