Flat

Flat is an online music notation and composition platform with an API for creating, managing, and sharing musical scores.

• Base URL: https://api.flat.io/v2
• Auth: OAuth 2.0 (user-delegated) — attach an InTouch oauth credential. Mint one with itcli.py /oauth <provider> (device-code) or /google-auth (Google); the server auto-refreshes the access token before each run, so the connector never handles or stores tokens.

Operations

• listclasses — GET /classes — List the classes available for the current user
• getclass — GET /classes/{class} — Get the details of a single class
• listassignments — GET /classes/{class}/assignments — Assignments listing
• getsubmissions — GET /classes/{class}/assignments/{assignment}/submissions — List the students' submissions
• exportsubmissionsreviewsascsv — GET /classes/{class}/assignments/{assignment}/submissions/csv — CSV Grades exports
• exportsubmissionsreviewsasexcel — GET /classes/{class}/assignments/{assignment}/submissions/excel — Excel Grades exports

Inputs

• a linked oauth credential (no key inputs) — the server injects a fresh Authorization: Bearer from it
• operation — one of the operations above
• path parameters when an operation's path contains {...}
• query — optional JSON object of query params
• body — JSON object for create/update ops

Example

operation: listclasses
# (attach an 'oauth' credential to the task — no inline secrets)

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• operation
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.