api spec / formatting