flowground für Geschäftskunden

Technische Spezifikationen

startFlow

OnInit
./lib/triggers/startFlow.js
OnStartup
-
OnClose
-

Attributes

-

listClasses

OnInit
./lib/actions/listClasses.js
OnStartup
-
OnClose
-

Attributes

-

createClass

Classrooms on Flat allow you to create activities with assignments and post content to a specific group. When creating a class, Flat automatically creates two groups: one for the teachers of the course, one for the students. The creator of this class is automatically added to the teachers group. If the classsroom is synchronized with another application like Google Classroom, some of the meta information will automatically be updated. You can add users to this class using `POST /classes/{class}/users/{user}`, they will automatically added to the group based on their role on Flat. Users can also enroll themselves to this class using `POST /classes/enroll/{enrollmentCode}` and the `enrollmentCode` returned in the `ClassDetails` response.

OnInit
./lib/actions/createClass.js
OnStartup
-
OnClose
-

Attributes

-

enrollClass

Use this method to join a class using an enrollment code given one of the teacher of this class. This code is also available in the `ClassDetails` returned to the teachers when creating the class or listing / fetching a specific class. Flat will automatically add the user to the corresponding class group based on this role in the organization.

OnInit
./lib/actions/enrollClass.js
OnStartup
-
OnClose
-

Attributes

-

getClass

OnInit
./lib/actions/getClass.js
OnStartup
-
OnClose
-

Attributes

-

updateClass

Update the meta information of the class

OnInit
./lib/actions/updateClass.js
OnStartup
-
OnClose
-

Attributes

-

activateClass

Mark the class as `active`. This is mainly used for classes synchronized from Clever that are initially with an `inactive` state and hidden in the UI.

OnInit
./lib/actions/activateClass.js
OnStartup
-
OnClose
-

Attributes

-

unarchiveClass

Mark the class as `active`. When this course is synchronized with another app, like Google Classroom, this state will be automatically be updated.

OnInit
./lib/actions/unarchiveClass.js
OnStartup
-
OnClose
-

Attributes

-

archiveClass

Mark the class as `archived`. When this course is synchronized with another app, like Google Classroom, this state will be automatically be updated.

OnInit
./lib/actions/archiveClass.js
OnStartup
-
OnClose
-

Attributes

-

listAssignments

OnInit
./lib/actions/listAssignments.js
OnStartup
-
OnClose
-

Attributes

-

createAssignment

Use this method as a teacher to create and post a new assignment to a class. If the class is synchronized with Google Classroom, the assignment will be automatically posted to your Classroom course.

OnInit
./lib/actions/createAssignment.js
OnStartup
-
OnClose
-

Attributes

-

copyAssignment

Copy an assignment to a specified class. If the original assignment has a due date in the past, this new assingment will be created without a due date. If the new class is synchronized with an external app (e.g. Google Classroom), the copied assignment will also be posted on the external app.

OnInit
./lib/actions/copyAssignment.js
OnStartup
-
OnClose
-

Attributes

-

getSubmissions

OnInit
./lib/actions/getSubmissions.js
OnStartup
-
OnClose
-

Attributes

-

createSubmission

Use this method as a student to create, update and submit a submission related to an assignment. Students can only set `attachments`, `studentComment` and `submit`. Teachers can use `PUT /classes/{class}/assignments/{assignment}/submissions/{submission}` to update a submission by id.

OnInit
./lib/actions/createSubmission.js
OnStartup
-
OnClose
-

Attributes

-

getSubmission

OnInit
./lib/actions/getSubmission.js
OnStartup
-
OnClose
-

Attributes

-

editSubmission

Use this method as a teacher to update the different submission and give feedback. Teachers can only set `returnFeedback`

OnInit
./lib/actions/editSubmission.js
OnStartup
-
OnClose
-

Attributes

-

listClassStudentSubmissions

Use this method as a teacher to list all the assignment submissions sent by a student of the class

OnInit
./lib/actions/listClassStudentSubmissions.js
OnStartup
-
OnClose
-

Attributes

-

deleteClassUser

