(feat) update the SDK according to the openapi spec

[xavierlacot]

Updated the SDK based on the latest spec updates - see jolicode/harvest-openapi-generator#27

• updated the spec according to the current documentation
• fixed several definitions