BUG-4268: clarify length constraint API contract