@bubblelab/bubble-core 0.1.245 → 0.1.247

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-03-20T09:38:17.124Z",
+  "generatedAt": "2026-03-21T01:00:12.006Z",
   "totalCount": 76,
   "bubbles": [
     {
@@ -75532,6 +75532,428 @@
               "ticket_field_id"
             ],
             "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "list_macros"
+                ],
+                "description": "List available macros. Optionally filter by active status or category."
+              },
+              "active": {
+                "type": "boolean",
+                "description": "Filter by active status (true = active only, false = inactive only)"
+              },
+              "category": {
+                "type": "string",
+                "description": "Filter macros by category name"
+              },
+              "include": {
+                "type": "string",
+                "enum": [
+                  "usage_7d",
+                  "usage_24h",
+                  "usage_30d"
+                ],
+                "description": "Include usage statistics for the given period"
+              },
+              "page": {
+                "type": "number",
+                "minimum": 1,
+                "default": 1,
+                "description": "Page number for pagination (default 1)"
+              },
+              "per_page": {
+                "type": "number",
+                "minimum": 1,
+                "maximum": 100,
+                "default": 25,
+                "description": "Results per page (1-100, default 25)"
+              },
+              "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": [
+                  "get_macro"
+                ],
+                "description": "Retrieve a single macro by ID with its full action definitions"
+              },
+              "macro_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Zendesk macro ID (numeric string)"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "macro_id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "apply_macro"
+                ],
+                "description": "Apply a macro to a ticket. Returns the resulting ticket changes (comment text, field updates) without actually modifying the ticket. Use this to preview what a macro would do, then use update_ticket to apply the changes."
+              },
+              "ticket_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Zendesk ticket ID (numeric string)"
+              },
+              "macro_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Zendesk macro ID to apply"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "ticket_id",
+              "macro_id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "create_macro"
+                ],
+                "description": "Create a new macro with a title and a set of actions"
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Macro title"
+              },
+              "actions": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "field": {
+                      "type": "string",
+                      "description": "The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\", \"group_id\")"
+                    },
+                    "value": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        {
+                          "enum": [
+                            "null"
+                          ],
+                          "nullable": true
+                        }
+                      ],
+                      "description": "The value to set for this field"
+                    }
+                  },
+                  "required": [
+                    "field",
+                    "value"
+                  ],
+                  "additionalProperties": false
+                },
+                "minItems": 1,
+                "description": "Actions the macro performs. Each action has a field name and value (e.g., {field: \"comment_value\", value: \"Thanks for contacting us!\"})"
+              },
+              "active": {
+                "type": "boolean",
+                "default": true,
+                "description": "Whether the macro is active (default: true)"
+              },
+              "description": {
+                "type": "string",
+                "description": "Macro description"
+              },
+              "restriction": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "description": "Restriction type (e.g., \"Group\")"
+                  },
+                  "id": {
+                    "type": "number",
+                    "description": "Restriction target ID"
+                  },
+                  "ids": {
+                    "type": "array",
+                    "items": {
+                      "type": "number"
+                    },
+                    "description": "Restriction target IDs"
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": false,
+                "description": "Access restriction (e.g., limit to a specific group)"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "title",
+              "actions"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "update_macro"
+                ],
+                "description": "Update an existing macro"
+              },
+              "macro_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Zendesk macro ID to update (numeric string)"
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1,
+                "description": "New macro title"
+              },
+              "actions": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "field": {
+                      "type": "string",
+                      "description": "The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\", \"group_id\")"
+                    },
+                    "value": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        {
+                          "enum": [
+                            "null"
+                          ],
+                          "nullable": true
+                        }
+                      ],
+                      "description": "The value to set for this field"
+                    }
+                  },
+                  "required": [
+                    "field",
+                    "value"
+                  ],
+                  "additionalProperties": false
+                },
+                "minItems": 1,
+                "description": "New actions for the macro"
+              },
+              "active": {
+                "type": "boolean",
+                "description": "Set active status"
+              },
+              "description": {
+                "type": "string",
+                "description": "New macro description"
+              },
+              "restriction": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "description": "Restriction type (e.g., \"Group\")"
+                  },
+                  "id": {
+                    "type": "number",
+                    "description": "Restriction target ID"
+                  },
+                  "ids": {
+                    "type": "array",
+                    "items": {
+                      "type": "number"
+                    },
+                    "description": "Restriction target IDs"
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": false,
+                "description": "Access restriction"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "macro_id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "delete_macro"
+                ],
+                "description": "Delete a macro (admin only)"
+              },
+              "macro_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "ID of the macro to delete"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "macro_id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "search_macros"
+                ],
+                "description": "Search macros by title keyword"
+              },
+              "query": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Search query (matches macro title)"
+              },
+              "active": {
+                "type": "boolean",
+                "description": "Filter by active status"
+              },
+              "include": {
+                "type": "string",
+                "enum": [
+                  "usage_7d",
+                  "usage_24h",
+                  "usage_30d"
+                ],
+                "description": "Include usage statistics for the given period"
+              },
+              "page": {
+                "type": "number",
+                "minimum": 1,
+                "default": 1,
+                "description": "Page number for pagination (default 1)"
+              },
+              "per_page": {
+                "type": "number",
+                "minimum": 1,
+                "maximum": 100,
+                "default": 25,
+                "description": "Results per page (1-100, default 25)"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "query"
+            ],
+            "additionalProperties": false
           }
         ]
       },
