> ## 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: README
> POST /{module}/actions/add_tags. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.
POST /\{module}/actions/add\_tags.
Tool ID: `zoho_crm_tags_actions_post_add_tags`
## Run this action
This action has conditional or dynamic input fields that cannot be represented by a reliable static example.
Inspect the live contract before executing it:
```bash theme={null}
deepline tools get zoho_crm_tags_actions_post_add_tags --json
```
## Example response
The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.
```json theme={null}
{
"data": {
"ids": "example",
"over_write": true,
"data": [
{
"code": "example",
"details": {
"modifiedTime": "example",
"id": "id_123",
"affected_data": null
},
"message": "Example message"
}
]
}
}
```
Use `deepline tools get zoho_crm_tags_actions_post_add_tags --json` for the latest machine-readable contract.
## Input reference
Request body schema
| Name | Type | Required | Default | Details |
| -------------------- | ----------------------------- | -------- | ------- | ------------------------------------------------------------------- |
| `payload.module` | `string` | Yes | — | Path parameter: module Maximum length: 50. |
| `payload.ids` | `"[\"3060320000002538026\"]"` | No | — | record ids Allowed: `["3060320000002538026"]`. Maximum length: 102. |
| `payload.over_write` | `boolean` | No | — | tag over write true false value |
| `payload.tags` | `array` | Yes | — | root key (Required) Maximum items: 3. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Request body schema",
"properties": {
"module": {
"type": "string",
"description": "Path parameter: module",
"maxLength": 50
},
"ids": {
"type": [
"string",
"null"
],
"description": "record ids",
"maxLength": 102,
"enum": [
"[\"3060320000002538026\"]"
]
},
"over_write": {
"type": [
"boolean",
"null"
],
"description": "tag over write true false value"
},
"tags": {
"type": "array",
"description": "root key (Required)",
"maxItems": 3,
"items": {
"type": "object",
"description": "root key",
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "tag name",
"maxLength": 25
},
"modified_time": {
"type": [
"string",
"null"
],
"description": "merged time",
"maxLength": 25,
"format": "date-time"
},
"color_code": {
"type": [
"string",
"null"
],
"description": "tag color",
"maxLength": 7
},
"conflict_id": {
"type": [
"string",
"null"
],
"description": "merged tag id",
"maxLength": 19
}
},
"additionalProperties": false
}
}
},
"required": [
"module",
"tags"
],
"additionalProperties": false
}
```
## Output reference
Standard tool result payload.
| Name | Type | Required | Default | Details |
| ---------------------------------------------- | ---------------- | -------- | ------- | ------------------------------------------------------------- |
| `result.data` | `object` | Yes | — | success response when tags associated successfully to records |
| `result.data.ids` | `string` | No | — | record ids Maximum length: 102. |
| `result.data.over_write` | `boolean` | No | — | over write tags value |
| `result.data.data` | `array` | No | — | Field: data Maximum items: 20. |
| `result.data.data[].code` | `string` | No | — | Field: code Maximum length: 255. |
| `result.data.data[].details` | `object` | No | — | Nested schema for details |
| `result.data.data[].details.modifiedTime` | `string` | No | — | Last modified time of the record Maximum length: 255. |
| `result.data.data[].details.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.data[].details.affected_data` | `null` | No | — | Field: affected\_data |
| `result.data.data[].details.tags` | `array` | No | — | Field: tags Maximum items: 10. |
| `result.data.data[].details.tags[].name` | `string` | No | — | tag name Maximum length: 255. |
| `result.data.data[].details.tags[].id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.data[].details.tags[].color_code` | `string \| null` | No | — | tag color Maximum length: 255. |
| `result.data.data[].message` | `string` | No | — | Field: message Maximum length: 255. |
| `result.data.data[].status` | `string` | No | — | Field: status Maximum length: 255. |
| `result.data.locked_count` | `string` | No | — | Field: locked\_count Maximum length: 255. |
| `result.data.success_count` | `string` | No | — | Field: success\_count Maximum length: 255. |
| `result.data.tags` | `string` | No | — | root key Maximum length: 255. |
| `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": "success response when tags associated successfully to records",
"properties": {
"ids": {
"type": "string",
"description": "record ids",
"maxLength": 102
},
"over_write": {
"type": "boolean",
"description": "over write tags value"
},
"data": {
"type": "array",
"description": "Field: data",
"maxItems": 20,
"items": {
"type": "object",
"description": "Nested schema for data",
"properties": {
"code": {
"type": "string",
"description": "Field: code",
"maxLength": 255
},
"details": {
"type": "object",
"description": "Nested schema for details",
"properties": {
"modifiedTime": {
"type": "string",
"description": "Last modified time of the record",
"maxLength": 255
},
"id": {
"type": "string",
"description": "Field: id",
"maxLength": 255
},
"affected_data": {
"type": "null",
"description": "Field: affected_data"
},
"tags": {
"type": "array",
"description": "Field: tags",
"maxItems": 10,
"items": {
"type": "object",
"description": "Nested schema for tags",
"properties": {
"name": {
"type": "string",
"description": "tag name",
"maxLength": 255
},
"id": {
"type": "string",
"description": "Field: id",
"maxLength": 255
},
"color_code": {
"type": [
"string",
"null"
],
"description": "tag color",
"maxLength": 255
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"message": {
"type": "string",
"description": "Field: message",
"maxLength": 255
},
"status": {
"type": "string",
"description": "Field: status",
"maxLength": 255
}
},
"additionalProperties": false
}
},
"locked_count": {
"type": "string",
"description": "Field: locked_count",
"maxLength": 255
},
"success_count": {
"type": "string",
"description": "Field: success_count",
"maxLength": 255
},
"tags": {
"type": "string",
"description": "root key",
"maxLength": 255
}
},
"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
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)