> ## 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: Variables Put Variable By ID

> Change one Zoho CRM organization variable's name or value by its ID. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Change one Zoho CRM organization variable's name or value by its ID.

> [!NOTE]
>
> Tool ID: `zoho_crm_variables_put_variable_by_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_variables_put_variable_by_id',
  {
    "id": "id_123",
    "variables": [
      {
        "rid": "example",
        "value": "example"
      }
    ]
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute zoho_crm_variables_put_variable_by_id --input '{
  "id": "id_123",
  "variables": [
    {
      "rid": "example",
      "value": "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": {
    "variables": [
      {
        "code": "example",
        "details": {
          "id": "id_123",
          "rid": "example",
          "api_name": "Example"
        },
        "message": "Example message"
      }
    ]
  }
}
```

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

## Input reference

Alternate instance of the scoped batch update request wrapper for variable updates.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | variables id in url path Maximum length: 255. |
| `payload.variables` | `array` | Yes | — | variables jsonarray (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": "Alternate instance of the scoped batch update request wrapper for variable updates.",
    "properties": {
      "id": {
        "type": "string",
        "description": "variables id in url path",
        "maxLength": 255
      },
      "variables": {
        "type": "array",
        "description": "variables jsonarray (Required)",
        "maxItems": 1,
        "items": {
          "type": "object",
          "description": "Object used to update a variable's value within a scoped resource context; accepts id or rid and the new value.",
          "properties": {
            "rid": {
              "type": [
                "string",
                "null"
              ],
              "description": "uuid for variables",
              "maxLength": 36
            },
            "value": {
              "type": [
                "string",
                "null"
              ],
              "description": "describes value for the variables",
              "maxLength": 19
            }
          },
          "additionalProperties": false
        }
      }
    },
    "required": [
      "id",
      "variables"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Success response summarizing scoped batch updates with an array of per-item operation results. |
| `result.data.variables` | `array` | No | — | Field: variables Maximum items: 1. |
| `result.data.variables[].code` | `string` | No | — | Field: code Maximum length: 255. |
| `result.data.variables[].details` | `object` | No | — | Details of an individual variable operation result, including the id of the affected variable. |
| `result.data.variables[].details.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.variables[].details.rid` | `string` | No | — | Field: rid Maximum length: 255. |
| `result.data.variables[].details.api_name` | `string` | No | — | Field: api\_name Maximum length: 255. |
| `result.data.variables[].details.json_path` | `string` | No | — | Detail field: json\_path Maximum length: 255. |
| `result.data.variables[].message` | `string` | No | — | Field: message Maximum length: 255. |
| `result.data.variables[].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 summarizing scoped batch updates with an array of per-item operation results.",
        "properties": {
          "variables": {
            "type": "array",
            "description": "Field: variables",
            "maxItems": 1,
            "items": {
              "type": "object",
              "description": "Per-item outcome for a variable operation, including code, message, status, and details such as the resulting variable id.",
              "properties": {
                "code": {
                  "type": "string",
                  "description": "Field: code",
                  "maxLength": 255
                },
                "details": {
                  "type": "object",
                  "description": "Details of an individual variable operation result, including the id of the affected variable.",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Field: id",
                      "maxLength": 255
                    },
                    "rid": {
                      "type": "string",
                      "description": "Field: rid",
                      "maxLength": 255
                    },
                    "api_name": {
                      "type": "string",
                      "description": "Field: api_name",
                      "maxLength": 255
                    },
                    "json_path": {
                      "type": "string",
                      "description": "Detail field: json_path",
                      "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.