This method can be used by a teacher to remove a user from the class, or by a student to leave the classroom. Warning: Removing a user from the class will remove the associated resources, including the submissions and feedback related to these submissions.

OnInit
./lib/actions/deleteClassUser.js
OnStartup
-
OnClose
-

Attributes

-

addClassUser

This method can be used by a teacher of the class to enroll another Flat user into the class. Only users that are part of your Organization can be enrolled in a class of this same Organization. When enrolling a user in the class, Flat will automatically add this user to the corresponding Class group, based on this role in the Organization.

OnInit
./lib/actions/addClassUser.js
OnStartup
-
OnClose
-

Attributes

-

listCollections

Use this method to list the user's collections contained in `parent` (by default in the `root` collection). If no sort option is provided, the collections are sorted by `creationDate` `desc`. Note that this method will not include the `parent` collection in the listing. For example, if you need the details of the `root` collection, you can use `GET /v2/collections/root`.

OnInit
./lib/actions/listCollections.js
OnStartup
-
OnClose
-

Attributes

-

createCollection

This method will create a new collection and add it to your `root` collection.

OnInit
./lib/actions/createCollection.js
OnStartup
-
OnClose
-

Attributes

-

deleteCollection

This method will schedule the deletion of the collection. Until deleted, the collection will be available in the `trash`.

OnInit
./lib/actions/deleteCollection.js
OnStartup
-
OnClose
-

Attributes

-

getCollection

OnInit
./lib/actions/getCollection.js
OnStartup
-
OnClose
-

Attributes

-

editCollection

OnInit
./lib/actions/editCollection.js
OnStartup
-
OnClose
-

Attributes

-

listCollectionScores

Use this method to list the scores contained in a collection. If no sort option is provided, the scores are sorted by `modificationDate` `desc`.

OnInit
./lib/actions/listCollectionScores.js
OnStartup
-
OnClose
-

Attributes

-

deleteScoreFromCollection

