API specs

Signed-off-by: Jean-Denis Vauguet <jd@vauguet.fr>