flat_api 0.3.5 → 1.0.0

data/lib/flat_api/api/score_api.rb

@@ -1,12 +1,12 @@
 =begin
 #Flat API
 
-#The Flat API allows you to easily extend the abilities of the [Flat Platform](https://flat.io), with a wide range of use cases including the following:  * Creating and importing new music scores using MusicXML, MIDI, Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar and MuseScore files * Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI) * Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.  The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. The [schema](/swagger.yaml) of this API follows the [OpenAPI Initiative (OAI) specification](https://www.openapis.org/), you can use and work with [compatible Swagger tools](http://swagger.io/open-source-integrations/). This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/).  You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is [available on Github](https://github.com/FlatIO/api-reference).  Getting Started and learn more:  * [API Overview and introduction](https://flat.io/developers/docs/api/) * [Authentication (Personal Access Tokens or OAuth2)](https://flat.io/developers/docs/api/authentication.html) * [SDKs](https://flat.io/developers/docs/api/sdks.html) * [Rate Limits](https://flat.io/developers/docs/api/rate-limits.html) * [Changelog](https://flat.io/developers/docs/api/changelog.html) 
+#The Flat API allows you to easily extend the abilities of the [Flat Platform](https://flat.io), with a wide range of use cases including the following:  * Creating and importing new music scores using MusicXML, MIDI, Guitar Pro, MuseScore, ABC notation, and many other formats * Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI) * Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.  The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. The [schema](/swagger.yaml) of this API follows the [OpenAPI Initiative (OAI) specification](https://www.openapis.org/), you can use and work with [compatible Swagger tools](http://swagger.io/open-source-integrations/). This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/).  You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is [available on Github](https://github.com/FlatIO/api-reference).  Getting Started and learn more:  * [API Overview and introduction](https://flat.io/developers/docs/api/) * [Authentication (Personal Access Tokens or OAuth2)](https://flat.io/developers/docs/api/authentication.html) * [SDKs](https://flat.io/developers/docs/api/sdks.html) * [Rate Limits](https://flat.io/developers/docs/api/rate-limits.html) * [Changelog](https://flat.io/developers/docs/api/changelog.html) 
 
-The version of the OpenAPI document: 2.20.0
+The version of the OpenAPI document: 2.26.1
 Contact: developers@flat.io
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 7.3.0
+Generator version: 7.24.0
 
 =end
 
@@ -49,7 +49,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'body' when calling ScoreApi.add_score_collaborator"
       end
       # resource path
-      local_var_path = '/scores/{score}/collaborators'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/collaborators'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -57,7 +57,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -98,7 +98,7 @@ module FlatApi
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. `ScoreDetails.id`) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with `drive-` (e.g. `drive-0B000000000`). 
     # @param body [ScoreTrackCreation] 
     # @param [Hash] opts the optional parameters
-    # @return [ScoreTrack]
+    # @return [ScoreTrackCreationResponse]
     def add_score_track(score, body, opts = {})
       data, _status_code, _headers = add_score_track_with_http_info(score, body, opts)
       data
@@ -109,7 +109,7 @@ module FlatApi
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. `ScoreDetails.id`) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with `drive-` (e.g. `drive-0B000000000`). 
     # @param body [ScoreTrackCreation] 
     # @param [Hash] opts the optional parameters
-    # @return [Array<(ScoreTrack, Integer, Hash)>] ScoreTrack data, response status code and response headers
+    # @return [Array<(ScoreTrackCreationResponse, Integer, Hash)>] ScoreTrackCreationResponse data, response status code and response headers
     def add_score_track_with_http_info(score, body, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ScoreApi.add_score_track ...'
@@ -123,7 +123,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'body' when calling ScoreApi.add_score_track"
       end
       # resource path
-      local_var_path = '/scores/{score}/tracks'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/tracks'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -131,7 +131,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -145,7 +145,7 @@ module FlatApi
       post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'ScoreTrack'
+      return_type = opts[:debug_return_type] || 'ScoreTrackCreationResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['OAuth2']
@@ -212,7 +212,7 @@ module FlatApi
         fail ArgumentError, "invalid value for \"format\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/scores/{score}/revisions/{revision}/{format}/task'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'revision' + '}', CGI.escape(revision.to_s)).sub('{' + 'format' + '}', CGI.escape(format.to_s))
+      local_var_path = '/scores/{score}/revisions/{revision}/{format}/task'.sub('{score}', CGI.escape(score.to_s)).sub('{revision}', CGI.escape(revision.to_s)).sub('{format}', CGI.escape(format.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -221,7 +221,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -258,7 +258,7 @@ module FlatApi
     end
 
     # Create a new score
-    # Use this API method to **create a new music score in the current User account**. This API endpoints provides 3 ways to create scores:  * `ScoreCreationBuilderData` : Create a blank score by providing the list of instruments to use. You can optionally customize the initial key signature, time signature, enable TABs, Chord grids, as well as the page layout. * `ScoreCreationFileImport`: Import an existing MusicXML 3 file (`vnd.recordare.musicxml` or `vnd.recordare.musicxml+xml`), a MIDI file (`audio/midi`), Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar, or MuseScore file to create the new Flat document. * `ScoreCreationGoogleDriveImport`: Import an existing Google Drive file from the connected Google Drive account.  This API call will automatically create the first revision of the document, the score can be modified by the using our web application or by uploading a new revision of this file (`POST /v2/scores/{score}/revisions/{revision}`).  The currently authenticated user will be granted owner of the file and will be able to add other collaborators (users and groups).  If no `collection` is specified, the API will create the score in the most appropriate collection. When using an OAuth2 access token or a personal token, the score will be automatically added to your dedicated app collection in the account (`/v2/collections/app`).  If a `collection` is specified and this one has more public privacy settings than the score (e.g. `public` vs `private` for the score), the privacy settings of the created score will be adjusted to the collection ones.  You can check the adjusted privacy settings in the returned score `privacy`, and optionally adjust these settings if needed using `PUT /scores/{score}`. 
+    # Use this API method to **create a new music score in the current User account**. This API endpoints provides 3 ways to create scores:  * `ScoreCreationBuilderData` : Create a blank score by providing the list of instruments to use. You can optionally customize the initial key signature, time signature, enable TABs, Chord grids, as well as the page layout. * `ScoreCreationFileImport`: Import a file to create the new Flat document.    **Preferred formats**:   * **MusicXML**: `.xml`, `.musicxml`, `.mxl` (compressed) — MIME: `vnd.recordare.musicxml+xml`, `vnd.recordare.musicxml`. This is the only format that preserves all notation data (articulations, dynamics, layout, etc.) with full round-trip support.   * **MIDI**: `.mid`, `.midi` — MIME: `audio/midi`. Only preserves pitch, timing, and instrument data; notation details are lost.    **Also supported** (converted to MusicXML on import, some notation details may be lost):   * **Guitar Pro**: `.gp`, `.gp3`, `.gp4`, `.gp5`, `.gpx`, `.gtp`   * **MuseScore**: `.mscz`, `.mscx`   * **Finale**: `.musx`   * **ABC notation**: `.abc` — MIME: `text/vnd.abc`   * **PowerTab**: `.ptb`   * **Capella**: `.cap`, `.capx`   * **MEI**: `.mei`   * **Overture**: `.ove`   * **TablEdit**: `.tef`   * **Band-in-a-Box**: `.mgu`, `.sgu`   * **Karaoke MIDI**: `.kar`   * **MuseData**: `.md`   * **Score Writer**: `.scw`   * **Bagpipe Music Writer**: `.bmw`, `.bww`   * **Encore**: `.enc`    **Scanned music** (requires `supportsTasks`, runs our music recognition and spends   credits):   * **PDF**: `.pdf`   * **Images**: `.jpg`, `.png`, `.webp`, `.tiff`, `.gif`, `.avif`, `.heic`, `.heif`    The file is identified by its own content, so its extension and any declared type do   not have to match. **One file per request**: a multi-page PDF or a multi-frame TIFF is   fine, but several separate images of the same score (a page photographed at a time)   need `createOmrJob`, which takes many inputs in one job and bills them as a single   document. Its live limits are served by `getOmrCapabilities`. * `ScoreCreationGoogleDriveImport`: Import an existing Google Drive file from the connected Google Drive account.  This API call will automatically create the first revision of the document, the score can be modified by the using our web application or by uploading a new revision of this file (`POST /v2/scores/{score}/revisions/{revision}`).  The currently authenticated user will be granted owner of the file and will be able to add other collaborators (users and groups).  If no `collection` is specified, the API will create the score in the most appropriate collection. When using an OAuth2 access token or a personal token, the score will be automatically added to your dedicated app collection in the account (`/v2/collections/app`).  If a `collection` is specified and this one has more public privacy settings than the score (e.g. `public` vs `private` for the score), the privacy settings of the created score will be adjusted to the collection ones.  You can check the adjusted privacy settings in the returned score `privacy`, and optionally adjust these settings if needed using `PUT /scores/{score}`. 
     # @param body [ScoreCreation] 
     # @param [Hash] opts the optional parameters
     # @return [ScoreDetails]
@@ -268,7 +268,7 @@ module FlatApi
     end
 
     # Create a new score
-    # Use this API method to **create a new music score in the current User account**. This API endpoints provides 3 ways to create scores:  * &#x60;ScoreCreationBuilderData&#x60; : Create a blank score by providing the list of instruments to use. You can optionally customize the initial key signature, time signature, enable TABs, Chord grids, as well as the page layout. * &#x60;ScoreCreationFileImport&#x60;: Import an existing MusicXML 3 file (&#x60;vnd.recordare.musicxml&#x60; or &#x60;vnd.recordare.musicxml+xml&#x60;), a MIDI file (&#x60;audio/midi&#x60;), Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar, or MuseScore file to create the new Flat document. * &#x60;ScoreCreationGoogleDriveImport&#x60;: Import an existing Google Drive file from the connected Google Drive account.  This API call will automatically create the first revision of the document, the score can be modified by the using our web application or by uploading a new revision of this file (&#x60;POST /v2/scores/{score}/revisions/{revision}&#x60;).  The currently authenticated user will be granted owner of the file and will be able to add other collaborators (users and groups).  If no &#x60;collection&#x60; is specified, the API will create the score in the most appropriate collection. When using an OAuth2 access token or a personal token, the score will be automatically added to your dedicated app collection in the account (&#x60;/v2/collections/app&#x60;).  If a &#x60;collection&#x60; is specified and this one has more public privacy settings than the score (e.g. &#x60;public&#x60; vs &#x60;private&#x60; for the score), the privacy settings of the created score will be adjusted to the collection ones.  You can check the adjusted privacy settings in the returned score &#x60;privacy&#x60;, and optionally adjust these settings if needed using &#x60;PUT /scores/{score}&#x60;. 
+    # Use this API method to **create a new music score in the current User account**. This API endpoints provides 3 ways to create scores:  * &#x60;ScoreCreationBuilderData&#x60; : Create a blank score by providing the list of instruments to use. You can optionally customize the initial key signature, time signature, enable TABs, Chord grids, as well as the page layout. * &#x60;ScoreCreationFileImport&#x60;: Import a file to create the new Flat document.    **Preferred formats**:   * **MusicXML**: &#x60;.xml&#x60;, &#x60;.musicxml&#x60;, &#x60;.mxl&#x60; (compressed) — MIME: &#x60;vnd.recordare.musicxml+xml&#x60;, &#x60;vnd.recordare.musicxml&#x60;. This is the only format that preserves all notation data (articulations, dynamics, layout, etc.) with full round-trip support.   * **MIDI**: &#x60;.mid&#x60;, &#x60;.midi&#x60; — MIME: &#x60;audio/midi&#x60;. Only preserves pitch, timing, and instrument data; notation details are lost.    **Also supported** (converted to MusicXML on import, some notation details may be lost):   * **Guitar Pro**: &#x60;.gp&#x60;, &#x60;.gp3&#x60;, &#x60;.gp4&#x60;, &#x60;.gp5&#x60;, &#x60;.gpx&#x60;, &#x60;.gtp&#x60;   * **MuseScore**: &#x60;.mscz&#x60;, &#x60;.mscx&#x60;   * **Finale**: &#x60;.musx&#x60;   * **ABC notation**: &#x60;.abc&#x60; — MIME: &#x60;text/vnd.abc&#x60;   * **PowerTab**: &#x60;.ptb&#x60;   * **Capella**: &#x60;.cap&#x60;, &#x60;.capx&#x60;   * **MEI**: &#x60;.mei&#x60;   * **Overture**: &#x60;.ove&#x60;   * **TablEdit**: &#x60;.tef&#x60;   * **Band-in-a-Box**: &#x60;.mgu&#x60;, &#x60;.sgu&#x60;   * **Karaoke MIDI**: &#x60;.kar&#x60;   * **MuseData**: &#x60;.md&#x60;   * **Score Writer**: &#x60;.scw&#x60;   * **Bagpipe Music Writer**: &#x60;.bmw&#x60;, &#x60;.bww&#x60;   * **Encore**: &#x60;.enc&#x60;    **Scanned music** (requires &#x60;supportsTasks&#x60;, runs our music recognition and spends   credits):   * **PDF**: &#x60;.pdf&#x60;   * **Images**: &#x60;.jpg&#x60;, &#x60;.png&#x60;, &#x60;.webp&#x60;, &#x60;.tiff&#x60;, &#x60;.gif&#x60;, &#x60;.avif&#x60;, &#x60;.heic&#x60;, &#x60;.heif&#x60;    The file is identified by its own content, so its extension and any declared type do   not have to match. **One file per request**: a multi-page PDF or a multi-frame TIFF is   fine, but several separate images of the same score (a page photographed at a time)   need &#x60;createOmrJob&#x60;, which takes many inputs in one job and bills them as a single   document. Its live limits are served by &#x60;getOmrCapabilities&#x60;. * &#x60;ScoreCreationGoogleDriveImport&#x60;: Import an existing Google Drive file from the connected Google Drive account.  This API call will automatically create the first revision of the document, the score can be modified by the using our web application or by uploading a new revision of this file (&#x60;POST /v2/scores/{score}/revisions/{revision}&#x60;).  The currently authenticated user will be granted owner of the file and will be able to add other collaborators (users and groups).  If no &#x60;collection&#x60; is specified, the API will create the score in the most appropriate collection. When using an OAuth2 access token or a personal token, the score will be automatically added to your dedicated app collection in the account (&#x60;/v2/collections/app&#x60;).  If a &#x60;collection&#x60; is specified and this one has more public privacy settings than the score (e.g. &#x60;public&#x60; vs &#x60;private&#x60; for the score), the privacy settings of the created score will be adjusted to the collection ones.  You can check the adjusted privacy settings in the returned score &#x60;privacy&#x60;, and optionally adjust these settings if needed using &#x60;PUT /scores/{score}&#x60;. 
     # @param body [ScoreCreation] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(ScoreDetails, Integer, Hash)>] ScoreDetails data, response status code and response headers
@@ -289,7 +289,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -355,7 +355,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'body' when calling ScoreApi.create_score_revision"
       end
       # resource path
-      local_var_path = '/scores/{score}/revisions'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/revisions'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -363,7 +363,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -400,7 +400,7 @@ module FlatApi
     end
 
     # Delete a score
-    # This method can be used by the owner/admin (`aclAdmin` rights) of a score as well as regular collaborators.  When called by an owner/admin, it will schedule the deletion of the score, its revisions, and complete history. The score won't be accessible anymore after calling this method and the user's quota will directly be updated.  When called by a regular collaborator (`aclRead` / `aclWrite`), the score will be unshared (i.e. removed from the account & own collections). 
+    # This method can be used by anyone that has at least read access to the document:  - When called by an owner/admin, it will schedule the deletion of the score, its revisions, and complete history. The score won't be accessible anymore after calling this method and the user's quota will directly be updated. - When called by a collaborator, the score will be unshared (i.e. removed from the account & own collections). - When called by another user that has the score in its collections, the score will be removed from all the user collections. 
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :now If &#x60;true&#x60;, the score deletion will be scheduled to be done ASAP (default to false)
@@ -411,7 +411,7 @@ module FlatApi
     end
 
     # Delete a score
-    # This method can be used by the owner/admin (&#x60;aclAdmin&#x60; rights) of a score as well as regular collaborators.  When called by an owner/admin, it will schedule the deletion of the score, its revisions, and complete history. The score won&#39;t be accessible anymore after calling this method and the user&#39;s quota will directly be updated.  When called by a regular collaborator (&#x60;aclRead&#x60; / &#x60;aclWrite&#x60;), the score will be unshared (i.e. removed from the account &amp; own collections). 
+    # This method can be used by anyone that has at least read access to the document:  - When called by an owner/admin, it will schedule the deletion of the score, its revisions, and complete history. The score won&#39;t be accessible anymore after calling this method and the user&#39;s quota will directly be updated. - When called by a collaborator, the score will be unshared (i.e. removed from the account &amp; own collections). - When called by another user that has the score in its collections, the score will be removed from all the user collections. 
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :now If &#x60;true&#x60;, the score deletion will be scheduled to be done ASAP (default to false)
@@ -425,7 +425,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'score' when calling ScoreApi.delete_score"
       end
       # resource path
-      local_var_path = '/scores/{score}'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -434,7 +434,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -469,6 +469,7 @@ module FlatApi
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param comment [String] Unique identifier of a sheet music comment 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :event_properties Optional analytics properties merged into XP tracking for this request.  JSON-encoded string representing event properties. Example:  - &#x60;?eventProperties&#x3D;{\&quot;context\&quot;:\&quot;discover\&quot;,\&quot;screenLevel0\&quot;:\&quot;home\&quot;}&#x60; 
     # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
     # @return [nil]
     def delete_score_comment(score, comment, opts = {})
@@ -480,6 +481,7 @@ module FlatApi
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param comment [String] Unique identifier of a sheet music comment 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :event_properties Optional analytics properties merged into XP tracking for this request.  JSON-encoded string representing event properties. Example:  - &#x60;?eventProperties&#x3D;{\&quot;context\&quot;:\&quot;discover\&quot;,\&quot;screenLevel0\&quot;:\&quot;home\&quot;}&#x60; 
     # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def delete_score_comment_with_http_info(score, comment, opts = {})
@@ -495,16 +497,22 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'comment' when calling ScoreApi.delete_score_comment"
       end
       # resource path
-      local_var_path = '/scores/{score}/comments/{comment}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'comment' + '}', CGI.escape(comment.to_s))
+      local_var_path = '/scores/{score}/comments/{comment}'.sub('{score}', CGI.escape(score.to_s)).sub('{comment}', CGI.escape(comment.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'eventProperties'] = opts[:'event_properties'] if !opts[:'event_properties'].nil?
       query_params[:'sharingKey'] = opts[:'sharing_key'] if !opts[:'sharing_key'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/x-www-form-urlencoded'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -563,7 +571,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'track' when calling ScoreApi.delete_score_track"
       end
       # resource path
-      local_var_path = '/scores/{score}/tracks/{track}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'track' + '}', CGI.escape(track.to_s))
+      local_var_path = '/scores/{score}/tracks/{track}'.sub('{score}', CGI.escape(score.to_s)).sub('{track}', CGI.escape(track.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -571,7 +579,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -632,7 +640,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'body' when calling ScoreApi.edit_score"
       end
       # resource path
-      local_var_path = '/scores/{score}'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -640,7 +648,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -708,7 +716,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'body' when calling ScoreApi.fork_score"
       end
       # resource path
-      local_var_path = '/scores/{score}/fork'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/fork'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -717,7 +725,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -779,7 +787,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'group' when calling ScoreApi.get_group_scores"
       end
       # resource path
-      local_var_path = '/groups/{group}/scores'.sub('{' + 'group' + '}', CGI.escape(group.to_s))
+      local_var_path = '/groups/{group}/scores'.sub('{group}', CGI.escape(group.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -788,7 +796,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -845,7 +853,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'score' when calling ScoreApi.get_score"
       end
       # resource path
-      local_var_path = '/scores/{score}'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -854,7 +862,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -917,7 +925,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'collaborator' when calling ScoreApi.get_score_collaborator"
       end
       # resource path
-      local_var_path = '/scores/{score}/collaborators/{collaborator}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'collaborator' + '}', CGI.escape(collaborator.to_s))
+      local_var_path = '/scores/{score}/collaborators/{collaborator}'.sub('{score}', CGI.escape(score.to_s)).sub('{collaborator}', CGI.escape(collaborator.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -926,7 +934,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -983,7 +991,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'score' when calling ScoreApi.get_score_collaborators"
       end
       # resource path
-      local_var_path = '/scores/{score}/collaborators'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/collaborators'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -992,7 +1000,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1027,10 +1035,10 @@ module FlatApi
     # This method lists the different comments added on a music score (documents and inline) sorted by their post dates.
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
     # @option opts [String] :type Filter the comments by type
     # @option opts [String] :sort Sort
     # @option opts [String] :direction Sort direction
+    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
     # @return [Array<ScoreComment>]
     def get_score_comments(score, opts = {})
       data, _status_code, _headers = get_score_comments_with_http_info(score, opts)
@@ -1041,10 +1049,10 @@ module FlatApi
     # This method lists the different comments added on a music score (documents and inline) sorted by their post dates.
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
     # @option opts [String] :type Filter the comments by type
     # @option opts [String] :sort Sort
     # @option opts [String] :direction Sort direction
+    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
     # @return [Array<(Array<ScoreComment>, Integer, Hash)>] Array<ScoreComment> data, response status code and response headers
     def get_score_comments_with_http_info(score, opts = {})
       if @api_client.config.debugging
@@ -1067,19 +1075,19 @@ module FlatApi
         fail ArgumentError, "invalid value for \"direction\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/scores/{score}/comments'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/comments'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'sharingKey'] = opts[:'sharing_key'] if !opts[:'sharing_key'].nil?
       query_params[:'type'] = opts[:'type'] if !opts[:'type'].nil?
       query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
       query_params[:'direction'] = opts[:'direction'] if !opts[:'direction'].nil?
+      query_params[:'sharingKey'] = opts[:'sharing_key'] if !opts[:'sharing_key'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1142,7 +1150,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'revision' when calling ScoreApi.get_score_revision"
       end
       # resource path
-      local_var_path = '/scores/{score}/revisions/{revision}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'revision' + '}', CGI.escape(revision.to_s))
+      local_var_path = '/scores/{score}/revisions/{revision}'.sub('{score}', CGI.escape(score.to_s)).sub('{revision}', CGI.escape(revision.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1151,7 +1159,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1183,7 +1191,7 @@ module FlatApi
     end
 
     # Get a score revision data
-    # Retrieve the file corresponding to a score revision (the following formats are available): Flat JSON/Adagio JSON `json`, MusicXML `mxl`/`xml`, MP3 `mp3`, WAV `wav`, MIDI `midi`, a tumbnail of the first page `thumbnail.png` or auto sync points `synchronizationPoints`. 
+    # Retrieve the file corresponding to a score revision (the following formats are available): Flat JSON/Adagio JSON `json`, MusicXML `mxl`/`xml`, ABC notation `abc`, MP3 `mp3`, WAV `wav`, MIDI `midi`, Flat `flat`, a tumbnail of the first page `thumbnail.png` or auto sync points `synchronizationPoints`.  ABC notation is a text format that cannot express everything a score contains. Like MIDI, the export is lossy: notation ABC has no equivalent for is approximated or dropped rather than failing the request. 
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param revision [String] Unique identifier of a score revision. You can use &#x60;last&#x60; to fetch the information related to the last version created. 
     # @param format [String] The format of the file you will retrieve
@@ -1199,7 +1207,7 @@ module FlatApi
     end
 
     # Get a score revision data
-    # Retrieve the file corresponding to a score revision (the following formats are available): Flat JSON/Adagio JSON &#x60;json&#x60;, MusicXML &#x60;mxl&#x60;/&#x60;xml&#x60;, MP3 &#x60;mp3&#x60;, WAV &#x60;wav&#x60;, MIDI &#x60;midi&#x60;, a tumbnail of the first page &#x60;thumbnail.png&#x60; or auto sync points &#x60;synchronizationPoints&#x60;. 
+    # Retrieve the file corresponding to a score revision (the following formats are available): Flat JSON/Adagio JSON &#x60;json&#x60;, MusicXML &#x60;mxl&#x60;/&#x60;xml&#x60;, ABC notation &#x60;abc&#x60;, MP3 &#x60;mp3&#x60;, WAV &#x60;wav&#x60;, MIDI &#x60;midi&#x60;, Flat &#x60;flat&#x60;, a tumbnail of the first page &#x60;thumbnail.png&#x60; or auto sync points &#x60;synchronizationPoints&#x60;.  ABC notation is a text format that cannot express everything a score contains. Like MIDI, the export is lossy: notation ABC has no equivalent for is approximated or dropped rather than failing the request. 
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param revision [String] Unique identifier of a score revision. You can use &#x60;last&#x60; to fetch the information related to the last version created. 
     # @param format [String] The format of the file you will retrieve
@@ -1226,12 +1234,12 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'format' when calling ScoreApi.get_score_revision_data"
       end
       # verify enum value
-      allowable_values = ["json", "mxl", "xml", "mp3", "wav", "midi", "thumbnail.png", "synchronizationPoints"]
+      allowable_values = ["json", "mxl", "xml", "abc", "mp3", "wav", "midi", "flat", "thumbnail.png", "synchronizationPoints"]
       if @api_client.config.client_side_validation && !allowable_values.include?(format)
         fail ArgumentError, "invalid value for \"format\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/scores/{score}/revisions/{revision}/{format}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'revision' + '}', CGI.escape(revision.to_s)).sub('{' + 'format' + '}', CGI.escape(format.to_s))
+      local_var_path = '/scores/{score}/revisions/{revision}/{format}'.sub('{score}', CGI.escape(score.to_s)).sub('{revision}', CGI.escape(revision.to_s)).sub('{format}', CGI.escape(format.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1243,7 +1251,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/vnd.recordare.musicxml+xml', 'application/vnd.recordare.musicxml', 'audio/mp3', 'audio/wav', 'audio/midi', 'image/png'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/vnd.recordare.musicxml+xml', 'application/vnd.recordare.musicxml', 'audio/mp3', 'audio/wav', 'audio/midi', 'image/png', 'application/octet-stream']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1300,7 +1308,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'score' when calling ScoreApi.get_score_revisions"
       end
       # resource path
-      local_var_path = '/scores/{score}/revisions'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/revisions'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1309,7 +1317,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1364,7 +1372,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'score' when calling ScoreApi.get_score_submissions"
       end
       # resource path
-      local_var_path = '/scores/{score}/submissions'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/submissions'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1372,7 +1380,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1433,7 +1441,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'track' when calling ScoreApi.get_score_track"
       end
       # resource path
-      local_var_path = '/scores/{score}/tracks/{track}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'track' + '}', CGI.escape(track.to_s))
+      local_var_path = '/scores/{score}/tracks/{track}'.sub('{score}', CGI.escape(score.to_s)).sub('{track}', CGI.escape(track.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1442,7 +1450,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1511,7 +1519,7 @@ module FlatApi
       end
 
       # resource path
-      local_var_path = '/users/{user}/likes'.sub('{' + 'user' + '}', CGI.escape(user.to_s))
+      local_var_path = '/users/{user}/likes'.sub('{user}', CGI.escape(user.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1523,7 +1531,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1555,10 +1563,15 @@ module FlatApi
     end
 
     # List user's scores
-    # Get the list of public scores owned by a User.  **DEPRECATED**: Please note that the current behavior will be deprecrated on **2019-01-01**. This method will no longer list private and shared scores, but only public scores of a Flat account. If you want to access to private scores, please use the [Collections API](#tag/Collection) instead. 
+    # Get the list of public scores owned by a User. If you want to access to private scores, please use the [Collections API](#tag/Collection). For example `GET /v2/collections/allScores/scores` to list all recently updated scores. 
     # @param user [String] Unique identifier of a Flat user. If you authenticated, you can use &#x60;me&#x60; to refer to the current user. 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :parent Filter the score forked from the score id &#x60;parent&#x60;
+    # @option opts [Boolean] :paginate When set to &#x60;true&#x60;, the API will return a paginated result. When set to &#x60;false&#x60; or unset, the API will return all the scores. If this parameter is unset or false, then limit/sort/direction/next/previous will be ignored.  (default to false)
+    # @option opts [String] :sort Sort
+    # @option opts [String] :direction Sort direction
+    # @option opts [Integer] :limit This is the maximum number of objects that may be returned (default to 25)
+    # @option opts [String] :_next An opaque string cursor to fetch the next page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @option opts [String] :previous An opaque string cursor to fetch the previous page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
     # @return [Array<ScoreDetails>]
     def get_user_scores(user, opts = {})
       data, _status_code, _headers = get_user_scores_with_http_info(user, opts)
@@ -1566,10 +1579,15 @@ module FlatApi
     end
 
     # List user&#39;s scores
-    # Get the list of public scores owned by a User.  **DEPRECATED**: Please note that the current behavior will be deprecrated on **2019-01-01**. This method will no longer list private and shared scores, but only public scores of a Flat account. If you want to access to private scores, please use the [Collections API](#tag/Collection) instead. 
+    # Get the list of public scores owned by a User. If you want to access to private scores, please use the [Collections API](#tag/Collection). For example &#x60;GET /v2/collections/allScores/scores&#x60; to list all recently updated scores. 
     # @param user [String] Unique identifier of a Flat user. If you authenticated, you can use &#x60;me&#x60; to refer to the current user. 
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :parent Filter the score forked from the score id &#x60;parent&#x60;
+    # @option opts [Boolean] :paginate When set to &#x60;true&#x60;, the API will return a paginated result. When set to &#x60;false&#x60; or unset, the API will return all the scores. If this parameter is unset or false, then limit/sort/direction/next/previous will be ignored.  (default to false)
+    # @option opts [String] :sort Sort
+    # @option opts [String] :direction Sort direction
+    # @option opts [Integer] :limit This is the maximum number of objects that may be returned (default to 25)
+    # @option opts [String] :_next An opaque string cursor to fetch the next page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @option opts [String] :previous An opaque string cursor to fetch the previous page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
     # @return [Array<(Array<ScoreDetails>, Integer, Hash)>] Array<ScoreDetails> data, response status code and response headers
     def get_user_scores_with_http_info(user, opts = {})
       if @api_client.config.debugging
@@ -1579,17 +1597,38 @@ module FlatApi
       if @api_client.config.client_side_validation && user.nil?
         fail ArgumentError, "Missing the required parameter 'user' when calling ScoreApi.get_user_scores"
       end
+      allowable_values = ["creationDate", "modificationDate", "title"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["asc", "desc"]
+      if @api_client.config.client_side_validation && opts[:'direction'] && !allowable_values.include?(opts[:'direction'])
+        fail ArgumentError, "invalid value for \"direction\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ScoreApi.get_user_scores, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ScoreApi.get_user_scores, must be greater than or equal to 1.'
+      end
+
       # resource path
-      local_var_path = '/users/{user}/scores'.sub('{' + 'user' + '}', CGI.escape(user.to_s))
+      local_var_path = '/users/{user}/scores'.sub('{user}', CGI.escape(user.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'parent'] = opts[:'parent'] if !opts[:'parent'].nil?
+      query_params[:'paginate'] = opts[:'paginate'] if !opts[:'paginate'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'direction'] = opts[:'direction'] if !opts[:'direction'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'next'] = opts[:'_next'] if !opts[:'_next'].nil?
+      query_params[:'previous'] = opts[:'previous'] if !opts[:'previous'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1621,6 +1660,7 @@ module FlatApi
     end
 
     # List the audio or video tracks linked to a score
+    # List all audio or video tracks linked to a score.  **Access Control for Performance Submission Tracks:**  Tracks with `purpose: 'performanceSubmission'` are filtered based on user role:  * **Students**: Can only see their own performance submission tracks, plus all non-performance tracks * **Teachers and score admins**: Can see all tracks from all students  The `assignment` query parameter can be used to filter tracks for a specific assignment, but the access control rules above still apply. 
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
@@ -1633,6 +1673,7 @@ module FlatApi
     end
 
     # List the audio or video tracks linked to a score
+    # List all audio or video tracks linked to a score.  **Access Control for Performance Submission Tracks:**  Tracks with &#x60;purpose: &#39;performanceSubmission&#39;&#x60; are filtered based on user role:  * **Students**: Can only see their own performance submission tracks, plus all non-performance tracks * **Teachers and score admins**: Can see all tracks from all students  The &#x60;assignment&#x60; query parameter can be used to filter tracks for a specific assignment, but the access control rules above still apply. 
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
@@ -1648,7 +1689,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'score' when calling ScoreApi.list_score_tracks"
       end
       # resource path
-      local_var_path = '/scores/{score}/tracks'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/tracks'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1659,7 +1700,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1720,7 +1761,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'comment' when calling ScoreApi.mark_score_comment_resolved"
       end
       # resource path
-      local_var_path = '/scores/{score}/comments/{comment}/resolved'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'comment' + '}', CGI.escape(comment.to_s))
+      local_var_path = '/scores/{score}/comments/{comment}/resolved'.sub('{score}', CGI.escape(score.to_s)).sub('{comment}', CGI.escape(comment.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1729,7 +1770,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1790,7 +1831,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'comment' when calling ScoreApi.mark_score_comment_unresolved"
       end
       # resource path
-      local_var_path = '/scores/{score}/comments/{comment}/resolved'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'comment' + '}', CGI.escape(comment.to_s))
+      local_var_path = '/scores/{score}/comments/{comment}/resolved'.sub('{score}', CGI.escape(score.to_s)).sub('{comment}', CGI.escape(comment.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1799,7 +1840,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -1862,7 +1903,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'body' when calling ScoreApi.post_score_comment"
       end
       # resource path
-      local_var_path = '/scores/{score}/comments'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/comments'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -1871,7 +1912,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -1912,6 +1953,7 @@ module FlatApi
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param collaborator [String] Unique identifier of a **collaborator permission**, or unique identifier of a **User**, or unique identifier of a **Group** 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :event_properties Optional analytics properties merged into XP tracking for this request.  JSON-encoded string representing event properties. Example:  - &#x60;?eventProperties&#x3D;{\&quot;context\&quot;:\&quot;discover\&quot;,\&quot;screenLevel0\&quot;:\&quot;home\&quot;}&#x60; 
     # @return [nil]
     def remove_score_collaborator(score, collaborator, opts = {})
       remove_score_collaborator_with_http_info(score, collaborator, opts)
@@ -1923,6 +1965,7 @@ module FlatApi
     # @param score [String] Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
     # @param collaborator [String] Unique identifier of a **collaborator permission**, or unique identifier of a **User**, or unique identifier of a **Group** 
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :event_properties Optional analytics properties merged into XP tracking for this request.  JSON-encoded string representing event properties. Example:  - &#x60;?eventProperties&#x3D;{\&quot;context\&quot;:\&quot;discover\&quot;,\&quot;screenLevel0\&quot;:\&quot;home\&quot;}&#x60; 
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def remove_score_collaborator_with_http_info(score, collaborator, opts = {})
       if @api_client.config.debugging
@@ -1937,15 +1980,21 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'collaborator' when calling ScoreApi.remove_score_collaborator"
       end
       # resource path
-      local_var_path = '/scores/{score}/collaborators/{collaborator}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'collaborator' + '}', CGI.escape(collaborator.to_s))
+      local_var_path = '/scores/{score}/collaborators/{collaborator}'.sub('{score}', CGI.escape(score.to_s)).sub('{collaborator}', CGI.escape(collaborator.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'eventProperties'] = opts[:'event_properties'] if !opts[:'event_properties'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/x-www-form-urlencoded'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -2000,7 +2049,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'score' when calling ScoreApi.untrash_score"
       end
       # resource path
-      local_var_path = '/scores/{score}/untrash'.sub('{' + 'score' + '}', CGI.escape(score.to_s))
+      local_var_path = '/scores/{score}/untrash'.sub('{score}', CGI.escape(score.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -2008,7 +2057,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -2075,7 +2124,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'body' when calling ScoreApi.update_score_comment"
       end
       # resource path
-      local_var_path = '/scores/{score}/comments/{comment}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'comment' + '}', CGI.escape(comment.to_s))
+      local_var_path = '/scores/{score}/comments/{comment}'.sub('{score}', CGI.escape(score.to_s)).sub('{comment}', CGI.escape(comment.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -2084,7 +2133,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?
@@ -2154,7 +2203,7 @@ module FlatApi
         fail ArgumentError, "Missing the required parameter 'body' when calling ScoreApi.update_score_track"
       end
       # resource path
-      local_var_path = '/scores/{score}/tracks/{track}'.sub('{' + 'score' + '}', CGI.escape(score.to_s)).sub('{' + 'track' + '}', CGI.escape(track.to_s))
+      local_var_path = '/scores/{score}/tracks/{track}'.sub('{score}', CGI.escape(score.to_s)).sub('{track}', CGI.escape(track.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -2162,7 +2211,7 @@ module FlatApi
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
       content_type = @api_client.select_header_content_type(['application/json'])
       if !content_type.nil?