added state parameter to modify call
added samples with example calls