Dart | Composio Docs

Overview

SLUG: DART

Description

The ultimate AI project management tool.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Dart

Create an auth config

Use the dashboard to create an auth config for the Dart toolkit. This allows you to connect multiple Dart accounts to Composio for agents to use.

Select App

Navigate to Dart.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Dart Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 dart_auth_config_id = "ac_YOUR_DART_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Dart for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, dart_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Dart toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

DART_ADD_TASK_COMMENT

Tool Name: Add Task Comment

Description

Tool to create a new comment on a DART task. Use when you need to add feedback, notes, or discussion to a specific task. Supports markdown formatting and threaded replies via parentId.

Action Parameters

parent_id

string

task_id

stringRequired

text

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_ADD_TASK_TIME_TRACKING

Tool Name: Add Task Time Tracking

Description

Tool to add a time tracking entry to a DART task. Use when you need to record time spent on a specific task. The finishedAt timestamp must be after startedAt.

Action Parameters

finishedAt

stringRequired

startedAt

stringRequired

user

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_CREATE_DOC

Tool Name: Create Doc

Description

Tool to create a new doc in Dart. Use when you need to record a new document that the user intends to write down. By default, the created doc will be in the Docs folder unless a specific folder is specified.

Action Parameters

item

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_CREATE_TASK

Tool Name: Create Task

Description

Tool to create a new task in DART with title and optional metadata. Use when you need to add a task to a workspace.

Action Parameters

item

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_DELETE_DOC

Tool Name: Delete Doc

Description

Tool to move an existing doc to the trash where it can be recovered if needed. Use when you need to delete a doc without permanently removing it.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_DELETE_TASK

Tool Name: Delete Task

Description

Tool to delete an existing task in Dart by moving it to trash. Use when a task needs to be removed but can be recovered later.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_GET_CONFIG

Tool Name: Get User Space Configuration

Description

Tool to retrieve workspace configuration including dartboards, folders, types, statuses, and more. Use when you need to understand available options in the workspace.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_GET_DOC

Tool Name: Get Doc

Description

Tool to retrieve an existing doc with metadata and content. Use when you need to access a specific document's details including title, folder, and text content.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_GET_TASK

Tool Name: Get Task

Description

Tool to retrieve an existing task with full details including title, dartboard, status, and description. Use when you need to fetch complete information about a specific task.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_LIST_COMMENTS

Tool Name: List Comments

Description

Tool to list comments for a task with filtering options. Use when you need to retrieve comments on a specific task. Supports filtering by author, text content, date range, and pagination. Can be ordered by date or hierarchical thread structure.

Action Parameters

author

string

author_id

string

ids

string

limit

integer

array

offset

integer

parent_id

string

published_at

string

published_at_after

string

published_at_before

string

task_id

stringRequired

text

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_LIST_HELP_CENTER_ARTICLES

Tool Name: List Help Center Articles

Description

Tool to search help center articles by semantic similarity to query. Use when you need to find relevant help articles based on a short search query (1-5 words). Returns up to two most relevant articles.

Action Parameters

query

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_LIST_TASKS

Tool Name: List Tasks

Description

Tool to list tasks with powerful filtering options. Use when you need to retrieve tasks from DART with filters like dartboard, status, assignee, tags, priority, dates, or completion state. Supports pagination and custom ordering.

Action Parameters

assignee

string

assignee_id

string

created_at

string

created_at_after

string

created_at_before

string

created_by

string

created_by_id

string

dartboard

string

dartboard_id

string

description

string

due_at

string

due_at_after

string

due_at_before

string

ids

string

in_trash

boolean

is_completed

boolean

limit

integer

no_defaults

boolean

array

offset

integer

parent_id

string

priority

string

size

integer

start_at

string

start_at_after

string

start_at_before

string

status

string

status_id

string

tag

string

tag_id

string

title

string

type

string

type_id

string

updated_at

string

updated_at_after

string

updated_at_before

string

updated_by

string

updated_by_id

string

view

string

view_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_MOVE_TASK

Tool Name: Move Task

Description

Tool to move a task to a specific position within its dartboard. Use when you need to reorder tasks in a list. Specify either afterTaskId or beforeTaskId to position the task.

Action Parameters

afterTaskId

string

beforeTaskId

string

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_RETRIEVE_SKILL_BY_TITLE

Tool Name: Retrieve Skill By Title

Description

Tool to retrieve a skill by its exact title from the workspace. Use when you need to find details about a specific skill including its ID and instructions.

Action Parameters

title

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_UPDATE_DOC

Tool Name: Update Doc

Description

Tool to update an existing doc in Dart. Use when you need to modify a document's title, folder location, or content. Any properties not specified will remain unchanged.

Action Parameters

item

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DART_UPDATE_TASK

Tool Name: Update Task

Description

Tool to update an existing task in DART with new properties. Use when you need to modify a task's title, status, assignees, or other attributes. Only properties specified in the request will be updated.

Action Parameters

item

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired