Progressive discovery of dart-query capabilities - start here

Get workspace configuration: assignees, dartboards, statuses, tags, priorities, sizes

Create a new task with title, description, status, priority, size, dates, dartboard, assignees, tags, and task relationships (subtasks, blockers, related tasks)

Query tasks with filters (assignee, status, dartboard, priority, tags, dates, has_parent), pagination, and detail levels. Parent filter uses client-side filtering.

Get a specific task by dart_id with optional comments and relationship details. Returns task relationships (subtasks, blockers, blocking, duplicates, related) with counts and optional expanded titles.

Update a task. Pass dart_id and any fields to change at the top level. Supports add_to/remove_from for incremental relationship changes and optional comment. Relationship arrays use full replacement unless using add_to/remove_from.

Delete a task (moves to trash - recoverable via Dart web UI)

[Deprecated: use execute_dartql] Batch update multiple tasks matching a DartQL selector. Supports all task fields including relationships. CRITICAL: Always use dry_run=true first to preview changes!

[Deprecated: use execute_dartql] Batch delete multiple tasks matching a DartQL selector. MOST DANGEROUS OPERATION! CRITICAL: dry_run defaults to true, confirm=true REQUIRED when dry_run=false. Tasks move to trash (recoverable).

Execute DartQL UPDATE/DELETE statements. Supports template vars {field}, array literals, comments, and multi-statement (;). Dry-run by default.

Retrieve status of a batch operation (update, delete, import, or dartql) by batch_operation_id. Operations are kept in memory for 1 hour.

Import tasks from CSV file with validation and parallel creation. CRITICAL: ALWAYS use validate_only=true first! Production safety: validate → fix errors → import.

List documents with optional filtering by folder, title_contains, text_contains. Supports pagination.

Create a new document with title, text (markdown supported), and optional folder

Get a specific document by doc_id with full text content

Update an existing document (title, text, or folder). Validates references and only sends changed fields.

Delete a document (moves to trash - recoverable via Dart web UI)

Full-text search across tasks with relevance ranking. Alternative to list_tasks for text-based discovery. Supports quoted phrases, exclusions (-term), and inline filters (dartboard:Name, status:Done, assignee:Name).

Add a comment to a task for status updates, AI rationale, or notes. Supports markdown formatting.

List comments on a task with pagination. Token-efficient: returns minimal comment data.

Move/reposition a task within a dartboard or to a different dartboard. Supports ordering by index or relative to another task.

Add a time tracking entry to a task. Supports started_at/finished_at or duration_minutes.

Attach a file from URL to a task. URL must be publicly accessible.

Get details about a dartboard including task count. Token-efficient lookup.

Get details about a folder including doc count. Token-efficient lookup.