View as Markdown
Airplane icon

Airplane ACTION

Execute Task

Execute a task with a set of parameter values and receive a run ID to track the task's execution. See the documentation
  • Action
  • Writes data
  • Destructive
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Airplane account once, then configure and run Execute Task 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: "airplane-execute-task",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    airplane: { authProvisionId: "apn_xxxxxxx" },
    id: "Task ID",
    slug: "Slug",
  },
})

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.

Execute Task inputs
Property Type Description
id Task ID string
Unique ID of the task. You can find your task's ID by visiting the task's page on Airplane. The task ID is located at the end of the url. e.g. the task ID for https://app.airplane.dev/tasks/tsk20210728zxb2vxn is tsk20210728zxb2vxn Either an ID or a slug must be provided.
Optional
slug Slug string
Unique slug of the task. You can find your task's slug next to the task's name within the task editor on Airplane or by running airplane tasks list from the CLI. Either an ID or a slug must be provided.
Optional
paramValues Parameter Values object
Mapping of parameter slug to value. You can find your task's parameter slugs inside the task editor on Airplane or by running airplane tasks list from the CLI.
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
airplane-execute-task
Version
0.0.3
App
Airplane
Authentication
API key
Read-only
No
Destructive
Yes
Open world
Yes