Dart ACTION
Create Task
Creates a new task within a dartboard. See the documentation
- Action
- Writes data
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Dart account once, then configure and run Create 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: "dart-create-task",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
dart: { authProvisionId: "apn_xxxxxxx" },
title: "Title",
parentId: "Parent Task ID",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "dart-create-task",
"configured_props": {
"dart": { "authProvisionId": "apn_xxxxxxx" },
"title": "Title",
"parentId": "Parent Task ID"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "dart",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "dart-create-task",
arguments: {
title: "Title",
parentId: "Parent Task ID",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
title Title | string | The title, which is a short description of what needs to be done Required |
parentId Parent Task ID | string | The universal, unique ID of the parent task. These tasks have a parent-child relationship where the current task is the child and this task ID corresponds to the parent. Subtasks inherit context from their parent and are typically smaller units of work Optional Dynamic |
dartboard Dartboard | string | The full title of the dartboard, which is a project or list of tasks Optional Dynamic |
type Type | string | The title of the type of the task Optional Dynamic |
status Status | string | The status from the list of available statuses Optional Dynamic |
description Description | string | A longer description of the task, which can include markdown formatting Required |
assignees Assignees | string[] | The names or emails of the users that the task is assigned to. Either this or assignee must be included, depending on whether the workspaces allows multiple assignees or not Optional Dynamic |
assignee Assignee | string | The name or email of the user that the task is assigned to. Either this or assignees must be included, depending on whether the workspaces allows multiple assignees or not Optional Dynamic |
tags Tags | string[] | Any tags that should be applied to the task, which can be used to filter and search for tasks. Tags are also known as labels or components and are strings that can be anything, but should be short and descriptive Optional Dynamic |
priority Priority | string | The priority, which is a string that can be one of the specified options. This is used to sort tasks and determine which tasks should be done first Optional Dynamic |
startAt Start At | string | The start date, which is a date that the task should be started by in ISO format, like YYYY-MM-DD Optional |
dueAt Due Date | string | The due date for the task in ISO format, like YYYY-MM-DD Optional |
size Size | string | The size of the task Optional Dynamic |
customProperties Custom Properties | object | The custom properties, which is an object of custom properties that are associated with the task 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
- dart-create-task
- Version
- 1.0.0
- App
- Dart
- Authentication
- API key
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