> ## Documentation Index > Fetch the complete documentation index at: https://deepline.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Pipedrive: Update Task > Update a task. Pipedrive Update Task reference includes SDK V2 and CLI requests, input constraints, response fields, and Deepline cost. Update a task. Tool ID: `pipedrive_update_task` ## Run this action Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV. ```ts theme={null} import { Deepline } from 'deepline'; const deepline = await Deepline.connect(); const result = await deepline.tools.execute( 'pipedrive_update_task', { "id": 123 }, ); console.log(result.toolResponse.raw); ``` ### CLI ```bash theme={null} deepline tools execute pipedrive_update_task --input '{ "id": 123 }' --json ``` ## Example response The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative. ```json theme={null} { "data": { "success": true, "data": { "id": 123, "title": "VP of Engineering", "creator_id": 123 }, "additional_data": {} } } ``` Use `deepline tools get pipedrive_update_task --json` for the latest machine-readable contract. ## Input reference Updates a task. | Name | Type | Required | Default | Details | | ------------------------ | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `payload.id` | `integer` | Yes | — | The ID of the task | | `payload.title` | `string` | No | — | The title of the task Minimum length: 1. Maximum length: 255. | | `payload.project_id` | `integer` | No | — | The ID of the project this task is associated with | | `payload.parent_task_id` | `integer` | No | — | The ID of the parent task. Cannot be the ID of a task that is already a subtask. | | `payload.description` | `string` | No | — | The description of the task | | `payload.done` | `0 \| 1` | No | — | Whether the task is done or not. `0` = Not done, `1` = Done. Allowed: `0`, `1`. | | `payload.milestone` | `0 \| 1` | No | — | Whether the task is a milestone or not. `0` = Not a milestone, `1` = Milestone. Allowed: `0`, `1`. | | `payload.due_date` | `string` | No | — | The due date of the task. Format: YYYY-MM-DD. Format: `date`. | | `payload.start_date` | `string` | No | — | The start date of the task. Format: YYYY-MM-DD. Format: `date`. | | `payload.assignee_id` | `integer` | No | — | The ID of the user assigned to the task. When set, the `assignee_ids` field will be overwritten with this value. | | `payload.assignee_ids` | `array` | No | — | The IDs of users assigned to the task. When set, the `assignee_id` field will be set to the first value in this array, or `null` if empty. Maximum items: 10. | | `payload.priority` | `integer` | No | — | The priority of the task Minimum: 0. |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "description": "Updates a task.", "properties": { "id": { "type": "integer", "description": "The ID of the task" }, "title": { "type": "string", "description": "The title of the task", "minLength": 1, "maxLength": 255 }, "project_id": { "type": "integer", "description": "The ID of the project this task is associated with" }, "parent_task_id": { "type": [ "integer", "null" ], "description": "The ID of the parent task. Cannot be the ID of a task that is already a subtask." }, "description": { "type": [ "string", "null" ], "description": "The description of the task" }, "done": { "type": "integer", "description": "Whether the task is done or not. `0` = Not done, `1` = Done.", "enum": [ 0, 1 ] }, "milestone": { "type": "integer", "description": "Whether the task is a milestone or not. `0` = Not a milestone, `1` = Milestone.", "enum": [ 0, 1 ] }, "due_date": { "type": [ "string", "null" ], "description": "The due date of the task. Format: YYYY-MM-DD.", "format": "date" }, "start_date": { "type": [ "string", "null" ], "description": "The start date of the task. Format: YYYY-MM-DD.", "format": "date" }, "assignee_id": { "type": [ "integer", "null" ], "description": "The ID of the user assigned to the task. When set, the `assignee_ids` field will be overwritten with this value." }, "assignee_ids": { "type": "array", "description": "The IDs of users assigned to the task. When set, the `assignee_id` field will be set to the first value in this array, or `null` if empty.", "maxItems": 10, "items": { "type": "integer" } }, "priority": { "type": [ "integer", "null" ], "description": "The priority of the task", "minimum": 0 } }, "required": [ "id" ], "additionalProperties": false } ```
## Output reference Standard tool result payload. | Name | Type | Required | Default | Details | | -------------------------------------- | ----------------- | -------- | ------- | -------------------------------------------------------------------- | | `result.data` | `object` | Yes | — | Provider response payload. | | `result.data.success` | `boolean` | No | — | If the response is successful or not | | `result.data.data` | `object` | No | — | — | | `result.data.data.id` | `integer` | No | — | The ID of the task | | `result.data.data.title` | `string` | No | — | The title of the task Minimum length: 1. Maximum length: 255. | | `result.data.data.creator_id` | `integer` | No | — | The ID of the user who created the task | | `result.data.data.description` | `string \| null` | No | — | The description of the task | | `result.data.data.project_id` | `integer` | No | — | The ID of the project this task is associated with | | `result.data.data.is_done` | `boolean` | No | — | Whether the task is done or not. | | `result.data.data.is_milestone` | `boolean` | No | — | Whether the task is a milestone or not. | | `result.data.data.due_date` | `string \| null` | No | — | The due date of the task. Format: YYYY-MM-DD. Format: `date`. | | `result.data.data.start_date` | `string \| null` | No | — | The start date of the task. Format: YYYY-MM-DD. Format: `date`. | | `result.data.data.parent_task_id` | `integer \| null` | No | — | The ID of the parent task. If `null`, the task is a root-level task. | | `result.data.data.assignee_ids` | `array` | No | — | The IDs of users assigned to the task | | `result.data.data.priority` | `integer \| null` | No | — | The priority of the task Minimum: 0. | | `result.data.data.add_time` | `string` | No | — | The creation date and time of the task in ISO 8601 format | | `result.data.data.update_time` | `string` | No | — | The update date and time of the task in ISO 8601 format | | `result.data.data.marked_as_done_time` | `string \| null` | No | — | The date and time the task was marked as done in ISO 8601 format | | `result.data.additional_data` | `object \| null` | No | — | — | | `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
Show raw output schema ### Output JSON Schema ```json theme={null} { "type": "object", "description": "Standard tool result payload.", "properties": { "data": { "type": "object", "description": "Provider response payload.", "properties": { "success": { "type": "boolean", "description": "If the response is successful or not" }, "data": { "type": "object", "properties": { "id": { "type": "integer", "description": "The ID of the task" }, "title": { "type": "string", "description": "The title of the task", "minLength": 1, "maxLength": 255 }, "creator_id": { "type": "integer", "description": "The ID of the user who created the task" }, "description": { "type": [ "string", "null" ], "description": "The description of the task" }, "project_id": { "type": "integer", "description": "The ID of the project this task is associated with" }, "is_done": { "type": "boolean", "description": "Whether the task is done or not." }, "is_milestone": { "type": "boolean", "description": "Whether the task is a milestone or not." }, "due_date": { "type": [ "string", "null" ], "description": "The due date of the task. Format: YYYY-MM-DD.", "format": "date" }, "start_date": { "type": [ "string", "null" ], "description": "The start date of the task. Format: YYYY-MM-DD.", "format": "date" }, "parent_task_id": { "type": [ "integer", "null" ], "description": "The ID of the parent task. If `null`, the task is a root-level task." }, "assignee_ids": { "type": "array", "description": "The IDs of users assigned to the task", "items": { "type": "integer" } }, "priority": { "type": [ "integer", "null" ], "description": "The priority of the task", "minimum": 0 }, "add_time": { "type": "string", "description": "The creation date and time of the task in ISO 8601 format" }, "update_time": { "type": "string", "description": "The update date and time of the task in ISO 8601 format" }, "marked_as_done_time": { "type": [ "string", "null" ], "description": "The date and time the task was marked as done in ISO 8601 format" } }, "additionalProperties": false }, "additional_data": { "type": [ "object", "null" ] } }, "additionalProperties": false }, "meta": { "type": "object", "description": "Additional response metadata (status, paging).", "additionalProperties": true } }, "required": [ "data" ], "additionalProperties": false } ```
## Deepline cost * Pricing model: `fixed` (per call). * Estimated Deepline credits: `0` per pricing unit. * Provider-native pricing may still exist outside Deepline credit billing. ## Related documentation * [Pipedrive provider guide](/docs/providers/pipedrive/guide) * [SDK V2 quickstart](/docs/sdk-v2/quickstart) * [SDK reference](/docs/sdk-v2/sdk-reference) * [Run tools across a CSV](/docs/sdk-v2/batch-csv)