> ## 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: Tags Put Tags With ID

> Rename or recolor one Zoho CRM tag by its ID. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Rename or recolor one Zoho CRM tag by its ID.

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

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'zoho_crm_tags_put_tags_with_id',
  {
    "id": "id_123",
    "tags": [
      {
        "name": "Example"
      }
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute zoho_crm_tags_put_tags_with_id --input '{
  "id": "id_123",
  "tags": [
    {
      "name": "Example"
    }
  ]
}' --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": {
    "tags": [
      {
        "code": "example",
        "details": {
          "created_time": "2026-01-15T12:00:00Z",
          "modified_time": "2026-01-15T12:00:00Z",
          "name": "Example"
        },
        "message": "Example message"
      }
    ]
  }
}
```

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

## Input reference

Request body schema

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Path parameter: id Maximum length: 255. |
| `payload.tags` | `array` | Yes | — | Root key (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": "Path parameter: id",
        "maxLength": 255
      },
      "tags": {
        "type": "array",
        "description": "Root key (Required)",
        "maxItems": 1,
        "items": {
          "type": "object",
          "description": "Root key",
          "properties": {
            "name": {
              "type": "string",
              "description": "Tag name (Required)",
              "maxLength": 26
            },
            "color_code": {
              "type": [
                "string",
                "null"
              ],
              "description": "Tag color code",
              "maxLength": 7
            }
          },
          "required": [
            "name"
          ],
          "additionalProperties": true
        }
      }
    },
    "required": [
      "id",
      "tags"
    ],
    "additionalProperties": true
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Success Response when Tags update success |
| `result.data.tags` | `array` | No | — | Field: tags Maximum items: 1. |
| `result.data.tags[].code` | `string` | No | — | Field: code Maximum length: 255. |
| `result.data.tags[].details` | `object` | No | — | Nested schema for details |
| `result.data.tags[].details.created_time` | `string` | No | — | Field: created\_time Format: `date-time`. Maximum length: 255. |
| `result.data.tags[].details.modified_time` | `string` | No | — | Field: modified\_time Format: `date-time`. Maximum length: 255. |
| `result.data.tags[].details.name` | `string` | No | — | Field: name Maximum length: 255. |
| `result.data.tags[].details.modified_by` | `object` | No | — | Nested schema for modified\_by |
| `result.data.tags[].details.modified_by.name` | `string` | No | — | Field: name Maximum length: 255. |
| `result.data.tags[].details.modified_by.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.tags[].details.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.tags[].details.created_by` | `object` | No | — | Nested schema for created\_by |
| `result.data.tags[].details.created_by.name` | `string` | No | — | Field: name Maximum length: 255. |
| `result.data.tags[].details.created_by.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.tags[].details.color_code` | `string \| null` | No | — | Field: color\_code Maximum length: 255. |
| `result.data.tags[].message` | `string` | No | — | Field: message Maximum length: 255. |
| `result.data.tags[].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 when Tags update success",
        "properties": {
          "tags": {
            "type": "array",
            "description": "Field: tags",
            "maxItems": 1,
            "items": {
              "type": "object",
              "description": "Nested schema for tags",
              "properties": {
                "code": {
                  "type": "string",
                  "description": "Field: code",
                  "maxLength": 255
                },
                "details": {
                  "type": "object",
                  "description": "Nested schema for details",
                  "properties": {
                    "created_time": {
                      "type": "string",
                      "description": "Field: created_time",
                      "maxLength": 255,
                      "format": "date-time"
                    },
                    "modified_time": {
                      "type": "string",
                      "description": "Field: modified_time",
                      "maxLength": 255,
                      "format": "date-time"
                    },
                    "name": {
                      "type": "string",
                      "description": "Field: name",
                      "maxLength": 255
                    },
                    "modified_by": {
                      "type": "object",
                      "description": "Nested schema for modified_by",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Field: name",
                          "maxLength": 255
                        },
                        "id": {
                          "type": "string",
                          "description": "Field: id",
                          "maxLength": 255
                        }
                      },
                      "additionalProperties": false
                    },
                    "id": {
                      "type": "string",
                      "description": "Field: id",
                      "maxLength": 255
                    },
                    "created_by": {
                      "type": "object",
                      "description": "Nested schema for created_by",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Field: name",
                          "maxLength": 255
                        },
                        "id": {
                          "type": "string",
                          "description": "Field: id",
                          "maxLength": 255
                        }
                      },
                      "additionalProperties": false
                    },
                    "color_code": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Field: color_code",
                      "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.