add description on variable interfaces in API section