Make `is_final` param optional

[aoudiamoncef]

• [x] document all added functions
• [x] try in sandbox /simulation/labnet
• [x] unit tests on the added/changed features
  • [x] make tests compile
  • [x] make tests pass
• [x] add logs allowing easy debugging in case the changes caused problems
• [x] if the API has changed, update the API specification

This PR assure backward compatibility with old API calls.