> ## 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: Territories Transfer And Delete Territory By ID

> Delete one Zoho CRM territory and move its records and users to another territory. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Delete one Zoho CRM territory and move its records and users to another territory.

> [!NOTE]
>
> Tool ID: `zoho_crm_territories_transfer_and_delete_territory_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_territories_transfer_and_delete_territory_by_id',
  {
    "id": "id_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute zoho_crm_territories_transfer_and_delete_territory_by_id --input '{
  "id": "id_123"
}' --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": {
    "territories": [
      {
        "code": "SUCCESS",
        "details": {
          "id": "id_123"
        },
        "message": "Example message",
        "status": "success"
      }
    ]
  }
}
```

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

## Input reference

The `schema` field of type `object`.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Parameter `id` in `path`. Maximum length: 100. |
| `payload.territories` | `array` | No | — | The `territories` property. Maximum items: 100. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "The `schema` field of type `object`.",
    "properties": {
      "id": {
        "type": "string",
        "description": "Parameter `id` in `path`.",
        "maxLength": 100
      },
      "territories": {
        "type": "array",
        "description": "The `territories` property.",
        "maxItems": 100,
        "items": {
          "type": "object",
          "description": "The `items` field of type `object`.",
          "properties": {
            "id": {
              "type": "string",
              "description": "The `id` property.",
              "maxLength": 100
            },
            "transfer_to_id": {
              "type": "string",
              "description": "The `transfer_to_id` property.",
              "maxLength": 100
            },
            "delete_previous_forecasts": {
              "type": "boolean",
              "description": "The `delete_previous_forecasts` property."
            }
          },
          "required": [
            "transfer_to_id"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Schema representing the API response for territory creation. |
| `result.data.territories` | `array` | Yes | — | List of territories created or processed by the API. Maximum items: 10. |
| `result.data.territories[].code` | `"SUCCESS" \| "ERROR"` | Yes | — | Status code indicating the result of the operation (e.g., SUCCESS, ERROR). Allowed: `SUCCESS`, `ERROR`. |
| `result.data.territories[].details` | `object` | Yes | — | Additional information about the created territory. |
| `result.data.territories[].details.id` | `string` | Yes | — | Unique identifier of the created territory. Format: `string`. |
| `result.data.territories[].message` | `string` | Yes | — | Human-readable message describing the outcome of the operation. Format: `string`. |
| `result.data.territories[].status` | `"success" \| "failure" \| "error"` | Yes | — | Indicates whether the operation succeeded or failed. Allowed: `success`, `failure`, `error`. |
| `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": "Schema representing the API response for territory creation.",
        "properties": {
          "territories": {
            "type": "array",
            "description": "List of territories created or processed by the API.",
            "maxItems": 10,
            "items": {
              "type": "object",
              "description": "Details of each territory operation.",
              "properties": {
                "code": {
                  "type": "string",
                  "description": "Status code indicating the result of the operation (e.g., SUCCESS, ERROR).",
                  "enum": [
                    "SUCCESS",
                    "ERROR"
                  ]
                },
                "details": {
                  "type": "object",
                  "description": "Additional information about the created territory.",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique identifier of the created territory.",
                      "format": "string"
                    }
                  },
                  "required": [
                    "id"
                  ],
                  "additionalProperties": false
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable message describing the outcome of the operation.",
                  "format": "string"
                },
                "status": {
                  "type": "string",
                  "description": "Indicates whether the operation succeeded or failed.",
                  "enum": [
                    "success",
                    "failure",
                    "error"
                  ]
                }
              },
              "required": [
                "code",
                "details",
                "message",
                "status"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "territories"
        ],
        "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.