Actions31
- Agent Actions
- Attachment Actions
- Comment Actions
- Config Actions
- Dartboard Actions
- Doc Actions
- Folder Actions
- Help Center Article Actions
- Skill Actions
- Task Actions
- View Actions
Task → Update Task
AI-generatedSummary
Updates an existing Dart task by ID using a JSON body to specify changed fields.
Inputs
- id (required) — The unique ID of the task to update.
- item (required) — A JSON object defining the fields to update. Only provided fields are changed; omitted fields remain unchanged. Includes fields for assignees, reviewers, tags, customProperties, and taskRelationships.
- requestOptions — Optional configuration for HTTP requests, including batching, SSL settings, proxy, and timeout.
Output shape
A single item containing the updated task data.
The returned item reflects the state of the task after the update.
Examples
Example 1: Update a task's custom text property
ID: task-123, Item: { customProperties: { customTextProperty: "Updated description" } }
Example 2: Change task assignees and add tags
ID: task-456, Item: { assignees: ["user@example.com"], tags: ["high-priority", "review"] }
Example 3: Update task relationships
ID: task-789, Item: { taskRelationships: { relatedIds: ["rel-task-1", "rel-task-2"] } }