Skip to content

Commit 2a94ac8

Browse files
committed
docs(zoho-desk): regenerate integration docs
Regenerate zoho_desk.mdx from the current tool definitions: removes the stale add_comment `ignoreSourceId` input row (the field was dropped because Zoho rejects arbitrary values) and adds the derived `contentText` / `descriptionText` plain-text fields on comments, threads, and tickets.
1 parent 78383e3 commit 2a94ac8

1 file changed

Lines changed: 16 additions & 10 deletions

File tree

apps/docs/content/docs/en/integrations/zoho_desk.mdx

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,8 @@ List tickets from a Zoho Desk organization with optional filters.
4444
|`id` | string | Ticket ID |
4545
|`ticketNumber` | string | Human-readable ticket number |
4646
|`subject` | string | Ticket subject |
47-
|`description` | string | Ticket description |
47+
|`description` | string | Ticket description \(raw; may be HTML\) |
48+
|`descriptionText` | string | Plain-text rendering of the description; HTML stripped when Zoho marks it HTML, otherwise mirrors description |
4849
|`status` | string | Ticket status |
4950
|`statusType` | string | Status category \(Open/Closed/On Hold\) |
5051
|`priority` | string | Ticket priority |
@@ -94,7 +95,8 @@ Retrieve a single Zoho Desk ticket by ID.
9495
|`id` | string | Ticket ID |
9596
|`ticketNumber` | string | Human-readable ticket number |
9697
|`subject` | string | Ticket subject |
97-
|`description` | string | Ticket description |
98+
|`description` | string | Ticket description \(raw; may be HTML\) |
99+
|`descriptionText` | string | Plain-text rendering of the description; HTML stripped when Zoho marks it HTML, otherwise mirrors description |
98100
|`status` | string | Ticket status |
99101
|`statusType` | string | Status category \(Open/Closed/On Hold\) |
100102
|`priority` | string | Ticket priority |
@@ -151,7 +153,8 @@ Update fields on an existing Zoho Desk ticket.
151153
|`id` | string | Ticket ID |
152154
|`ticketNumber` | string | Human-readable ticket number |
153155
|`subject` | string | Ticket subject |
154-
|`description` | string | Ticket description |
156+
|`description` | string | Ticket description \(raw; may be HTML\) |
157+
|`descriptionText` | string | Plain-text rendering of the description; HTML stripped when Zoho marks it HTML, otherwise mirrors description |
155158
|`status` | string | Ticket status |
156159
|`statusType` | string | Status category \(Open/Closed/On Hold\) |
157160
|`priority` | string | Ticket priority |
@@ -199,8 +202,9 @@ List comments on a Zoho Desk ticket.
199202
| --------- | ---- | ----------- |
200203
| `comments` | array | List of comments |
201204
|`id` | string | Comment ID |
202-
|`content` | string | Comment content |
205+
|`content` | string | Comment content \(raw; may be HTML\) |
203206
|`contentType` | string | Content type \(plainText/html\) |
207+
|`contentText` | string | Plain-text rendering of content \(HTML stripped when contentType is html\) |
204208
|`isPublic` | boolean | Whether the comment is public |
205209
|`commenterId` | string | Commenter ID |
206210
|`commentedTime` | string | Commented timestamp |
@@ -226,16 +230,16 @@ Add a comment to a Zoho Desk ticket.
226230
| `content` | string | Yes | Comment content |
227231
| `contentType` | string | No | Content type: plainText or html |
228232
| `isPublic` | boolean | No | Whether the comment is public |
229-
| `ignoreSourceId` | string | No | Source ID echoed back on the resulting webhook event so this write can be filtered out \(loop guard\) |
230233

231234
#### Output
232235

233236
| Parameter | Type | Description |
234237
| --------- | ---- | ----------- |
235238
| `comment` | object | The created comment |
236239
|`id` | string | Comment ID |
237-
|`content` | string | Comment content |
240+
|`content` | string | Comment content \(raw; may be HTML\) |
238241
|`contentType` | string | Content type \(plainText/html\) |
242+
|`contentText` | string | Plain-text rendering of content \(HTML stripped when contentType is html\) |
239243
|`isPublic` | boolean | Whether the comment is public |
240244
|`commenterId` | string | Commenter ID |
241245
|`commentedTime` | string | Commented timestamp |
@@ -268,8 +272,9 @@ List conversation threads on a Zoho Desk ticket.
268272
|`id` | string | Thread ID |
269273
|`channel` | string | Thread channel |
270274
|`direction` | string | Direction \(in/out\) |
271-
|`content` | string | Thread content |
275+
|`content` | string | Thread content \(raw; may be HTML\) |
272276
|`contentType` | string | Content type |
277+
|`contentText` | string | Plain-text rendering of content \(HTML stripped when contentType is html\) |
273278
|`summary` | string | Thread summary |
274279
|`responderId` | string | Responder ID |
275280
|`createdTime` | string | Created timestamp |
@@ -310,8 +315,9 @@ Retrieve the full content of a single Zoho Desk ticket thread.
310315
|`id` | string | Thread ID |
311316
|`channel` | string | Thread channel |
312317
|`direction` | string | Direction \(in/out\) |
313-
|`content` | string | Thread content |
318+
|`content` | string | Thread content \(raw; may be HTML\) |
314319
|`contentType` | string | Content type |
320+
|`contentText` | string | Plain-text rendering of content \(HTML stripped when contentType is html\) |
315321
|`summary` | string | Thread summary |
316322
|`responderId` | string | Responder ID |
317323
|`createdTime` | string | Created timestamp |
@@ -420,7 +426,7 @@ Trigger a workflow when a Zoho Desk event occurs (ticket, comment, thread, conta
420426
| Parameter | Type | Required | Description |
421427
| --------- | ---- | -------- | ----------- |
422428
| `triggerCredentials` | string | Yes | This trigger creates and manages a webhook subscription in your Zoho Desk account. |
423-
| `orgId` | string | Yes | The Zoho Desk organization \(portal\) to subscribe in. |
429+
| `orgId` | combobox | Yes | The Zoho Desk organization \(portal\) to subscribe in. |
424430
| `eventType` | string | Yes | Event |
425431
| `departmentIds` | string | No | Restrict events to these departments. Leave empty for all departments. |
426432
| `fields` | string | No | For Ticket Updated: only fire when one of these fields changes \(max 5\). Previous values are included in the payload. |
@@ -433,6 +439,6 @@ Trigger a workflow when a Zoho Desk event occurs (ticket, comment, thread, conta
433439
| `eventType` | string | The Zoho Desk event type \(e.g. Ticket_Add\) |
434440
| `eventTime` | string | Event time in milliseconds since epoch |
435441
| `orgId` | string | Zoho Desk organization ID |
436-
| `payload` | json | The full resource that changed \(ticket, comment, thread, etc.\) |
442+
| `payload` | json | The full resource that changed \(ticket, comment, thread, etc.\). For comment/thread events a derived plain-text `contentText` is added alongside the raw `content` + `contentType`. |
437443
| `prevState` | json | Previous state of the resource \(update events only\) |
438444

0 commit comments

Comments
 (0)