This method will delete a score from the collection. Unlike [`DELETE /scores/{score}`](#operation/deleteScore), this score will not remove the score from your account, but only from the collection. This can be used to *move* a score from one collection to another, or simply remove a score from one collection when this one is contained in multiple collections.

OnInit
./lib/actions/deleteScoreFromCollection.js
OnStartup
-
OnClose
-

Attributes

-

addScoreToCollection

This operation will add a score to a collection. The default behavior will make the score available across multiple collections. You must have the capability `canAddScores` on the provided `collection` to perform the action.

OnInit
./lib/actions/addScoreToCollection.js
OnStartup
-
OnClose
-

Attributes

-

untrashCollection

This method will restore the collection by removing it from the `trash` and add it back to the `root` collection.

OnInit
./lib/actions/untrashCollection.js
OnStartup
-
OnClose
-

Attributes

-

getGroupDetails

OnInit
./lib/actions/getGroupDetails.js
OnStartup
-
OnClose
-

Attributes

-

getGroupScores

Get the list of scores shared with a group.

OnInit
./lib/actions/getGroupScores.js
OnStartup
-
OnClose
-

Attributes

-

listGroupUsers

OnInit
./lib/actions/listGroupUsers.js
OnStartup
-
OnClose
-

Attributes

-

getAuthenticatedUser

Get details about the current authenticated User.

OnInit
./lib/actions/getAuthenticatedUser.js
OnStartup
-
OnClose
-

Attributes

-

listOrganizationInvitations

OnInit
./lib/actions/listOrganizationInvitations.js
OnStartup
-
OnClose
-

Attributes

-

createOrganizationInvitation

This method creates and sends invitation for teachers and admins. Invitations can only be used by new Flat users or users who are not part of the organization yet. If the email of the user is already associated to a user of your organization, the API will simply update the role of the existing user and won't send an invitation. In this case, the property `usedBy` will be directly filled with the uniquer identifier of the corresponding user.

OnInit
./lib/actions/createOrganizationInvitation.js
OnStartup
-
OnClose
-

Attributes

-

removeOrganizationInvitation

OnInit
./lib/actions/removeOrganizationInvitation.js
OnStartup
-
OnClose
-

Attributes

-

listLtiCredentials

OnInit
./lib/actions/listLtiCredentials.js
OnStartup
-
OnClose
-

Attributes

-

createLtiCredentials

Flat for Education is a Certified LTI Provider. You can use these API methods to automate the creation of LTI credentials. You can read more about our LTI implementation, supported components and LTI Endpoints in our [Developer Documentation](https://flat.io/developers/docs/lti/).

OnInit
./lib/actions/createLtiCredentials.js
OnStartup
-
OnClose
-

Attributes

-

revokeLtiCredentials

OnInit
./lib/actions/revokeLtiCredentials.js
OnStartup
-
OnClose
-

Attributes

-

listOrganizationUsers

OnInit
./lib/actions/listOrganizationUsers.js
OnStartup
-
OnClose
-

Attributes

-

createOrganizationUser

OnInit
./lib/actions/createOrganizationUser.js
OnStartup
-
OnClose
-

Attributes

-

removeOrganizationUser

This operation removes an account from Flat and its data, including: * The music scores created by this user (documents, history, comments, collaboration information) * Education related data (assignments and classroom information)

OnInit
./lib/actions/removeOrganizationUser.js
OnStartup
-
OnClose
-

Attributes

-

updateOrganizationUser

OnInit
./lib/actions/updateOrganizationUser.js
OnStartup
-
OnClose
-

Attributes

-

createScore

Use this API method to **create a new music score in the current User account**. You will need a MusicXML 3 (`vnd.recordare.musicxml` or `vnd.recordare.musicxml+xml`), a MIDI (`audio/midi`), Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar, or MuseScore file to create the new Flat document. 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. This can be the `root` collection or a different collection based on the user's settings or API authentication method. 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}`.

OnInit
./lib/actions/createScore.js
OnStartup
-
OnClose
-

Attributes

-

deleteScore

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).

OnInit
./lib/actions/deleteScore.js
OnStartup
-
OnClose
-

Attributes

-

getScore

Get the details of a score identified by the `score` parameter in the URL. The currently authenticated user must have at least a read access to the document to use this API call.

OnInit
./lib/actions/getScore.js
OnStartup
-
OnClose
-

Attributes

-

editScore

This API method allows you to change the metadata of a score document (e.g. its `title` or `privacy`), all the properties are optional. To edit the file itself, create a new revision using the appropriate method (`POST /v2/scores/{score}/revisions/{revision}`). When editing the `title` of the score, the API metadata are updated directly when calling this method, unlike the data itself. The title in the score data will be "lazy" updated at the next score save with the editor or our internal save.

OnInit
./lib/actions/editScore.js
OnStartup
-
OnClose
-

Attributes

-

getScoreCollaborators

This API call will list the different collaborators of a score and their rights on the document. The returned list will at least contain the owner of the document. Collaborators can be a single user (the object `user` will be populated) or a group (the object `group` will be populated).

OnInit
./lib/actions/getScoreCollaborators.js
OnStartup
-
OnClose
-

Attributes

-

addScoreCollaborator

Share a score with a single user or a group. This API call allows to add, invite and update the collaborators of a resource. - To add an existing Flat user to the resource, specify its unique identifier in the `user` property. - To invite an external user to the resource, specify its email in the `userEmail` property. - To add a Flat group to the resource, specify its unique identifier in the `group` property. - To update an existing collaborator, process the same request with different rights.

OnInit
./lib/actions/addScoreCollaborator.js
OnStartup
-
OnClose
-

Attributes

-

removeScoreCollaborator

Remove the specified collaborator from the score

OnInit
./lib/actions/removeScoreCollaborator.js
OnStartup
-
OnClose
-

Attributes

-

getScoreCollaborator

Get the information about a collaborator (User or Group).

OnInit
./lib/actions/getScoreCollaborator.js
OnStartup
-
OnClose
-

Attributes

-

getScoreComments

This method lists the different comments added on a music score (documents and inline) sorted by their post dates.

OnInit
./lib/actions/getScoreComments.js
OnStartup
-
OnClose
-

Attributes

-

postScoreComment

Post a document or a contextualized comment on a document. Please note that this method includes an anti-spam system for public scores. We don't guarantee that your comments will be accepted and displayed to end-user. Comments are be blocked by returning a `403` HTTP error and hidden from other users when the `spam` property is `true`.

OnInit
./lib/actions/postScoreComment.js
OnStartup
-
OnClose
-

Attributes

-

deleteScoreComment

OnInit
./lib/actions/deleteScoreComment.js
OnStartup
-
OnClose
-

Attributes

-

updateScoreComment

OnInit
./lib/actions/updateScoreComment.js
OnStartup
-
OnClose
-

Attributes

-

markScoreCommentUnresolved

OnInit
./lib/actions/markScoreCommentUnresolved.js
OnStartup
-
OnClose
-

Attributes

-

markScoreCommentResolved

OnInit
./lib/actions/markScoreCommentResolved.js
OnStartup
-
OnClose
-

Attributes

-

forkScore

This API call will make a copy of the last revision of the specified score and create a new score. The copy of the score will have a privacy set to `private`. When using a [Flat for Education](https://flat.io/edu) account, the inline and contextualized comments will be accessible in the child document.

OnInit
./lib/actions/forkScore.js
OnStartup
-
OnClose
-

Attributes

-

getScoreRevisions

When creating a score or saving a new version of a score, a revision is created in our storage. This method allows you to list all of them, sorted by last modification. Depending the plan of the account, this list can be trunked to the few last revisions.

OnInit
./lib/actions/getScoreRevisions.js
OnStartup
-
OnClose
-

Attributes

-

createScoreRevision

Update a score by uploading a new revision for this one.

OnInit
./lib/actions/createScoreRevision.js
OnStartup
-
OnClose
-

Attributes

-

getScoreRevision

When creating a score or saving a new version of a score, a revision is created in our storage. This method allows you to get a specific revision metadata.

OnInit
./lib/actions/getScoreRevision.js
OnStartup
-
OnClose
-

Attributes

-

getScoreRevisionData

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`, or a tumbnail of the first page `thumbnail.png`).

OnInit
./lib/actions/getScoreRevisionData.js
OnStartup
-
OnClose
-

Attributes

-

getScoreSubmissions

This API call will list the different assignments submissions where the score is attached. This method can be used by anyone that are part of the organization and have at least read access to the document.

OnInit
./lib/actions/getScoreSubmissions.js
OnStartup
-
OnClose
-

Attributes

-

listScoreTracks

OnInit
./lib/actions/listScoreTracks.js
OnStartup
-
OnClose
-

Attributes

-

addScoreTrack

Use this method to add new track to the score. This track can then be played on flat.io or in an embedded score. This API method support medias hosted on SoundCloud, YouTube and Vimeo.

OnInit
./lib/actions/addScoreTrack.js
OnStartup
-
OnClose
-

Attributes

-

deleteScoreTrack

OnInit
./lib/actions/deleteScoreTrack.js
OnStartup
-
OnClose
-

Attributes

-

getScoreTrack

OnInit
./lib/actions/getScoreTrack.js
OnStartup
-
OnClose
-

Attributes

-

updateScoreTrack

OnInit
./lib/actions/updateScoreTrack.js
OnStartup
-
OnClose
-

Attributes

-

untrashScore

This method will remove the score from the `trash` collection and from the deletion queue, and add it back to the original collections.

OnInit
./lib/actions/untrashScore.js
OnStartup
-
OnClose
-

Attributes

-

getUser

Get a public profile of a Flat User.

OnInit
./lib/actions/getUser.js
OnStartup
-
OnClose
-

Attributes

-

gerUserLikes

OnInit
./lib/actions/gerUserLikes.js
OnStartup
-
OnClose
-

Attributes

-

getUserScores

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.

OnInit
./lib/actions/getUserScores.js
OnStartup
-
OnClose
-

Attributes

-

Keine Daten für terms vorhanden

OAUTH_CLIENT_ID

OAuth Client ID

type
-
required
-
example
-

OAUTH_CLIENT_SECRET

OAuth Client Secret

type
-
required
-
example
-