View as Markdown
Maestra icon

Maestra ACTION

Upload File

Initiates a new file upload to Maestra. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Maestra account once, then configure and run Upload File from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "maestra-upload-file",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    maestra: { authProvisionId: "apn_xxxxxxx" },
    fileUrl: "File URL",
    fileName: "File Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Upload File inputs
Property Type Description
fileUrl File URL string
The URL of the file to upload
Required
fileName File Name string
The name of the file to upload
Required
mediaType Media Type string
The media type of the file, e.g., video/mp4
Required
audioLanguage Audio Language string
The language of the audio in the file, e.g., en-US
Required
speakerCount Speaker Count integer
The number of speakers in the file, e.g., 2
Optional
dictionaryKey Dictionary Key string
The dictionary key to use for the file, e.g., default
Optional
channelId Channel ID string
The ID of the channel where the file is stored
Optional Dynamic
folderPath Folder Path string
The path of the folder where the file is stored, e.g., root/-MbixMpLJ05xgjvwNnPm/-McCIYUrFqeXQGrEqQpR
Optional Dynamic
operationType Operation Type string
The type of operation to perform with the file
Optional
skipTranscription Skip Transcription boolean
Set to true to skip transcription, false otherwise
Optional
targetLanguages Target Languages string[]
The languages to translate the file to
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
maestra-upload-file
Version
0.0.2
App
Maestra
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes