@bubblelab/bubble-core 0.1.231 → 0.1.232

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-03-15T13:57:23.288Z",
+  "generatedAt": "2026-03-16T08:24:07.162Z",
   "totalCount": 75,
   "bubbles": [
     {
@@ -74365,6 +74365,50 @@
                 },
                 "description": "Tags to apply to the ticket"
               },
+              "custom_fields": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "number",
+                      "description": "Custom ticket field ID"
+                    },
+                    "value": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        {
+                          "enum": [
+                            "null"
+                          ],
+                          "nullable": true
+                        }
+                      ],
+                      "description": "Field value. For dropdowns use the tag name, for multiselect use an array of tag names, for dates use \"YYYY-MM-DD\""
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "value"
+                  ],
+                  "additionalProperties": false
+                },
+                "description": "Custom field values. Use list_ticket_fields to discover available fields and their IDs."
+              },
               "credentials": {
                 "type": "object",
                 "additionalProperties": {
@@ -74437,6 +74481,50 @@
                 },
                 "description": "Replace ticket tags with this list"
               },
+              "custom_fields": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "number",
+                      "description": "Custom ticket field ID"
+                    },
+                    "value": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        {
+                          "enum": [
+                            "null"
+                          ],
+                          "nullable": true
+                        }
+                      ],
+                      "description": "Field value. For dropdowns use the tag name, for multiselect use an array of tag names, for dates use \"YYYY-MM-DD\""
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "value"
+                  ],
+                  "additionalProperties": false
+                },
+                "description": "Custom field values to set. Use list_ticket_fields to discover available fields and their IDs."
+              },
               "credentials": {
                 "type": "object",
                 "additionalProperties": {
@@ -74795,6 +74883,148 @@
               "article_id"
             ],
             "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "list_ticket_fields"
+                ],
+                "description": "List all ticket fields (system and custom) to discover field IDs, types, and allowed values"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "create_ticket_field"
+                ],
+                "description": "Create a new custom ticket field (admin only)"
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "text",
+                  "textarea",
+                  "checkbox",
+                  "date",
+                  "integer",
+                  "decimal",
+                  "regexp",
+                  "partialcreditcard",
+                  "multiselect",
+                  "tagger",
+                  "lookup"
+                ],
+                "description": "Field type"
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Field display title"
+              },
+              "description": {
+                "type": "string",
+                "description": "Field description"
+              },
+              "required": {
+                "type": "boolean",
+                "description": "Whether agents must fill this field to mark a ticket as solved"
+              },
+              "active": {
+                "type": "boolean",
+                "default": true,
+                "description": "Whether field is active"
+              },
+              "custom_field_options": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "type": "string",
+                      "description": "Display name of the option"
+                    },
+                    "value": {
+                      "type": "string",
+                      "description": "Tag value for this option"
+                    }
+                  },
+                  "required": [
+                    "name",
+                    "value"
+                  ],
+                  "additionalProperties": false
+                },
+                "description": "Options for tagger/multiselect fields. Each option needs a display name and a tag value."
+              },
+              "tag": {
+                "type": "string",
+                "description": "Tag added when checkbox is selected (checkbox type only)"
+              },
+              "regexp_for_validation": {
+                "type": "string",
+                "description": "Validation regex (regexp type only)"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "type",
+              "title"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "delete_ticket_field"
+                ],
+                "description": "Delete a custom ticket field (admin only). System fields cannot be deleted."
+              },
+              "ticket_field_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "ID of the ticket field to delete"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "ticket_field_id"
+            ],
+            "additionalProperties": false
           }
         ]
       },
@@ -74865,6 +75095,49 @@
                       },
                       "description": "Ticket tags"
                     },
+                    "custom_fields": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "number"
+                          },
+                          "value": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "boolean"
+                              },
+                              {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                }
+                              },
+                              {
+                                "enum": [
+                                  "null"
+                                ],
+                                "nullable": true
+                              }
+                            ],
+                            "nullable": true
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "value"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "Custom field values on the ticket"
+                    },
                     "created_at": {
                       "type": "string",
                       "description": "Created timestamp"
@@ -74966,6 +75239,49 @@
                     },
                     "description": "Ticket tags"
                   },
+                  "custom_fields": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "number"
+                        },
+                        "value": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            {
+                              "enum": [
+                                "null"
+                              ],
+                              "nullable": true
+                            }
+                          ],
+                          "nullable": true
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "value"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "description": "Custom field values on the ticket"
+                  },
                   "created_at": {
                     "type": "string",
                     "description": "Created timestamp"
@@ -75056,6 +75372,49 @@
                     },
                     "description": "Ticket tags"
                   },
+                  "custom_fields": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "number"
+                        },
+                        "value": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            {
+                              "enum": [
+                                "null"
+                              ],
+                              "nullable": true
+                            }
+                          ],
+                          "nullable": true
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "value"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "description": "Custom field values on the ticket"
+                  },
                   "created_at": {
                     "type": "string",
                     "description": "Created timestamp"
@@ -75146,6 +75505,49 @@
                     },
                     "description": "Ticket tags"
                   },
+                  "custom_fields": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "number"
+                        },
+                        "value": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            {
+                              "enum": [
+                                "null"
+                              ],
+                              "nullable": true
+                            }
+                          ],
+                          "nullable": true
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "value"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "description": "Custom field values on the ticket"
+                  },
                   "created_at": {
                     "type": "string",
                     "description": "Created timestamp"
@@ -75559,6 +75961,196 @@
             ],
             "additionalProperties": false
           },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "list_ticket_fields"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "ticket_fields": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "number",
+                      "description": "Field ID"
+                    },
+                    "type": {
+                      "type": "string",
+                      "description": "Field type (text, textarea, checkbox, date, integer, decimal, tagger, multiselect, etc.)"
+                    },
+                    "title": {
+                      "type": "string",
+                      "description": "Field display title"
+                    },
+                    "description": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "Field description"
+                    },
+                    "active": {
+                      "type": "boolean",
+                      "description": "Whether the field is active"
+                    },
+                    "required": {
+                      "type": "boolean",
+                      "description": "Whether the field is required"
+                    },
+                    "custom_field_options": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string",
+                            "description": "Display name of the option"
+                          },
+                          "value": {
+                            "type": "string",
+                            "description": "Tag value to use when setting this field"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "value"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "nullable": true,
+                      "description": "Available options for dropdown/tagger/multiselect fields"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "type",
+                    "title"
+                  ],
+                  "additionalProperties": false
+                },
+                "description": "List of ticket fields"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "create_ticket_field"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "ticket_field": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "number",
+                    "description": "Created field ID"
+                  },
+                  "type": {
+                    "type": "string",
+                    "description": "Field type"
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Field title"
+                  },
+                  "active": {
+                    "type": "boolean",
+                    "description": "Whether field is active"
+                  },
+                  "required": {
+                    "type": "boolean",
+                    "description": "Whether field is required"
+                  },
+                  "custom_field_options": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string"
+                        },
+                        "value": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "value"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "nullable": true
+                  }
+                },
+                "required": [
+                  "id",
+                  "type",
+                  "title"
+                ],
+                "additionalProperties": false,
+                "description": "Created ticket field"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "delete_ticket_field"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
+          },
           {
             "type": "object",
             "properties": {
@@ -75716,7 +76308,7 @@
           }
         ]
       },
