Actions35
- Agent Actions
- Attachment Actions
- Auth Actions
- Comment Actions
- Config Actions
- Dartboard Actions
- Doc Actions
- Folder Actions
- Help Center Article Actions
- Skill Actions
- Task Actions
- View Actions
Task → Update Task Description
AI-generatedSummary
Apply ordered, targeted text edits to a Dart task’s description through the task description update endpoint. Each update acts on the result of the previous one, and the updates are applied atomically; if any fails, none are saved.
Inputs
- ID (required) — The task’s 12-character alphanumeric Dart ID, not its title or URL.
- Updates (required) — A JSON array of text updates. Supported actions are replace, insert_before, insert_after, and delete. Updates run in order; when the target text is not unique, specify its 1-indexed occurrence.
- Request Options — Optional batching, SSL certificate validation, HTTP proxy, and request timeout settings.
Output shape
A single API response for the task description update.
The operation uses POST /tasks/{ID}/update-description. The supplied properties do not specify the response fields or whether the response includes the updated task.
Examples
Example 1: Replace a unique phrase
Provide the task ID and an Updates array containing a replace action with oldText and newText.