small API updates to use int instead of string