Account
Tool | What it does |
Who am I? | Returns the current user's basic account info. (read-only) |
Files & Folders
Tool | What it does |
Search files | Finds a user's uploaded tracks/files by title, filename, or content. Used to look up a file before doing anything else with it. (read-only) |
Search folders | Finds a folder by name. Used to look up a folder before doing anything else with it. (read-only) |
List folder contents | Shows the files and subfolders directly inside a given folder, most recently updated first. (read-only) |
List folder ACLs | Shows who has access to a folder and what level of access they have. (read-only) |
List file versions | Shows all saved versions of a file, most recent first, and which one is current. (read-only) |
Get file download URL | Gets a direct download link for a file (a specific version, or the current one by default). (read-only) |
Share file | Creates a shareable link for a file, or directly invites a specific person (by email/phone/user) to view it. (action) |
List file comments | Shows the comment threads left on a file, most recent first, including replies and where in the file each comment applies. (read-only) |
Create file comment thread | Leaves a new timestamped comment on a specific version of a file. Text only — audio comments aren't supported yet. (action) |
Reply to file comment thread | Replies to an existing comment thread on a file. (action) |
Resolve file comment thread | Marks a comment thread on a file as resolved or unresolved. (action) |
Playlists
Tool | What it does |
List playlists | Shows the playlists a user can access — their own, or ones shared with them. (read-only) |
List playlist ACLs | Shows who has access to a playlist and at what level, including anyone with access via a public link. (read-only) |
Share playlist | Grants access to a playlist to a specific person or group. (action) |
Get playlist analytics | Shows how a playlist has performed — total opens, unique viewers, track plays, and a list of who opened it, most recent first. Requires the owner to be on a plan that includes analytics. (read-only) |
Notifications
Tool | What it does |
List notifications | Shows a user's notifications, most recent first — used to check for and summarize new activity. (read-only) |
Mark notification(s) as read | Marks specific notifications as read, or clears all of them at once. (action) |
Contacts & Network
Tool | What it does |
List contacts | Shows people the user has previously collaborated or shared files with, optionally filtered by a search term; otherwise ranked by how much they've collaborated. Used before sharing/inviting someone, to avoid re-inviting someone who already has access. (read-only) |
Search the network | Finds musicians and collaborators on the platform by artist name, role, genre, or instrument. (read-only) |