I've just found out that this completely removes the envelope:
Code:
ok = reaper.SetEnvelopeStateChunk( env, "-", false )
Which is not documented. So, forget the FR above and please, just add to the documentation that passing "-" as a string, clears the envelope.