@@ -76812,10 +77234,757 @@
               "error"
             ],
             "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "list_macros"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "macros": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "number",
+                      "description": "Macro ID"
+                    },
+                    "title": {
+                      "type": "string",
+                      "description": "Macro title/name"
+                    },
+                    "description": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "Macro description"
+                    },
+                    "active": {
+                      "type": "boolean",
+                      "description": "Whether the macro is active"
+                    },
+                    "actions": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "field": {
+                            "type": "string",
+                            "description": "The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\")"
+                          },
+                          "value": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "boolean"
+                              },
+                              {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                }
+                              },
+                              {
+                                "enum": [
+                                  "null"
+                                ],
+                                "nullable": true
+                              }
+                            ],
+                            "nullable": true,
+                            "description": "The value to set for this field"
+                          }
+                        },
+                        "required": [
+                          "field",
+                          "value"
+                        ],
+                        "additionalProperties": false,
+                        "description": "A single action within a Zendesk macro"
+                      },
+                      "description": "List of actions this macro performs"
+                    },
+                    "restriction": {
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string"
+                        },
+                        "id": {
+                          "type": "number"
+                        },
+                        "ids": {
+                          "type": "array",
+                          "items": {
+                            "type": "number"
+                          }
+                        }
+                      },
+                      "additionalProperties": false,
+                      "nullable": true,
+                      "description": "Access restriction (e.g., limited to a group)"
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "description": "Created timestamp"
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "description": "Updated timestamp"
+                    }
+                  },
+                  "required": [
+                    "id"
+                  ],
+                  "additionalProperties": false,
+                  "description": "A Zendesk macro"
+                },
+                "description": "List of macros"
+              },
+              "count": {
+                "type": "number",
+                "description": "Total macro count"
+              },
+              "next_page": {
+                "type": "string",
+                "nullable": true,
+                "description": "Next page URL"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "get_macro"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "macro": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "number",
+                    "description": "Macro ID"
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Macro title/name"
+                  },
+                  "description": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "Macro description"
+                  },
+                  "active": {
+                    "type": "boolean",
+                    "description": "Whether the macro is active"
+                  },
+                  "actions": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "field": {
+                          "type": "string",
+                          "description": "The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\")"
+                        },
+                        "value": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            {
+                              "enum": [
+                                "null"
+                              ],
+                              "nullable": true
+                            }
+                          ],
+                          "nullable": true,
+                          "description": "The value to set for this field"
+                        }
+                      },
+                      "required": [
+                        "field",
+                        "value"
+                      ],
+                      "additionalProperties": false,
+                      "description": "A single action within a Zendesk macro"
+                    },
+                    "description": "List of actions this macro performs"
+                  },
+                  "restriction": {
+                    "type": "object",
+                    "properties": {
+                      "type": {
+                        "type": "string"
+                      },
+                      "id": {
+                        "type": "number"
+                      },
+                      "ids": {
+                        "type": "array",
+                        "items": {
+                          "type": "number"
+                        }
+                      }
+                    },
+                    "additionalProperties": false,
+                    "nullable": true,
+                    "description": "Access restriction (e.g., limited to a group)"
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "description": "Created timestamp"
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "description": "Updated timestamp"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false,
+                "description": "Retrieved macro"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "apply_macro"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "result": {
+                "type": "object",
+                "properties": {
+                  "ticket": {
+                    "type": "object",
+                    "additionalProperties": {},
+                    "description": "Ticket fields that would be changed"
+                  },
+                  "comment": {
+                    "type": "object",
+                    "properties": {
+                      "body": {
+                        "type": "string",
+                        "description": "Comment body text the macro would add"
+                      },
+                      "html_body": {
+                        "type": "string",
+                        "description": "Comment body HTML the macro would add"
+                      },
+                      "public": {
+                        "type": "boolean",
+                        "description": "Whether the comment would be public"
+                      },
+                      "scoped_body": {
+                        "type": "array",
+                        "items": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "description": "Scoped comment bodies (locale-specific)"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "description": "Comment that the macro would add to the ticket"
+                  }
+                },
+                "additionalProperties": false,
+                "description": "The result of applying the macro — shows what would change"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "create_macro"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "macro": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "number",
+                    "description": "Macro ID"
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Macro title/name"
+                  },
+                  "description": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "Macro description"
+                  },
+                  "active": {
+                    "type": "boolean",
+                    "description": "Whether the macro is active"
+                  },
+                  "actions": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "field": {
+                          "type": "string",
+                          "description": "The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\")"
+                        },
+                        "value": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            {
+                              "enum": [
+                                "null"
+                              ],
+                              "nullable": true
+                            }
+                          ],
+                          "nullable": true,
+                          "description": "The value to set for this field"
+                        }
+                      },
+                      "required": [
+                        "field",
+                        "value"
+                      ],
+                      "additionalProperties": false,
+                      "description": "A single action within a Zendesk macro"
+                    },
+                    "description": "List of actions this macro performs"
+                  },
+                  "restriction": {
+                    "type": "object",
+                    "properties": {
+                      "type": {
+                        "type": "string"
+                      },
+                      "id": {
+                        "type": "number"
+                      },
+                      "ids": {
+                        "type": "array",
+                        "items": {
+                          "type": "number"
+                        }
+                      }
+                    },
+                    "additionalProperties": false,
+                    "nullable": true,
+                    "description": "Access restriction (e.g., limited to a group)"
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "description": "Created timestamp"
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "description": "Updated timestamp"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false,
+                "description": "Created macro"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "update_macro"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "macro": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "number",
+                    "description": "Macro ID"
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Macro title/name"
+                  },
+                  "description": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "Macro description"
+                  },
+                  "active": {
+                    "type": "boolean",
+                    "description": "Whether the macro is active"
+                  },
+                  "actions": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "field": {
+                          "type": "string",
+                          "description": "The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\")"
+                        },
+                        "value": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            {
+                              "enum": [
+                                "null"
+                              ],
+                              "nullable": true
+                            }
+                          ],
+                          "nullable": true,
+                          "description": "The value to set for this field"
+                        }
+                      },
+                      "required": [
+                        "field",
+                        "value"
+                      ],
+                      "additionalProperties": false,
+                      "description": "A single action within a Zendesk macro"
+                    },
+                    "description": "List of actions this macro performs"
+                  },
+                  "restriction": {
+                    "type": "object",
+                    "properties": {
+                      "type": {
+                        "type": "string"
+                      },
+                      "id": {
+                        "type": "number"
+                      },
+                      "ids": {
+                        "type": "array",
+                        "items": {
+                          "type": "number"
+                        }
+                      }
+                    },
+                    "additionalProperties": false,
+                    "nullable": true,
+                    "description": "Access restriction (e.g., limited to a group)"
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "description": "Created timestamp"
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "description": "Updated timestamp"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false,
+                "description": "Updated macro"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "delete_macro"
+                ]
+              },
+              "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": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "search_macros"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "macros": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "number",
+                      "description": "Macro ID"
+                    },
+                    "title": {
+                      "type": "string",
+                      "description": "Macro title/name"
+                    },
+                    "description": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "Macro description"
+                    },
+                    "active": {
+                      "type": "boolean",
+                      "description": "Whether the macro is active"
+                    },
+                    "actions": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "field": {
+                            "type": "string",
+                            "description": "The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\")"
+                          },
+                          "value": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "boolean"
+                              },
+                              {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                }
+                              },
+                              {
+                                "enum": [
+                                  "null"
+                                ],
+                                "nullable": true
+                              }
+                            ],
+                            "nullable": true,
+                            "description": "The value to set for this field"
+                          }
+                        },
+                        "required": [
+                          "field",
+                          "value"
+                        ],
+                        "additionalProperties": false,
+                        "description": "A single action within a Zendesk macro"
+                      },
+                      "description": "List of actions this macro performs"
+                    },
+                    "restriction": {
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string"
+                        },
+                        "id": {
+                          "type": "number"
+                        },
+                        "ids": {
+                          "type": "array",
+                          "items": {
+                            "type": "number"
+                          }
+                        }
+                      },
+                      "additionalProperties": false,
+                      "nullable": true,
+                      "description": "Access restriction (e.g., limited to a group)"
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "description": "Created timestamp"
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "description": "Updated timestamp"
+                    }
+                  },
+                  "required": [
+                    "id"
+                  ],
+                  "additionalProperties": false,
+                  "description": "A Zendesk macro"
+                },
+                "description": "Matching macros"
+              },
+              "count": {
+                "type": "number",
+                "description": "Total result count"
+              },
+              "next_page": {
+                "type": "string",
+                "nullable": true,
+                "description": "Next page URL"
+              },
+              "error": {
+                "type": "string",
+                "description": "Error message if operation failed"
+              }
+            },
+            "required": [
+              "operation",
+              "success",
+              "error"
+            ],
+            "additionalProperties": false
           }
         ]
       },
