Tags: FlatIO/api-reference
Tags
feat(api): API specification v2.20.0 * Accounts: * feat(account): Added pagination to `GET /users/{user}/likes` and fixed typo in operationId. * feat(account): Added `product` on `UserDetails` to know the product the user is using. * Score Library: * feat(library): Added `collaboratorType` to `ResourceRights` to know if the user accessing a resource is the owner, user or group collaborator. Adjusted non-optional properties on `ResourceRights`. * feat(library): Added `date` to `ResourceCollaborator` with the date the collaborator was added. * feat(score): Added new `mainKeySignature`, `highlightedDate` and `organization` properties to `ScoreDetails`. Adjusted non-optional properties on `ScoreDetails`. * feat(score): Added new `purpose` property to `ScoreTrack`. Adjusted non-optional properties on `ScoreTrack`. * feat(score): Added new `googleDriveDisabled` option when copying score (`POST /scores/{score}/fork`). * Flat for Education: * feat(edu): Some Flat for Education invitatons can be re-used multiple times. * fix(edu): Flat for Education invitatons can only be used to create `admin` or `teacher` accounts, fixed `organizationRole` enum. * feat(edu): Added new `verifyIfNotAlreadyInResourceLibrary` option to `POST /classes/{class}/assignments/{assignment}/copy` to avoid copying to the Resource Library if the assignment is already in it. * fix(edu): Fixed `ClassAttachmentCreation` enum values to reflect the current state of our product. * feat(edu): Added `playback` and `lti` properties to `AssignmentSubmission`. * fix(edu): `comments` object has never been available in `AssignmentSubmissionUpdate`, only in `AssignmentSubmission`. * feat(edu): Added `graded` state for submissions. * feat(edu): Added `organizationResources` library type to `GET /eduResources/libraries`, and added `organizationPublic` enum value to `EduResourcePrivacy`. * feat(edu): Added new `privacy` property to `PUT /eduResources/{resource}` * fix(edu): Removed unused property `alternateLink` from `MicrosoftGraphSubmission`. * fix(schema): missing `required: true` on some POST/PUT bodies.
feat(api): API specification v2.19.0 feat(edu): added new `POST /eduResources/{resource}/createLtiLink` endpoint to create LTI links from Flat for Education resources. feat(edu): maximum graded has been increased from 100 to 10000. feat(score): new nullable properties in `PUT /scores/{score}` to unset properties (`subtitle`, `composer`, `lyricist`, `arranger`, `description`, `creationType`, `license`, `licenseText`). fix(score): wrong user object in `ScoreSummary`, returned object has more properties than the specification (`UserPublic`). fix(spec): various properties marked as required as they will always be returned.
feat(api): API specification v2.18.0 * feat(edu): Released Resource Library API in beta (`/eduResources`) with new OAuth 2 scopes `edu.resources` and `edu.resources.readonly`. * feat(edu): Updated `POST /classes/{class}/assignments/{assignment}/copy` to allow to copy to Resource Library. * feat(edu): Updated `DELETE /classes/{class}/assignments/{assignment}/submissions/{submission}` behavior, now only resets the submission instead of deleting it. * feat(edu): Added `POST /classes/{class}/testStudent` to create testing student accounts. * feat(edu): Operation `POST /classes/{class}/assignments` has been renamed from `createAssignment` -> `createClassAssignment` in schema. * feat(edu): `Assignment` models now include a new `capabilities` property returning which actions are possible with a specific resource (`canEdit`, `canPublishInClass`, `canPublishInClassError`, `canArchive`, `canUnarchive`). * feat(edu): `Assignment` models now include a new `useDedicatedAttachments` property to know if the underlying resources are dedicated and stored inside the assignment (new behavior with the resource library). * feat(edu): `ClassAssignment` now includes a new `issue` property to return any issues encountered with the assignment. * feat(edu): `toolset` id provided when creating or updated assignments will now make a copy of the toolset to have a dedicated object for the assignment. * feat(edu): `AssignmentSubmissionHistory` now includes the `source` of the change, when this one comes from a third party (Google Classroom, Microsoft Teams, LTI). It also includes the following new properties: `dueDate`, `comment` and `attachment.title`. * feat(edu): `UserDetails` now contains Microsoft Sign in details (`azureDetails`) and list of groups the user is part of (`groups`). * feat(edu): Added optional metadata on class objects (`level`, `skillsFocused`, `size`). * fix(edu): Fixed `ClassAttachmentCreation` enum values to reflect the current state of our product. * feat(scores): Updated `GET /scores/{score}/revisions/{revision}` now returns the `startDate` and `endDate` for the score revisions. * feat(scores): Updated `POST /scores` to add `hasQuarterTone` on score builders to enable quarter tones on score parts. * feat(scores): Updated `POST /scores/{score}/fork` to add option to keep original title during a file copy (`keepOriginalTitle`). * fix(schema): Added missing required properties on models `ScoreSummary`, `MediaAttachment` and `FlatErrorResponse`.
feat(api): API specification v2.15.0 * feat(edu): added `POST /organizations/users/{user}/signinLink` to allow admins to create sign in links for their organization's users. * feat(edu): added `POST /organizations/users/{user}/accessToken` to allow admins to create delegated access tokens for their organization's users. * feat(locale): added `ja-HIRA` * feat(comments): added `moderation` object on public comments * feat(scores): added `defaultTrack` option to `GET /scores/{score}/revisions/{revision}/{format}` to return mp3 tracks when a mp3 is set as default track. * **DEPRECATED**: removed `onlyCached` option from `GET /scores/{score}/revisions/{revision}/{format}` since only cached files are now returned for audio exports.
feat(api): API specification v2.14.0 * feat(scores): `POST /v2/scores` has a new score builder to easily create blank scores without the need of importing a MusicXML file. Provide a list of instruments to use, and optionally customize the time signature, key signature, enable TABs, Chord grids as well as the page layout. * feat(edu): `POST /v2/organizations/users` has support for roles. * feat(edu): added new `shuffleExercises` option for worksheets. * feat(edu): added new `exercisesIds` in students submissions.
feat(api): API specification v2.13.0 * feat(scores): `GET /scores/{score}/tracks` has new query strings: * `listAutoTrack` to fetch tracks automatically generated & synced (playback available as a MP3 file). * `assignment` to filter tracks related to a Flat for Education assignment. * feat(scores): added `GET /scores/{score}/revisions/{revision}/synchronizationPoints` to fetch synchronization points automatically generated from latest MP3 playback file. * feat(scores): `GET /scores/{score}/revisions/{revision}/{format}` has a new query string `url` to fetch the CDN URL of the exported file in the JSON body. * feat(edu): added `DELETE /classes/{class}/assignments/{assignment}/submissions/{submission}` to let teachers reset students' submissions. * feat(edu): added detected `issues` on classes with the list fo accounts that couldn't be added to the classes during synchronizations. * feat(edu): added `microsoftGraph` property on assignments with the Microsoft Teams assignments `state`, URLs (`alternateLink`) and `categories`. * feat(edu): added `microsoftGraph` property on submissions with the Microsoft Teams submissions `state` and URLs (`alternateLink`). * feat(edu): `POST /classes/{class}/assignments/{assignment}/copy` has a new property `scheduledDate` to schedule assignments copies. * feat(edu): added `track` property to submissions for performance assigments saved audio tracks. * feat(account): added a `coverPicture` property with the URL of the profile cover picture, and `pictureFile` and `coverPictureFile` containing the ID of the corresponding files. * feat(account): `GET /me` has a new `onlyId` query string to quickly fetch current user id.
PreviousNext