-      "usageExample": "// List Tickets example\nconst zendesk_list_tickets = new ZendeskBubble({\n  operation: \"list_tickets\", // List tickets with optional filters\n  status: \"new\" // options: \"new\", \"open\", \"pending\", \"hold\", \"solved\", \"closed\", // Filter by ticket status\n  sort_by: \"created_at\" // options: \"created_at\", \"updated_at\", \"priority\", \"status\", // Sort field (default: updated_at)\n  sort_order: \"asc\" // options: \"asc\", \"desc\", // Sort order (default: desc)\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_tickets.action();\n// outputSchema for result.data when operation === 'list_tickets':\n// {\n//   operation: \"list_tickets\",\n//   success: boolean // Whether the operation was successful,\n//   tickets: { id: number // Ticket ID, subject: string | undefined // Ticket subject, description: string | undefined // Ticket description, status: string | undefined // Ticket status, priority: string | undefined | null // Ticket priority, type: string | undefined | null // Ticket type, requester_id: number | undefined // Requester user ID, assignee_id: number | undefined | null // Assignee user ID, organization_id: number | undefined | null // Organization ID, tags: string[] | undefined // Ticket tags, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp }[] | undefined // List of tickets,\n//   count: number | undefined // Total ticket count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Ticket example\nconst zendesk_get_ticket = new ZendeskBubble({\n  operation: \"get_ticket\", // Retrieve a single ticket by ID with full details\n  ticket_id: \"example string\", // Zendesk ticket ID (numeric string)\n});\n\nconst result = await zendesk_get_ticket.action();\n// outputSchema for result.data when operation === 'get_ticket':\n// {\n//   operation: \"get_ticket\",\n//   success: boolean // Whether the operation was successful,\n//   ticket: { id: number // Ticket ID, subject: string | undefined // Ticket subject, description: string | undefined // Ticket description, status: string | undefined // Ticket status, priority: string | undefined | null // Ticket priority, type: string | undefined | null // Ticket type, requester_id: number | undefined // Requester user ID, assignee_id: number | undefined | null // Assignee user ID, organization_id: number | undefined | null // Organization ID, tags: string[] | undefined // Ticket tags, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Retrieved ticket,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Ticket example\nconst zendesk_create_ticket = new ZendeskBubble({\n  operation: \"create_ticket\", // Create a new support ticket\n  subject: \"example string\", // Ticket subject line\n  body: \"example string\", // Ticket description / initial comment body\n  requester_email: \"example string\", // Email of the requester (creates user if not found)\n  requester_name: \"example string\", // Name of the requester (used when creating a new requester alongside email)\n  assignee_id: 42, // Agent ID to assign the ticket to\n  priority: \"urgent\" // options: \"urgent\", \"high\", \"normal\", \"low\", // Ticket priority\n  type: \"problem\" // options: \"problem\", \"incident\", \"question\", \"task\", // Ticket type\n  tags: [\"example string\"], // Tags to apply to the ticket\n});\n\nconst result = await zendesk_create_ticket.action();\n// outputSchema for result.data when operation === 'create_ticket':\n// {\n//   operation: \"create_ticket\",\n//   success: boolean // Whether the operation was successful,\n//   ticket: { id: number // Ticket ID, subject: string | undefined // Ticket subject, description: string | undefined // Ticket description, status: string | undefined // Ticket status, priority: string | undefined | null // Ticket priority, type: string | undefined | null // Ticket type, requester_id: number | undefined // Requester user ID, assignee_id: number | undefined | null // Assignee user ID, organization_id: number | undefined | null // Organization ID, tags: string[] | undefined // Ticket tags, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Created ticket,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update Ticket example\nconst zendesk_update_ticket = new ZendeskBubble({\n  operation: \"update_ticket\", // Update a ticket: add a reply/comment, change status, priority, or assignee\n  ticket_id: \"example string\", // Zendesk ticket ID (numeric string)\n  comment: \"example string\", // Comment body to add to the ticket (public reply or internal note)\n  public: true // default, // Whether the comment is public (visible to requester) or internal note (default: true)\n  status: \"new\" // options: \"new\", \"open\", \"pending\", \"hold\", \"solved\", \"closed\", // Set new ticket status\n  priority: \"urgent\" // options: \"urgent\", \"high\", \"normal\", \"low\", // Set new ticket priority\n  assignee_id: 42, // Reassign ticket to this agent ID\n  tags: [\"example string\"], // Replace ticket tags with this list\n});\n\nconst result = await zendesk_update_ticket.action();\n// outputSchema for result.data when operation === 'update_ticket':\n// {\n//   operation: \"update_ticket\",\n//   success: boolean // Whether the operation was successful,\n//   ticket: { id: number // Ticket ID, subject: string | undefined // Ticket subject, description: string | undefined // Ticket description, status: string | undefined // Ticket status, priority: string | undefined | null // Ticket priority, type: string | undefined | null // Ticket type, requester_id: number | undefined // Requester user ID, assignee_id: number | undefined | null // Assignee user ID, organization_id: number | undefined | null // Organization ID, tags: string[] | undefined // Ticket tags, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Updated ticket,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Ticket Comments example\nconst zendesk_list_ticket_comments = new ZendeskBubble({\n  operation: \"list_ticket_comments\", // List comments/replies on a ticket\n  ticket_id: \"example string\", // Zendesk ticket ID (numeric string)\n  sort_order: \"asc\" // options: \"asc\", \"desc\", // Sort order for comments (default: asc — oldest first)\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_ticket_comments.action();\n// outputSchema for result.data when operation === 'list_ticket_comments':\n// {\n//   operation: \"list_ticket_comments\",\n//   success: boolean // Whether the operation was successful,\n//   comments: { id: number // Comment ID, body: string | undefined // Comment body text, html_body: string | undefined // Comment body HTML, public: boolean | undefined // Whether comment is public, author_id: number | undefined // Author user ID, created_at: string | undefined // Created timestamp }[] | undefined // List of comments,\n//   count: number | undefined // Total comment count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Users example\nconst zendesk_list_users = new ZendeskBubble({\n  operation: \"list_users\", // List or search users\n  query: \"example string\", // Search query (name or email)\n  role: \"end-user\" // options: \"end-user\", \"agent\", \"admin\", // Filter by user role\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_users.action();\n// outputSchema for result.data when operation === 'list_users':\n// {\n//   operation: \"list_users\",\n//   success: boolean // Whether the operation was successful,\n//   users: { id: number // User ID, name: string | undefined // User name, email: string | undefined // User email, role: string | undefined // User role (end-user, agent, admin), organization_id: number | undefined | null // Organization ID, active: boolean | undefined // Whether user is active, created_at: string | undefined // Created timestamp }[] | undefined // List of users,\n//   count: number | undefined // Total user count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get User example\nconst zendesk_get_user = new ZendeskBubble({\n  operation: \"get_user\", // Retrieve a single user by ID\n  user_id: \"example string\", // Zendesk user ID (numeric string)\n});\n\nconst result = await zendesk_get_user.action();\n// outputSchema for result.data when operation === 'get_user':\n// {\n//   operation: \"get_user\",\n//   success: boolean // Whether the operation was successful,\n//   user: { id: number // User ID, name: string | undefined // User name, email: string | undefined // User email, role: string | undefined // User role (end-user, agent, admin), organization_id: number | undefined | null // Organization ID, active: boolean | undefined // Whether user is active, created_at: string | undefined // Created timestamp } | undefined // Retrieved user,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Organizations example\nconst zendesk_list_organizations = new ZendeskBubble({\n  operation: \"list_organizations\", // List or search organizations\n  query: \"example string\", // Search by organization name or external ID\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_organizations.action();\n// outputSchema for result.data when operation === 'list_organizations':\n// {\n//   operation: \"list_organizations\",\n//   success: boolean // Whether the operation was successful,\n//   organizations: { id: number // Organization ID, name: string | undefined // Organization name, domain_names: string[] | undefined // Associated domain names, external_id: string | undefined | null // External ID, created_at: string | undefined // Created timestamp }[] | undefined // List of organizations,\n//   count: number | undefined // Total organization count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Organization example\nconst zendesk_get_organization = new ZendeskBubble({\n  operation: \"get_organization\", // Retrieve a single organization by ID\n  organization_id: \"example string\", // Zendesk organization ID (numeric string)\n});\n\nconst result = await zendesk_get_organization.action();\n// outputSchema for result.data when operation === 'get_organization':\n// {\n//   operation: \"get_organization\",\n//   success: boolean // Whether the operation was successful,\n//   organization: { id: number // Organization ID, name: string | undefined // Organization name, domain_names: string[] | undefined // Associated domain names, external_id: string | undefined | null // External ID, created_at: string | undefined // Created timestamp } | undefined // Retrieved organization,\n//   error: string // Error message if operation failed\n// }\n\n\n// Search example\nconst zendesk_search = new ZendeskBubble({\n  operation: \"search\", // Unified search across tickets, users, and organizations using Zendesk query syntax\n  query: \"example string\", // Zendesk search query (e.g., \"type:ticket status:open\", \"type:user email:john@example.com\")\n  sort_by: \"updated_at\" // options: \"updated_at\", \"created_at\", \"priority\", \"status\", \"ticket_type\", // Sort field\n  sort_order: \"asc\" // options: \"asc\", \"desc\", // Sort order (default: desc)\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_search.action();\n// outputSchema for result.data when operation === 'search':\n// {\n//   operation: \"search\",\n//   success: boolean // Whether the operation was successful,\n//   results: Record<string, unknown>[] | undefined // Search results (mixed types),\n//   count: number | undefined // Total result count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Articles example\nconst zendesk_list_articles = new ZendeskBubble({\n  operation: \"list_articles\", // List or search Help Center articles\n  query: \"example string\", // Search query for articles\n  section_id: \"example string\", // Filter articles by section ID\n  category_id: \"example string\", // Filter articles by category ID\n  locale: \"example string\", // Filter by locale (e.g., \"en-us\")\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_articles.action();\n// outputSchema for result.data when operation === 'list_articles':\n// {\n//   operation: \"list_articles\",\n//   success: boolean // Whether the operation was successful,\n//   articles: { id: number // Article ID, title: string | undefined // Article title, body: string | undefined // Article body HTML, locale: string | undefined // Article locale, section_id: number | undefined // Section ID, author_id: number | undefined // Author user ID, draft: boolean | undefined // Whether article is a draft, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp }[] | undefined // List of articles,\n//   count: number | undefined // Total article count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Article example\nconst zendesk_get_article = new ZendeskBubble({\n  operation: \"get_article\", // Retrieve a single Help Center article by ID with body content\n  article_id: \"example string\", // Zendesk Help Center article ID\n  locale: \"example string\", // Locale for the article (e.g., \"en-us\")\n});\n\nconst result = await zendesk_get_article.action();\n// outputSchema for result.data when operation === 'get_article':\n// {\n//   operation: \"get_article\",\n//   success: boolean // Whether the operation was successful,\n//   article: { id: number // Article ID, title: string | undefined // Article title, body: string | undefined // Article body HTML, locale: string | undefined // Article locale, section_id: number | undefined // Section ID, author_id: number | undefined // Author user ID, draft: boolean | undefined // Whether article is a draft, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Retrieved article,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`zendesk failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "usageExample": "// List Tickets example\nconst zendesk_list_tickets = new ZendeskBubble({\n  operation: \"list_tickets\", // List tickets with optional filters\n  status: \"new\" // options: \"new\", \"open\", \"pending\", \"hold\", \"solved\", \"closed\", // Filter by ticket status\n  sort_by: \"created_at\" // options: \"created_at\", \"updated_at\", \"priority\", \"status\", // Sort field (default: updated_at)\n  sort_order: \"asc\" // options: \"asc\", \"desc\", // Sort order (default: desc)\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_tickets.action();\n// outputSchema for result.data when operation === 'list_tickets':\n// {\n//   operation: \"list_tickets\",\n//   success: boolean // Whether the operation was successful,\n//   tickets: { id: number // Ticket ID, subject: string | undefined // Ticket subject, description: string | undefined // Ticket description, status: string | undefined // Ticket status, priority: string | undefined | null // Ticket priority, type: string | undefined | null // Ticket type, requester_id: number | undefined // Requester user ID, assignee_id: number | undefined | null // Assignee user ID, organization_id: number | undefined | null // Organization ID, tags: string[] | undefined // Ticket tags, custom_fields: { id: number, value: unknown | null }[] | undefined // Custom field values on the ticket, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp }[] | undefined // List of tickets,\n//   count: number | undefined // Total ticket count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Ticket example\nconst zendesk_get_ticket = new ZendeskBubble({\n  operation: \"get_ticket\", // Retrieve a single ticket by ID with full details\n  ticket_id: \"example string\", // Zendesk ticket ID (numeric string)\n});\n\nconst result = await zendesk_get_ticket.action();\n// outputSchema for result.data when operation === 'get_ticket':\n// {\n//   operation: \"get_ticket\",\n//   success: boolean // Whether the operation was successful,\n//   ticket: { id: number // Ticket ID, subject: string | undefined // Ticket subject, description: string | undefined // Ticket description, status: string | undefined // Ticket status, priority: string | undefined | null // Ticket priority, type: string | undefined | null // Ticket type, requester_id: number | undefined // Requester user ID, assignee_id: number | undefined | null // Assignee user ID, organization_id: number | undefined | null // Organization ID, tags: string[] | undefined // Ticket tags, custom_fields: { id: number, value: unknown | null }[] | undefined // Custom field values on the ticket, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Retrieved ticket,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Ticket example\nconst zendesk_create_ticket = new ZendeskBubble({\n  operation: \"create_ticket\", // Create a new support ticket\n  subject: \"example string\", // Ticket subject line\n  body: \"example string\", // Ticket description / initial comment body\n  requester_email: \"example string\", // Email of the requester (creates user if not found)\n  requester_name: \"example string\", // Name of the requester (used when creating a new requester alongside email)\n  assignee_id: 42, // Agent ID to assign the ticket to\n  priority: \"urgent\" // options: \"urgent\", \"high\", \"normal\", \"low\", // Ticket priority\n  type: \"problem\" // options: \"problem\", \"incident\", \"question\", \"task\", // Ticket type\n  tags: [\"example string\"], // Tags to apply to the ticket\n  custom_fields: [{ id: 42 // Custom ticket field ID, value: [\"example string\"] // Field value. For dropdowns use the tag name, for multiselect use an array of tag names, for dates use \"YYYY-MM-DD\" }], // Custom field values. Use list_ticket_fields to discover available fields and their IDs.\n});\n\nconst result = await zendesk_create_ticket.action();\n// outputSchema for result.data when operation === 'create_ticket':\n// {\n//   operation: \"create_ticket\",\n//   success: boolean // Whether the operation was successful,\n//   ticket: { id: number // Ticket ID, subject: string | undefined // Ticket subject, description: string | undefined // Ticket description, status: string | undefined // Ticket status, priority: string | undefined | null // Ticket priority, type: string | undefined | null // Ticket type, requester_id: number | undefined // Requester user ID, assignee_id: number | undefined | null // Assignee user ID, organization_id: number | undefined | null // Organization ID, tags: string[] | undefined // Ticket tags, custom_fields: { id: number, value: unknown | null }[] | undefined // Custom field values on the ticket, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Created ticket,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update Ticket example\nconst zendesk_update_ticket = new ZendeskBubble({\n  operation: \"update_ticket\", // Update a ticket: add a reply/comment, change status, priority, or assignee\n  ticket_id: \"example string\", // Zendesk ticket ID (numeric string)\n  comment: \"example string\", // Comment body to add to the ticket (public reply or internal note)\n  public: true // default, // Whether the comment is public (visible to requester) or internal note (default: true)\n  status: \"new\" // options: \"new\", \"open\", \"pending\", \"hold\", \"solved\", \"closed\", // Set new ticket status\n  priority: \"urgent\" // options: \"urgent\", \"high\", \"normal\", \"low\", // Set new ticket priority\n  assignee_id: 42, // Reassign ticket to this agent ID\n  tags: [\"example string\"], // Replace ticket tags with this list\n  custom_fields: [{ id: 42 // Custom ticket field ID, value: [\"example string\"] // Field value. For dropdowns use the tag name, for multiselect use an array of tag names, for dates use \"YYYY-MM-DD\" }], // Custom field values to set. Use list_ticket_fields to discover available fields and their IDs.\n});\n\nconst result = await zendesk_update_ticket.action();\n// outputSchema for result.data when operation === 'update_ticket':\n// {\n//   operation: \"update_ticket\",\n//   success: boolean // Whether the operation was successful,\n//   ticket: { id: number // Ticket ID, subject: string | undefined // Ticket subject, description: string | undefined // Ticket description, status: string | undefined // Ticket status, priority: string | undefined | null // Ticket priority, type: string | undefined | null // Ticket type, requester_id: number | undefined // Requester user ID, assignee_id: number | undefined | null // Assignee user ID, organization_id: number | undefined | null // Organization ID, tags: string[] | undefined // Ticket tags, custom_fields: { id: number, value: unknown | null }[] | undefined // Custom field values on the ticket, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Updated ticket,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Ticket Comments example\nconst zendesk_list_ticket_comments = new ZendeskBubble({\n  operation: \"list_ticket_comments\", // List comments/replies on a ticket\n  ticket_id: \"example string\", // Zendesk ticket ID (numeric string)\n  sort_order: \"asc\" // options: \"asc\", \"desc\", // Sort order for comments (default: asc — oldest first)\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_ticket_comments.action();\n// outputSchema for result.data when operation === 'list_ticket_comments':\n// {\n//   operation: \"list_ticket_comments\",\n//   success: boolean // Whether the operation was successful,\n//   comments: { id: number // Comment ID, body: string | undefined // Comment body text, html_body: string | undefined // Comment body HTML, public: boolean | undefined // Whether comment is public, author_id: number | undefined // Author user ID, created_at: string | undefined // Created timestamp }[] | undefined // List of comments,\n//   count: number | undefined // Total comment count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Users example\nconst zendesk_list_users = new ZendeskBubble({\n  operation: \"list_users\", // List or search users\n  query: \"example string\", // Search query (name or email)\n  role: \"end-user\" // options: \"end-user\", \"agent\", \"admin\", // Filter by user role\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_users.action();\n// outputSchema for result.data when operation === 'list_users':\n// {\n//   operation: \"list_users\",\n//   success: boolean // Whether the operation was successful,\n//   users: { id: number // User ID, name: string | undefined // User name, email: string | undefined // User email, role: string | undefined // User role (end-user, agent, admin), organization_id: number | undefined | null // Organization ID, active: boolean | undefined // Whether user is active, created_at: string | undefined // Created timestamp }[] | undefined // List of users,\n//   count: number | undefined // Total user count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get User example\nconst zendesk_get_user = new ZendeskBubble({\n  operation: \"get_user\", // Retrieve a single user by ID\n  user_id: \"example string\", // Zendesk user ID (numeric string)\n});\n\nconst result = await zendesk_get_user.action();\n// outputSchema for result.data when operation === 'get_user':\n// {\n//   operation: \"get_user\",\n//   success: boolean // Whether the operation was successful,\n//   user: { id: number // User ID, name: string | undefined // User name, email: string | undefined // User email, role: string | undefined // User role (end-user, agent, admin), organization_id: number | undefined | null // Organization ID, active: boolean | undefined // Whether user is active, created_at: string | undefined // Created timestamp } | undefined // Retrieved user,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Organizations example\nconst zendesk_list_organizations = new ZendeskBubble({\n  operation: \"list_organizations\", // List or search organizations\n  query: \"example string\", // Search by organization name or external ID\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_organizations.action();\n// outputSchema for result.data when operation === 'list_organizations':\n// {\n//   operation: \"list_organizations\",\n//   success: boolean // Whether the operation was successful,\n//   organizations: { id: number // Organization ID, name: string | undefined // Organization name, domain_names: string[] | undefined // Associated domain names, external_id: string | undefined | null // External ID, created_at: string | undefined // Created timestamp }[] | undefined // List of organizations,\n//   count: number | undefined // Total organization count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Organization example\nconst zendesk_get_organization = new ZendeskBubble({\n  operation: \"get_organization\", // Retrieve a single organization by ID\n  organization_id: \"example string\", // Zendesk organization ID (numeric string)\n});\n\nconst result = await zendesk_get_organization.action();\n// outputSchema for result.data when operation === 'get_organization':\n// {\n//   operation: \"get_organization\",\n//   success: boolean // Whether the operation was successful,\n//   organization: { id: number // Organization ID, name: string | undefined // Organization name, domain_names: string[] | undefined // Associated domain names, external_id: string | undefined | null // External ID, created_at: string | undefined // Created timestamp } | undefined // Retrieved organization,\n//   error: string // Error message if operation failed\n// }\n\n\n// Search example\nconst zendesk_search = new ZendeskBubble({\n  operation: \"search\", // Unified search across tickets, users, and organizations using Zendesk query syntax\n  query: \"example string\", // Zendesk search query (e.g., \"type:ticket status:open\", \"type:user email:john@example.com\")\n  sort_by: \"updated_at\" // options: \"updated_at\", \"created_at\", \"priority\", \"status\", \"ticket_type\", // Sort field\n  sort_order: \"asc\" // options: \"asc\", \"desc\", // Sort order (default: desc)\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_search.action();\n// outputSchema for result.data when operation === 'search':\n// {\n//   operation: \"search\",\n//   success: boolean // Whether the operation was successful,\n//   results: Record<string, unknown>[] | undefined // Search results (mixed types),\n//   count: number | undefined // Total result count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Articles example\nconst zendesk_list_articles = new ZendeskBubble({\n  operation: \"list_articles\", // List or search Help Center articles\n  query: \"example string\", // Search query for articles\n  section_id: \"example string\", // Filter articles by section ID\n  category_id: \"example string\", // Filter articles by category ID\n  locale: \"example string\", // Filter by locale (e.g., \"en-us\")\n  page: 1 // default, // Page number for pagination (default 1)\n  per_page: 25 // default, // Results per page (1-100, default 25)\n});\n\nconst result = await zendesk_list_articles.action();\n// outputSchema for result.data when operation === 'list_articles':\n// {\n//   operation: \"list_articles\",\n//   success: boolean // Whether the operation was successful,\n//   articles: { id: number // Article ID, title: string | undefined // Article title, body: string | undefined // Article body HTML, locale: string | undefined // Article locale, section_id: number | undefined // Section ID, author_id: number | undefined // Author user ID, draft: boolean | undefined // Whether article is a draft, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp }[] | undefined // List of articles,\n//   count: number | undefined // Total article count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Article example\nconst zendesk_get_article = new ZendeskBubble({\n  operation: \"get_article\", // Retrieve a single Help Center article by ID with body content\n  article_id: \"example string\", // Zendesk Help Center article ID\n  locale: \"example string\", // Locale for the article (e.g., \"en-us\")\n});\n\nconst result = await zendesk_get_article.action();\n// outputSchema for result.data when operation === 'get_article':\n// {\n//   operation: \"get_article\",\n//   success: boolean // Whether the operation was successful,\n//   article: { id: number // Article ID, title: string | undefined // Article title, body: string | undefined // Article body HTML, locale: string | undefined // Article locale, section_id: number | undefined // Section ID, author_id: number | undefined // Author user ID, draft: boolean | undefined // Whether article is a draft, created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Retrieved article,\n//   error: string // Error message if operation failed\n// }\n\n\n// List Ticket Fields example\nconst zendesk_list_ticket_fields = new ZendeskBubble({\n  operation: \"list_ticket_fields\", // List all ticket fields (system and custom) to discover field IDs, types, and allowed values\n});\n\nconst result = await zendesk_list_ticket_fields.action();\n// outputSchema for result.data when operation === 'list_ticket_fields':\n// {\n//   operation: \"list_ticket_fields\",\n//   success: boolean // Whether the operation was successful,\n//   ticket_fields: { id: number // Field ID, type: string // Field type (text, textarea, checkbox, date, integer, decimal, tagger, multiselect, etc.), title: string // Field display title, description: string | undefined | null // Field description, active: boolean | undefined // Whether the field is active, required: boolean | undefined // Whether the field is required, custom_field_options: { name: string // Display name of the option, value: string // Tag value to use when setting this field }[] | undefined | null // Available options for dropdown/tagger/multiselect fields }[] | undefined // List of ticket fields,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Ticket Field example\nconst zendesk_create_ticket_field = new ZendeskBubble({\n  operation: \"create_ticket_field\", // Create a new custom ticket field (admin only)\n  type: \"text\" // options: \"text\", \"textarea\", \"checkbox\", \"date\", \"integer\", \"decimal\", \"regexp\", \"partialcreditcard\", \"multiselect\", \"tagger\", \"lookup\", // Field type\n  title: \"example string\", // Field display title\n  description: \"example string\", // Field description\n  required: true, // Whether agents must fill this field to mark a ticket as solved\n  active: true // default, // Whether field is active\n  custom_field_options: [{ name: \"example string\" // Display name of the option, value: \"example string\" // Tag value for this option }], // Options for tagger/multiselect fields. Each option needs a display name and a tag value.\n  tag: \"example string\", // Tag added when checkbox is selected (checkbox type only)\n  regexp_for_validation: \"example string\", // Validation regex (regexp type only)\n});\n\nconst result = await zendesk_create_ticket_field.action();\n// outputSchema for result.data when operation === 'create_ticket_field':\n// {\n//   operation: \"create_ticket_field\",\n//   success: boolean // Whether the operation was successful,\n//   ticket_field: { id: number // Created field ID, type: string // Field type, title: string // Field title, active: boolean | undefined // Whether field is active, required: boolean | undefined // Whether field is required, custom_field_options: { name: string, value: string }[] | undefined | null } | undefined // Created ticket field,\n//   error: string // Error message if operation failed\n// }\n\n\n// Delete Ticket Field example\nconst zendesk_delete_ticket_field = new ZendeskBubble({\n  operation: \"delete_ticket_field\", // Delete a custom ticket field (admin only). System fields cannot be deleted.\n  ticket_field_id: \"example string\", // ID of the ticket field to delete\n});\n\nconst result = await zendesk_delete_ticket_field.action();\n// outputSchema for result.data when operation === 'delete_ticket_field':\n// {\n//   operation: \"delete_ticket_field\",\n//   success: boolean // Whether the operation was successful,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`zendesk failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
       "requiredCredentials": [
         "ZENDESK_CRED"
       ]