api: clarifying finickiness in scripting