> ## 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.

# Zoho CRM: Workflow Tasks Put Tasks By ID

> Change one Zoho CRM workflow task action by its ID. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Change one Zoho CRM workflow task action by its ID.

> [!NOTE]
>
> Tool ID: `zoho_crm_workflow_tasks_put_tasks_by_id`

## Run this action

This action has conditional or dynamic inputs. A static example cannot describe these inputs reliably.

Read the live contract before you execute this action:

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline describe zoho_crm_workflow_tasks_put_tasks_by_id --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "tasks": [
      {
        "code": "example",
        "details": {
          "resource_path_index": "example",
          "id": "id_123"
        },
        "message": "Example message"
      }
    ]
  }
}
```

Use `deepline describe zoho_crm_workflow_tasks_put_tasks_by_id --json` for the latest machine-readable contract.

## Input reference

Request body schema

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | The ID of the task to retrieve Maximum length: 20. |
| `payload.tasks` | `array` | Yes | — | Root Element (Required) Maximum items: 1. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Request body schema",
    "properties": {
      "id": {
        "type": "string",
        "description": "The ID of the task to retrieve",
        "maxLength": 20
      },
      "tasks": {
        "type": "array",
        "description": "Root Element (Required)",
        "maxItems": 1,
        "items": {
          "type": "object",
          "description": "Describes tasks within the system, including metadata, status, fields, and associated entities.",
          "properties": {
            "created_time": {
              "type": "string",
              "description": "Field: created_time",
              "maxLength": 255
            },
            "lock_status": {
              "type": "object",
              "description": "Represents the lock status of a resource, indicating whether it is currently locked or not.",
              "properties": {
                "locked": {
                  "type": "boolean",
                  "description": "Field: locked"
                }
              },
              "additionalProperties": false
            },
            "editable": {
              "type": "boolean",
              "description": "Field: editable"
            },
            "module": {
              "type": "object",
              "description": "Contains information about a module, including labels and API names.",
              "properties": {
                "singular_label": {
                  "type": "string",
                  "description": "Field: singular_label",
                  "maxLength": 255
                },
                "moduleName": {
                  "type": "string",
                  "description": "Field: moduleName",
                  "maxLength": 255
                },
                "id": {
                  "type": "string",
                  "description": "Field: id",
                  "maxLength": 255
                },
                "plural_label": {
                  "type": "string",
                  "description": "Field: plural_label",
                  "maxLength": 255
                },
                "api_name": {
                  "type": "string",
                  "description": "Field: api_name",
                  "maxLength": 255
                }
              },
              "required": [
                "api_name"
              ],
              "additionalProperties": false
            },
            "related_module": {
              "type": [
                "object",
                "null"
              ],
              "description": "Describes a related module, with details about its labels, API name, and ID.",
              "properties": {
                "singular_label": {
                  "type": "string",
                  "description": "Field: singular_label",
                  "maxLength": 255
                },
                "plural_label": {
                  "type": "string",
                  "description": "Field: plural_label",
                  "maxLength": 255
                },
                "api_name": {
                  "type": "string",
                  "description": "Field: api_name",
                  "maxLength": 255
                },
                "id": {
                  "type": "string",
                  "description": "Field: id",
                  "maxLength": 255
                },
                "module_name": {
                  "type": "string",
                  "description": "Field: module_name",
                  "maxLength": 255
                }
              },
              "additionalProperties": false
            },
            "deletable": {
              "type": "boolean",
              "description": "Field: deletable"
            },
            "source": {
              "type": "string",
              "description": "Field: source",
              "maxLength": 255
            },
            "created_by": {
              "type": "object",
              "description": "Provides details about the creator of an entity, including their name and ID.",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Field: name",
                  "maxLength": 255
                },
                "id": {
                  "type": "string",
                  "description": "Field: id",
                  "maxLength": 255
                }
              },
              "additionalProperties": false
            },
            "notify": {
              "type": "boolean",
              "description": "Field: notify"
            },
            "feature_type": {
              "type": "string",
              "description": "Field: feature_type",
              "maxLength": 255
            },
            "field_mappings": {
              "type": "array",
              "description": "Field: field_mappings",
              "maxItems": 20,
              "items": {
                "type": "object",
                "description": "Defines mappings of fields, including display values, types, and associated fields.",
                "properties": {
                  "display_value": {
                    "type": "string",
                    "description": "Field: display_value",
                    "maxLength": 255
                  },
                  "field": {
                    "type": "object",
                    "description": "Describes a field in a module, including its API name and identifier.",
                    "properties": {
                      "api_name": {
                        "type": "string",
                        "description": "Field: api_name",
                        "maxLength": 255
                      },
                      "id": {
                        "type": "string",
                        "description": "Field: id",
                        "maxLength": 255
                      }
                    },
                    "required": [
                      "api_name",
                      "id"
                    ],
                    "additionalProperties": false
                  },
                  "type": {
                    "type": "string",
                    "description": "Field: type",
                    "maxLength": 255,
                    "enum": [
                      "static",
                      "merge_field",
                      "execution_time"
                    ]
                  },
                  "value": {
                    "description": "Field: value",
                    "anyOf": [
                      {
                        "type": "string",
                        "description": "Field: value",
                        "maxLength": 255
                      },
                      {
                        "type": "object",
                        "description": "Field: value",
                        "additionalProperties": true
                      },
                      {
                        "type": "array",
                        "description": "Field: value",
                        "maxItems": 20,
                        "items": {
                          "type": "string",
                          "description": "Array item for field value",
                          "maxLength": 20
                        }
                      }
                    ]
                  }
                },
                "required": [
                  "type",
                  "value"
                ],
                "additionalProperties": false
              }
            },
            "modified_time": {
              "type": "string",
              "description": "Field: modified_time",
              "maxLength": 255
            },
            "associated": {
              "type": "boolean",
              "description": "Field: associated"
            },
            "modified_by": {
              "type": "object",
              "description": "Provides details about the individual who modified an entity, including their name and ID.",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Field: name",
                  "maxLength": 255
                },
                "id": {
                  "type": "string",
                  "description": "Field: id",
                  "maxLength": 255
                }
              },
              "additionalProperties": false
            },
            "name": {
              "type": "string",
              "description": "Field: name",
              "maxLength": 255
            },
            "id": {
              "type": "string",
              "description": "Field: id",
              "maxLength": 255
            }
          },
          "required": [
            "field_mappings",
            "module",
            "name"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "id",
      "tasks"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Success response |
| `result.data.tasks` | `array` | No | — | Field: tasks Maximum items: 1. |
| `result.data.tasks[].code` | `string` | No | — | Field: code Maximum length: 255. |
| `result.data.tasks[].details` | `object` | No | — | Nested schema for details |
| `result.data.tasks[].details.resource_path_index` | `string` | No | — | Field: resource\_path\_index Maximum length: 255. |
| `result.data.tasks[].details.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.tasks[].message` | `string` | No | — | Field: message Maximum length: 255. |
| `result.data.tasks[].status` | `string` | No | — | Field: status Maximum length: 255. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Success response",
        "properties": {
          "tasks": {
            "type": "array",
            "description": "Field: tasks",
            "maxItems": 1,
            "items": {
              "type": "object",
              "description": "Nested schema for tasks",
              "properties": {
                "code": {
                  "type": "string",
                  "description": "Field: code",
                  "maxLength": 255
                },
                "details": {
                  "type": "object",
                  "description": "Nested schema for details",
                  "properties": {
                    "resource_path_index": {
                      "type": "string",
                      "description": "Field: resource_path_index",
                      "maxLength": 255
                    },
                    "id": {
                      "type": "string",
                      "description": "Field: id",
                      "maxLength": 255
                    }
                  },
                  "additionalProperties": false
                },
                "message": {
                  "type": "string",
                  "description": "Field: message",
                  "maxLength": 255
                },
                "status": {
                  "type": "string",
                  "description": "Field: status",
                  "maxLength": 255
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## 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

* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.