-      "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);",
+      "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// List Macros example\nconst zendesk_list_macros = new ZendeskBubble({\n  operation: \"list_macros\", // List available macros. Optionally filter by active status or category.\n  active: true, // Filter by active status (true = active only, false = inactive only)\n  category: \"example string\", // Filter macros by category name\n  include: \"usage_7d\" // options: \"usage_7d\", \"usage_24h\", \"usage_30d\", // Include usage statistics for the given period\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_macros.action();\n// outputSchema for result.data when operation === 'list_macros':\n// {\n//   operation: \"list_macros\",\n//   success: boolean // Whether the operation was successful,\n//   macros: { id: number // Macro ID, title: string | undefined // Macro title/name, description: string | undefined | null // Macro description, active: boolean | undefined // Whether the macro is active, actions: { field: string // The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\"), value: unknown | null // The value to set for this field }[] | undefined // List of actions this macro performs, restriction: { type: string | undefined, id: number | undefined, ids: number[] | undefined } | undefined | null // Access restriction (e.g., limited to a group), created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp }[] | undefined // List of macros,\n//   count: number | undefined // Total macro count,\n//   next_page: string | undefined | null // Next page URL,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Macro example\nconst zendesk_get_macro = new ZendeskBubble({\n  operation: \"get_macro\", // Retrieve a single macro by ID with its full action definitions\n  macro_id: \"example string\", // Zendesk macro ID (numeric string)\n});\n\nconst result = await zendesk_get_macro.action();\n// outputSchema for result.data when operation === 'get_macro':\n// {\n//   operation: \"get_macro\",\n//   success: boolean // Whether the operation was successful,\n//   macro: { id: number // Macro ID, title: string | undefined // Macro title/name, description: string | undefined | null // Macro description, active: boolean | undefined // Whether the macro is active, actions: { field: string // The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\"), value: unknown | null // The value to set for this field }[] | undefined // List of actions this macro performs, restriction: { type: string | undefined, id: number | undefined, ids: number[] | undefined } | undefined | null // Access restriction (e.g., limited to a group), created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Retrieved macro,\n//   error: string // Error message if operation failed\n// }\n\n\n// Apply Macro example\nconst zendesk_apply_macro = new ZendeskBubble({\n  operation: \"apply_macro\", // Apply a macro to a ticket. Returns the resulting ticket changes (comment text, field updates) without actually modifying the ticket. Use this to preview what a macro would do, then use update_ticket to apply the changes.\n  ticket_id: \"example string\", // Zendesk ticket ID (numeric string)\n  macro_id: \"example string\", // Zendesk macro ID to apply\n});\n\nconst result = await zendesk_apply_macro.action();\n// outputSchema for result.data when operation === 'apply_macro':\n// {\n//   operation: \"apply_macro\",\n//   success: boolean // Whether the operation was successful,\n//   result: { ticket: Record<string, unknown> | undefined // Ticket fields that would be changed, comment: { body: string | undefined // Comment body text the macro would add, html_body: string | undefined // Comment body HTML the macro would add, public: boolean | undefined // Whether the comment would be public, scoped_body: string[][] | undefined // Scoped comment bodies (locale-specific) } | undefined // Comment that the macro would add to the ticket } | undefined // The result of applying the macro — shows what would change,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Macro example\nconst zendesk_create_macro = new ZendeskBubble({\n  operation: \"create_macro\", // Create a new macro with a title and a set of actions\n  title: \"example string\", // Macro title\n  actions: [{ field: \"example string\" // The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\", \"group_id\"), value: [\"example string\"] // The value to set for this field }], // Actions the macro performs. Each action has a field name and value (e.g., {field: \"comment_value\", value: \"Thanks for contacting us!\"})\n  active: true // default, // Whether the macro is active (default: true)\n  description: \"example string\", // Macro description\n  restriction: { type: \"example string\" // Restriction type (e.g., \"Group\"), id: 42 // Restriction target ID, ids: [42] // Restriction target IDs }, // Access restriction (e.g., limit to a specific group)\n});\n\nconst result = await zendesk_create_macro.action();\n// outputSchema for result.data when operation === 'create_macro':\n// {\n//   operation: \"create_macro\",\n//   success: boolean // Whether the operation was successful,\n//   macro: { id: number // Macro ID, title: string | undefined // Macro title/name, description: string | undefined | null // Macro description, active: boolean | undefined // Whether the macro is active, actions: { field: string // The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\"), value: unknown | null // The value to set for this field }[] | undefined // List of actions this macro performs, restriction: { type: string | undefined, id: number | undefined, ids: number[] | undefined } | undefined | null // Access restriction (e.g., limited to a group), created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Created macro,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update Macro example\nconst zendesk_update_macro = new ZendeskBubble({\n  operation: \"update_macro\", // Update an existing macro\n  macro_id: \"example string\", // Zendesk macro ID to update (numeric string)\n  title: \"example string\", // New macro title\n  actions: [{ field: \"example string\" // The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\", \"group_id\"), value: [\"example string\"] // The value to set for this field }], // New actions for the macro\n  active: true, // Set active status\n  description: \"example string\", // New macro description\n  restriction: { type: \"example string\" // Restriction type (e.g., \"Group\"), id: 42 // Restriction target ID, ids: [42] // Restriction target IDs }, // Access restriction\n});\n\nconst result = await zendesk_update_macro.action();\n// outputSchema for result.data when operation === 'update_macro':\n// {\n//   operation: \"update_macro\",\n//   success: boolean // Whether the operation was successful,\n//   macro: { id: number // Macro ID, title: string | undefined // Macro title/name, description: string | undefined | null // Macro description, active: boolean | undefined // Whether the macro is active, actions: { field: string // The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\"), value: unknown | null // The value to set for this field }[] | undefined // List of actions this macro performs, restriction: { type: string | undefined, id: number | undefined, ids: number[] | undefined } | undefined | null // Access restriction (e.g., limited to a group), created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp } | undefined // Updated macro,\n//   error: string // Error message if operation failed\n// }\n\n\n// Delete Macro example\nconst zendesk_delete_macro = new ZendeskBubble({\n  operation: \"delete_macro\", // Delete a macro (admin only)\n  macro_id: \"example string\", // ID of the macro to delete\n});\n\nconst result = await zendesk_delete_macro.action();\n// outputSchema for result.data when operation === 'delete_macro':\n// {\n//   operation: \"delete_macro\",\n//   success: boolean // Whether the operation was successful,\n//   error: string // Error message if operation failed\n// }\n\n\n// Search Macros example\nconst zendesk_search_macros = new ZendeskBubble({\n  operation: \"search_macros\", // Search macros by title keyword\n  query: \"example string\", // Search query (matches macro title)\n  active: true, // Filter by active status\n  include: \"usage_7d\" // options: \"usage_7d\", \"usage_24h\", \"usage_30d\", // Include usage statistics for the given period\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_macros.action();\n// outputSchema for result.data when operation === 'search_macros':\n// {\n//   operation: \"search_macros\",\n//   success: boolean // Whether the operation was successful,\n//   macros: { id: number // Macro ID, title: string | undefined // Macro title/name, description: string | undefined | null // Macro description, active: boolean | undefined // Whether the macro is active, actions: { field: string // The ticket field this action targets (e.g., \"comment_value\", \"status\", \"priority\", \"assignee_id\"), value: unknown | null // The value to set for this field }[] | undefined // List of actions this macro performs, restriction: { type: string | undefined, id: number | undefined, ids: number[] | undefined } | undefined | null // Access restriction (e.g., limited to a group), created_at: string | undefined // Created timestamp, updated_at: string | undefined // Updated timestamp }[] | undefined // Matching macros,\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// 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"
       ]