json api description

Signed-off-by: Tom Everett <tome@criticalmass.com>