I don't judge which functions should be in API. But I expect some procedure for function removal: deprecation, mention of alternatives etc. If function just work with string only then you can make it fails with wrong parameter types...