View as Markdown
Dart icon

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)

SCHEMA

Inputs

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

Create Task inputs
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