# Dart Your Toolhouse AI Worker can connect to Dart using 18 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=dart). ## Tools (18) ### `Dart Add Task Attachment From Url` Integration name: **DART\_ADD\_TASK\_ATTACHMENT\_FROM\_URL** Tool to attach a file from a provided URL to a task. The file will be downloaded and attached asynchronously. Use when you need to add a file attachment to a task from a URL source. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | --------------------------------- | ----------------------------------------------------- | | `id` | string | ✅ | `"uomr9LySipco"` | Universal unique task ID (12 alphanumeric characters) | | `url` | string | ✅ | `"https://picsum.photos/200/300"` | The URL of the file to upload (must be a valid URI) | | `name` | string | ✅ | `"test-image.png"` | The name of the file to upload | *** ### `Dart Add Task Comment` Integration name: **DART\_ADD\_TASK\_COMMENT** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ---------------------------------------------- | ------------------------------------------------------------------------- | | `text` | string | ✅ | `"This is a test comment created via the API"` | The full comment content, supporting markdown formatting | | `task_id` | string | ✅ | `"SmkpXInBpO1k"` | The unique 12-character alphanumeric ID of the task receiving the comment | | `parent_id` | string | | `"AbC123XyZ456"` | Optional ID of a parent comment for creating threaded replies | *** ### `Dart Add Task Time Tracking` Integration name: **DART\_ADD\_TASK\_TIME\_TRACKING** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"vhEe6Snc5enx"` | The task ID (12-character alphanumeric identifier) | | `user` | string | | `"partnerships@composio.dev"` | The name or email of the user to attribute the tracked time to. Use null or omit to use the current user | | `startedAt` | string | ✅ | `"2025-12-15T10:00:00Z"` | The start timestamp for the tracked time entry in ISO 8601 format (e.g., 2025-12-15T10:00:00Z) | | `finishedAt` | string | ✅ | `"2025-12-15T11:00:00Z"` | The end timestamp for the tracked time entry in ISO 8601 format (e.g., 2025-12-15T11:00:00Z). Must be after the start time | *** ### `Dart Create Doc` Integration name: **DART\_CREATE\_DOC** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------- | ------------------------------------------------------------------------------------------- | | `item` | object | ✅ | — | Container for doc creation data including title, optional folder, and optional text content | *** ### `Dart Create Task` Integration name: **DART\_CREATE\_TASK** Tool to create a new task in DART with title and optional metadata. Use when you need to add a task to a workspace. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------- | ------------------------------------ | | `item` | object | ✅ | — | Task details wrapped in item object. | *** ### `Dart Delete Doc` Integration name: **DART\_DELETE\_DOC** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------------- | | `id` | string | ✅ | `"pYR2Uue76hQ7"` | Universal, unique identifier for the doc. Must match pattern ^\[a-zA-Z0-9]{12}$ | *** ### `Dart Delete Task` Integration name: **DART\_DELETE\_TASK** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ---------------- | ---------------------------------------------------------------------------------- | | `id` | string | ✅ | `"zwWzzgbdyopy"` | The universal, unique identifier for the task. Must be 12 alphanumeric characters. | *** ### `Dart Get Config` Integration name: **DART\_GET\_CONFIG** Tool to retrieve workspace configuration including dartboards, folders, types, statuses, and more. Use when you need to understand available options in the workspace. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Dart Get Doc` Integration name: **DART\_GET\_DOC** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ---------------- | --------------------------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"zCpfUGTlT7Ur"` | The universal, unique identifier of the document. Must be a 12-character alphanumeric string (pattern: ^\[a-zA-Z0-9]{12}$). | *** ### `Dart Get Task` Integration name: **DART\_GET\_TASK** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ---------------- | ----------------------------------------------------- | | `id` | string | ✅ | `"SmkpXInBpO1k"` | Universal unique task ID (12 alphanumeric characters) | *** ### `Dart List Comments` Integration name: **DART\_LIST\_COMMENTS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | `o` | array | | `["published_at"]` | Ordering options for results. Valid values: 'published\_at' (ascending), '-published\_at' (descending), 'hierarchical' (thread order). | | `ids` | string | | `"comment1,comment2"` | Filter by specific comment IDs (comma-separated). | | `text` | string | | `"important"` | Filter by comment text content. Searches for text within comments. | | `limit` | integer | | `10` | Number of results per page for pagination. | | `author` | string | | `"john@example.com"` | Filter by comment author name or email. | | `offset` | integer | | `0` | Starting index for pagination results. | | `task_id` | string | ✅ | `"SmkpXInBpO1k"` | The task identifier to retrieve associated comments. This parameter is required. | | `author_id` | string | | `"auth123"` | Filter by author's unique identifier. | | `parent_id` | string | | `"parent123"` | Filter comments by parent comment identifier to get replies. | | `published_at` | string | | `"2024-01-15T10:30:00Z"` | Filter by exact publication timestamp (ISO 8601 format). | | `published_at_after` | string | | `"2024-01-01T00:00:00Z"` | Filter for comments published after this date (ISO 8601 format). | | `published_at_before` | string | | `"2024-12-31T23:59:59Z"` | Filter for comments published before this date (ISO 8601 format). | *** ### `Dart List Docs` Integration name: **DART\_LIST\_DOCS** Tool to list docs with filtering and search capabilities. Use when you need to retrieve documents from DART with filters like folder, title, text content, or full-text search. Supports pagination and custom ordering by creation date, update date, or title. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `o` | array | | `["created_at"]` | Ordering field(s) for results. Valid options: 'folder\_\_order', 'order', 'created\_at', 'updated\_at', 'title'. Use '-' prefix for descending order (e.g., '-created\_at'). | | `s` | string | | `"meeting notes"` | Full-text search query to search by title, text content, or folder title. | | `ids` | string | | `"doc1,doc2"` | Filter by specific document IDs (comma-separated). | | `text` | string | | `"implementation details"` | Filter by document text content. | | `limit` | integer | | `10` | Number of results to return per page for pagination. | | `title` | string | | `"API Guide"` | Filter by document title. | | `editor` | string | | `"john@example.com"` | Filter by editor name or email. | | `folder` | string | | `"Product Documentation"` | Filter by folder name or title. | | `offset` | integer | | `0` | The initial index from which to return results for pagination. | | `in_trash` | boolean | | `false` | Include or exclude trashed docs. Set to true to show only trashed docs, false to exclude them. | | `folder_id` | string | | `"folder123"` | Filter by folder unique identifier. | | `no_defaults` | boolean | | `false` | Whether default filters and sorting are applied when false (default) or no defaults are applied when true. Explicit filters or sorting always override defaults. | *** ### `Dart List Help Center Articles` Integration name: **DART\_LIST\_HELP\_CENTER\_ARTICLES** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `query` | string | ✅ | `"api"` | The search query to find relevant help articles. Must be 1-5 words with minimum length of 1 character. The endpoint performs semantic similarity matching to find the most relevant articles. | *** ### `Dart List Tasks` Integration name: **DART\_LIST\_TASKS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `o` | array | | `["created_at"]` | Ordering field(s) for results. Valid options: 'dartboard\_\_order', 'order', 'created\_at', 'updated\_at', 'title'. Use '-' prefix for descending order. | | `ids` | string | | `"task1,task2"` | Filter by specific task IDs (comma-separated). | | `tag` | string | | `"urgent"` | Filter by tag name. | | `size` | integer | | `1` | Filter by task size or story points. | | `type` | string | | `"Bug"` | Filter by task type name. | | `view` | string | | `"My Tasks"` | Filter by view name. | | `limit` | integer | | `10` | Number of results to return per page for pagination. | | `title` | string | | `"API integration"` | Filter by task title text content. | | `due_at` | string | | `"2024-02-15T10:30:00Z"` | Filter by exact due date timestamp (ISO 8601 format). | | `offset` | integer | | `0` | The initial index from which to return results for pagination. | | `status` | string | | `"In Progress"` | Filter by task status name. | | `tag_id` | string | | `"tag123"` | Filter by tag unique identifier. | | `type_id` | string | | `"type123"` | Filter by task type unique identifier. | | `view_id` | string | | `"view123"` | Filter by view unique identifier. | | `assignee` | string | | `"john@example.com"` | Filter by assignee name or email. | | `in_trash` | boolean | | `false` | Include or exclude trashed tasks. Set to true to show only trashed tasks, false to exclude them. | | `priority` | string | | `"High"` | Filter by priority level. | | `start_at` | string | | `"2024-01-20T10:30:00Z"` | Filter by exact start date timestamp (ISO 8601 format). | | `dartboard` | string | | `"Product Development"` | Filter by dartboard name. | | `parent_id` | string | | `"parent123"` | Filter by parent task identifier to get subtasks. | | `status_id` | string | | `"status123"` | Filter by status unique identifier. | | `created_at` | string | | `"2024-01-15T10:30:00Z"` | Filter by exact creation timestamp (ISO 8601 format). | | `created_by` | string | | `"jane@example.com"` | Filter by creator name or email. | | `updated_at` | string | | `"2024-01-15T10:30:00Z"` | Filter by exact update timestamp (ISO 8601 format). | | `updated_by` | string | | `"alice@example.com"` | Filter by last updater name or email. | | `assignee_id` | string | | `"assignee123"` | Filter by assignee's unique identifier. | | `description` | string | | `"implement feature"` | Filter by task description text content. | | `no_defaults` | boolean | | `false` | Disable default filters applied by the API (default: false). | | `dartboard_id` | string | | `"dartboard123"` | Filter by dartboard unique identifier. | | `due_at_after` | string | | `"2024-02-01T00:00:00Z"` | Filter for tasks due after this date (ISO 8601 format). | | `is_completed` | boolean | | `false` | Filter by completion status. True for completed tasks, false for incomplete tasks. | | `created_by_id` | string | | `"creator123"` | Filter by creator's unique identifier. | | `due_at_before` | string | | `"2024-02-28T23:59:59Z"` | Filter for tasks due before this date (ISO 8601 format). | | `updated_by_id` | string | | `"updater123"` | Filter by last updater's unique identifier. | | `start_at_after` | string | | `"2024-01-15T00:00:00Z"` | Filter for tasks starting after this date (ISO 8601 format). | | `start_at_before` | string | | `"2024-01-31T23:59:59Z"` | Filter for tasks starting before this date (ISO 8601 format). | | `created_at_after` | string | | `"2024-01-01T00:00:00Z"` | Filter for tasks created after this date (ISO 8601 format). | | `updated_at_after` | string | | `"2024-01-01T00:00:00Z"` | Filter for tasks updated after this date (ISO 8601 format). | | `created_at_before` | string | | `"2024-12-31T23:59:59Z"` | Filter for tasks created before this date (ISO 8601 format). | | `updated_at_before` | string | | `"2024-12-31T23:59:59Z"` | Filter for tasks updated before this date (ISO 8601 format). | *** ### `Dart Move Task` Integration name: **DART\_MOVE\_TASK** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | `"Lc8wvm8yjHA4"` | The universal, unique identifier of the task to reposition. Must be a 12-character alphanumeric identifier | | `afterTaskId` | string | | `"Abc123XyZ456"` | Places the task immediately after the specified task ID. Using null moves the task to the end of the list. Exactly one of afterTaskId or beforeTaskId should be used | | `beforeTaskId` | string | | `"Xyz789AbC012"` | Places the task immediately before the specified task ID. Using null moves the task to the beginning of the list. Exactly one of afterTaskId or beforeTaskId should be used | *** ### `Dart Retrieve Skill By Title` Integration name: **DART\_RETRIEVE\_SKILL\_BY\_TITLE** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | -------- | ----------------------------------------------------------- | | `title` | string | ✅ | `"test"` | The title of the skill to retrieve. Must be an exact match. | *** ### `Dart Update Doc` Integration name: **DART\_UPDATE\_DOC** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------- | -------------------------------------------------------------------------------------------------------------- | | `item` | object | ✅ | — | Container for doc update data including the document ID and optional title, folder, and text content to update | *** ### `Dart Update Task` Integration name: **DART\_UPDATE\_TASK** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------- | ------------------------------------------------------------------------------- | | `item` | object | ✅ | — | Task details wrapped in item object. Only properties specified will be updated. | *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/dart.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.