create_task
Create and manage tasks in Dart by specifying title, description, status, priority, assignees, tags, dates, parent task, and custom properties. Ideal for AI-driven project management and task organization.
Instructions
Create a new task in Dart. You can specify title, description, status, priority, size, dates, dartboard, assignees, tags, parent task, custom properties, and task relationships.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assignee | No | Single assignee name or email (if workspace doesn't allow multiple assignees) | |
| assignees | No | Array of assignee names or emails (if workspace allows multiple assignees) | |
| customProperties | No | Custom properties to apply to the task. Use the property names from the config. Examples: { 'customCheckboxProperty': true, 'customTextProperty': 'Some text', 'customNumberProperty': 5, 'customSelectProperty': 'Option Name', 'customDatesProperty': '2025-05-10', 'customDatesPropertyWithRange': ['2025-05-01', '2025-05-30'], 'customMultiselectProperty': ['option1', 'option2'], 'customUserProperty': 'user@example.com', 'customMultipleUserProperty': ['user1@example.com', 'user2@example.com'], 'customTimeTrackingProperty': '1:30:00' } | |
| dartboard | No | The title of the dartboard (project or list of tasks) | |
| description | No | A longer description of the task, which can include markdown formatting | |
| dueAt | No | The due date in ISO format (should be at 9:00am in user's timezone) | |
| parentId | No | The ID of the parent task | |
| priority | No | The priority (Critical, High, Medium, or Low) | |
| size | No | The size which represents the amount of work needed | |
| startAt | No | The start date in ISO format (should be at 9:00am in user's timezone) | |
| status | No | The status from the list of available statuses | |
| tags | No | Array of tags to apply to the task | |
| taskRelationships | No | Task relationships including subtasks, blockers, duplicates, and related tasks | |
| title | Yes | The title of the task (required) | |
| type | No | The type of the task from the list of available types |
Input Schema (JSON Schema)
{
"properties": {
"assignee": {
"description": "Single assignee name or email (if workspace doesn't allow multiple assignees)",
"type": "string"
},
"assignees": {
"description": "Array of assignee names or emails (if workspace allows multiple assignees)",
"items": {
"type": "string"
},
"type": "array"
},
"customProperties": {
"additionalProperties": {
"oneOf": [
{
"title": "CustomPropertyCheckbox",
"type": "boolean"
},
{
"items": {
"type": [
"string",
"null"
]
},
"title": "CustomPropertyDatesRange",
"type": [
"array",
"null"
]
},
{
"title": "CustomPropertyDatesSingle",
"type": [
"string",
"null"
]
},
{
"items": {
"type": "string"
},
"title": "CustomPropertyMultiselect",
"type": "array"
},
{
"title": "CustomPropertyNumber",
"type": [
"number",
"null"
]
},
{
"title": "CustomPropertySelect",
"type": [
"string",
"null"
]
},
{
"title": "CustomPropertyStatus",
"type": "string"
},
{
"title": "CustomPropertyText",
"type": "string"
},
{
"description": "Duration in HH:MM:SS format",
"pattern": "^[0-9]+:[0-5][0-9]:[0-5][0-9]$",
"title": "CustomPropertyTimeTracking",
"type": "string"
},
{
"items": {
"type": "string"
},
"title": "CustomPropertyUserMultiple",
"type": "array"
},
{
"title": "CustomPropertyUserSingle",
"type": [
"string",
"null"
]
}
]
},
"description": "Custom properties to apply to the task. Use the property names from the config. Examples: { 'customCheckboxProperty': true, 'customTextProperty': 'Some text', 'customNumberProperty': 5, 'customSelectProperty': 'Option Name', 'customDatesProperty': '2025-05-10', 'customDatesPropertyWithRange': ['2025-05-01', '2025-05-30'], 'customMultiselectProperty': ['option1', 'option2'], 'customUserProperty': 'user@example.com', 'customMultipleUserProperty': ['user1@example.com', 'user2@example.com'], 'customTimeTrackingProperty': '1:30:00' }",
"required": [],
"type": "object"
},
"dartboard": {
"description": "The title of the dartboard (project or list of tasks)",
"type": "string"
},
"description": {
"description": "A longer description of the task, which can include markdown formatting",
"type": "string"
},
"dueAt": {
"description": "The due date in ISO format (should be at 9:00am in user's timezone)",
"type": "string"
},
"parentId": {
"description": "The ID of the parent task",
"pattern": "^[a-zA-Z0-9]{12}$",
"type": "string"
},
"priority": {
"description": "The priority (Critical, High, Medium, or Low)",
"type": "string"
},
"size": {
"description": "The size which represents the amount of work needed",
"type": [
"string",
"number",
"null"
]
},
"startAt": {
"description": "The start date in ISO format (should be at 9:00am in user's timezone)",
"type": "string"
},
"status": {
"description": "The status from the list of available statuses",
"type": "string"
},
"tags": {
"description": "Array of tags to apply to the task",
"items": {
"type": "string"
},
"type": "array"
},
"taskRelationships": {
"description": "Task relationships including subtasks, blockers, duplicates, and related tasks",
"properties": {
"blockerIds": {
"description": "List of task IDs that block this task",
"items": {
"pattern": "^[a-zA-Z0-9]{12}$",
"type": "string"
},
"type": "array"
},
"blockingIds": {
"description": "List of task IDs that this task blocks",
"items": {
"pattern": "^[a-zA-Z0-9]{12}$",
"type": "string"
},
"type": "array"
},
"duplicateIds": {
"description": "List of task IDs that are duplicates of this task",
"items": {
"pattern": "^[a-zA-Z0-9]{12}$",
"type": "string"
},
"type": "array"
},
"relatedIds": {
"description": "List of task IDs that are related to this task",
"items": {
"pattern": "^[a-zA-Z0-9]{12}$",
"type": "string"
},
"type": "array"
},
"subtaskIds": {
"description": "List of task IDs that are subtasks of this task",
"items": {
"pattern": "^[a-zA-Z0-9]{12}$",
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"title": {
"description": "The title of the task (required)",
"type": "string"
},
"type": {
"description": "The type of the task from the list of available types",
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
}