api optional vars