@bubblelab/bubble-core 0.1.277 → 0.1.279

package/dist/bubbles.json

@@ -1,7 +1,7 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-04-07T00:39:42.904Z",
-  "totalCount": 82,
+  "generatedAt": "2026-04-09T08:53:33.188Z",
+  "totalCount": 83,
   "bubbles": [
     {
       "name": "hello-world",
@@ -77797,6 +77797,13 @@
                 },
                 "description": "Custom field values. Use list_ticket_fields to discover available fields and their IDs."
               },
+              "uploads": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Upload tokens from upload_attachment to attach files to the initial ticket comment"
+              },
               "credentials": {
                 "type": "object",
                 "additionalProperties": {
@@ -77913,6 +77920,13 @@
                 },
                 "description": "Custom field values to set. Use list_ticket_fields to discover available fields and their IDs."
               },
+              "uploads": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Upload tokens from upload_attachment to attach files to the comment"
+              },
               "credentials": {
                 "type": "object",
                 "additionalProperties": {
@@ -78835,6 +78849,45 @@
               "query"
             ],
             "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "upload_attachment"
+                ],
+                "description": "Upload a file to Zendesk and get an upload token for attaching to tickets"
+              },
+              "filename": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Filename with extension (e.g., \"report.pdf\", \"screenshot.png\")"
+              },
+              "content": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Base64-encoded file content"
+              },
+              "content_type": {
+                "type": "string",
+                "description": "MIME type of the file (e.g., \"application/pdf\"). Defaults to \"application/octet-stream\""
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Object mapping credential types to values (injected at runtime)"
+              }
+            },
+            "required": [
+              "operation",
+              "filename",
+              "content"
+            ],
+            "additionalProperties": false
           }
         ]
       },
@@ -79423,6 +79476,43 @@
                       "type": "number",
                       "description": "Author user ID"
                     },
+                    "attachments": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "number",
+                            "description": "Attachment ID"
+                          },
+                          "file_name": {
+                            "type": "string",
+                            "description": "Filename"
+                          },
+                          "content_url": {
+                            "type": "string",
+                            "description": "URL to download the attachment"
+                          },
+                          "content_type": {
+                            "type": "string",
+                            "description": "MIME type"
+                          },
+                          "size": {
+                            "type": "number",
+                            "description": "File size in bytes"
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "file_name",
+                          "content_url",
+                          "content_type",
+                          "size"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "File attachments on this comment"
+                    },
                     "created_at": {
                       "type": "string",
                       "description": "Created timestamp"
@@ -80862,10 +80952,84 @@
               "error"
             ],
             "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "upload_attachment"
+                ]
+              },
+              "success": {
+                "type": "boolean",
+                "description": "Whether the operation was successful"
+              },
+              "upload": {
+                "type": "object",
+                "properties": {
+                  "token": {
+                    "type": "string",
+                    "description": "Upload token to include in ticket comment uploads array"
+                  },
+                  "attachment": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "number",
+                        "description": "Attachment ID"
+                      },
+                      "file_name": {
+                        "type": "string",
+                        "description": "Uploaded filename"
+                      },
+                      "content_url": {
+                        "type": "string",
+                        "description": "URL to access the attachment"
+                      },
+                      "size": {
+                        "type": "number",
+                        "description": "File size in bytes"
+                      },
+                      "content_type": {
+                        "type": "string",
+                        "description": "MIME type of the file"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "file_name",
+                      "content_url",
+                      "size",
+                      "content_type"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Attachment metadata"
+                  }
+                },
+                "required": [
+                  "token",
+                  "attachment"
+                ],
+                "additionalProperties": false,
+                "description": "Upload result with token and attachment info"
+              },
+              "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// 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);",
+      "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  uploads: [\"example string\"], // Upload tokens from upload_attachment to attach files to the initial ticket comment\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  uploads: [\"example string\"], // Upload tokens from upload_attachment to attach files to the comment\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, attachments: { id: number // Attachment ID, file_name: string // Filename, content_url: string // URL to download the attachment, content_type: string // MIME type, size: number // File size in bytes }[] | undefined // File attachments on this comment, 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// Upload Attachment example\nconst zendesk_upload_attachment = new ZendeskBubble({\n  operation: \"upload_attachment\", // Upload a file to Zendesk and get an upload token for attaching to tickets\n  filename: \"example string\", // Filename with extension (e.g., \"report.pdf\", \"screenshot.png\")\n  content: \"example string\", // Base64-encoded file content\n  content_type: \"example string\", // MIME type of the file (e.g., \"application/pdf\"). Defaults to \"application/octet-stream\"\n});\n\nconst result = await zendesk_upload_attachment.action();\n// outputSchema for result.data when operation === 'upload_attachment':\n// {\n//   operation: \"upload_attachment\",\n//   success: boolean // Whether the operation was successful,\n//   upload: { token: string // Upload token to include in ticket comment uploads array, attachment: { id: number // Attachment ID, file_name: string // Uploaded filename, content_url: string // URL to access the attachment, size: number // File size in bytes, content_type: string // MIME type of the file } // Attachment metadata } | undefined // Upload result with token and attachment info,\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"
       ]
@@ -88929,6 +89093,514 @@
       "requiredCredentials": [
         "DOCUSIGN_CRED"
       ]
+    },
+    {
+      "name": "metabase",
+      "alias": "analytics",
+      "type": "service",
+      "shortDescription": "Metabase integration for dashboards, cards, and analytics queries",
+      "useCase": "General purpose bubble for various workflow needs",
+      "outputSchema": "Complex schema - see usage example for structure",
+      "inputJsonSchema": {
+        "anyOf": [
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "get_dashboard"
+                ],
+                "description": "Get dashboard by ID"
+              },
+              "dashboard_id": {
+                "type": "number",
+                "description": "The dashboard ID to retrieve"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Credential mapping for authentication"
+              }
+            },
+            "required": [
+              "operation",
+              "dashboard_id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "list_dashboards"
+                ],
+                "description": "List all available dashboards"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Credential mapping for authentication"
+              }
+            },
+            "required": [
+              "operation"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "get_card"
+                ],
+                "description": "Get card metadata by ID"
+              },
+              "card_id": {
+                "type": "number",
+                "description": "The card ID to retrieve"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Credential mapping for authentication"
+              }
+            },
+            "required": [
+              "operation",
+              "card_id"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "query_card"
+                ],
+                "description": "Execute a card's query and return results"
+              },
+              "card_id": {
+                "type": "number",
+                "description": "The card ID to query"
+              },
+              "pivot": {
+                "type": "boolean",
+                "description": "Use the pivot endpoint (/api/card/pivot/:id/query) for pivot-table results"
+              },
+              "parameters": {
+                "type": "object",
+                "additionalProperties": {},
+                "description": "Optional query parameters (filters)"
+              },
+              "credentials": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Credential mapping for authentication"
+              }
+            },
+            "required": [
+              "operation",
+              "card_id"
+            ],
+            "additionalProperties": false
+          }
+        ]
+      },
+      "outputJsonSchema": {
+        "anyOf": [
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "get_dashboard"
+                ]
+              },
+              "success": {
+                "type": "boolean"
+              },
+              "error": {
+                "type": "string",
+                "default": ""
+              },
+              "data": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "number",
+                    "description": "Unique dashboard identifier"
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "Dashboard name"
+                  },
+                  "description": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "Dashboard description"
+                  },
+                  "collection_id": {
+                    "type": "number",
+                    "nullable": true,
+                    "description": "Collection the dashboard belongs to"
+                  },
+                  "dashcards": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "number",
+                          "description": "Unique dashcard identifier"
+                        },
+                        "card_id": {
+                          "type": "number",
+                          "nullable": true,
+                          "description": "ID of the card in this dashcard"
+                        },
+                        "card": {
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "type": "number",
+                              "nullable": true,
+                              "description": "Card ID (null/absent for text/heading dashcards)"
+                            },
+                            "name": {
+                              "type": "string",
+                              "nullable": true,
+                              "description": "Card name (null/absent for text/heading dashcards)"
+                            },
+                            "display": {
+                              "type": "string",
+                              "description": "Card display type"
+                            },
+                            "description": {
+                              "type": "string",
+                              "nullable": true,
+                              "description": "Card description"
+                            }
+                          },
+                          "additionalProperties": true,
+                          "nullable": true,
+                          "description": "Embedded card metadata (null for virtual/text dashcards)"
+                        },
+                        "row": {
+                          "type": "number",
+                          "description": "Row position on dashboard grid"
+                        },
+                        "col": {
+                          "type": "number",
+                          "description": "Column position on dashboard grid"
+                        },
+                        "size_x": {
+                          "type": "number",
+                          "description": "Width in grid units"
+                        },
+                        "size_y": {
+                          "type": "number",
+                          "description": "Height in grid units"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "card_id",
+                        "row",
+                        "col",
+                        "size_x",
+                        "size_y"
+                      ],
+                      "additionalProperties": true,
+                      "description": "Dashboard card (dashcard) object"
+                    },
+                    "description": "List of dashcards on this dashboard"
+                  },
+                  "parameters": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    },
+                    "description": "Dashboard filter parameters"
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "description": "Creation timestamp"
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "description": "Last update timestamp"
+                  }
+                },
+                "required": [
+                  "id",
+                  "name"
+                ],
+                "additionalProperties": true,
+                "description": "Metabase dashboard object"
+              }
+            },
+            "required": [
+              "operation",
+              "success"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "list_dashboards"
+                ]
+              },
+              "success": {
+                "type": "boolean"
+              },
+              "error": {
+                "type": "string",
+                "default": ""
+              },
+              "data": {
+                "type": "object",
+                "properties": {
+                  "dashboards": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "number",
+                          "description": "Unique dashboard identifier"
+                        },
+                        "name": {
+                          "type": "string",
+                          "description": "Dashboard name"
+                        },
+                        "description": {
+                          "type": "string",
+                          "nullable": true,
+                          "description": "Dashboard description"
+                        },
+                        "collection_id": {
+                          "type": "number",
+                          "nullable": true,
+                          "description": "Collection the dashboard belongs to"
+                        },
+                        "model": {
+                          "type": "string",
+                          "description": "Entity model type"
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "description": "Creation timestamp"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "name"
+                      ],
+                      "additionalProperties": true,
+                      "description": "Dashboard list item"
+                    }
+                  },
+                  "total": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "dashboards",
+                  "total"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "operation",
+              "success"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "get_card"
+                ]
+              },
+              "success": {
+                "type": "boolean"
+              },
+              "error": {
+                "type": "string",
+                "default": ""
+              },
+              "data": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "number",
+                    "description": "Unique card identifier"
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "Card name"
+                  },
+                  "description": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "Card description"
+                  },
+                  "display": {
+                    "type": "string",
+                    "description": "Visualization type"
+                  },
+                  "collection_id": {
+                    "type": "number",
+                    "nullable": true,
+                    "description": "Collection the card belongs to"
+                  },
+                  "database_id": {
+                    "type": "number",
+                    "nullable": true,
+                    "description": "Database this card queries"
+                  },
+                  "dataset_query": {
+                    "type": "object",
+                    "additionalProperties": {},
+                    "description": "The query definition"
+                  },
+                  "result_metadata": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    },
+                    "description": "Column metadata from the result"
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "description": "Creation timestamp"
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "description": "Last update timestamp"
+                  }
+                },
+                "required": [
+                  "id",
+                  "name"
+                ],
+                "additionalProperties": true,
+                "description": "Metabase card (saved question) object"
+              }
+            },
+            "required": [
+              "operation",
+              "success"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": {
+                "type": "string",
+                "enum": [
+                  "query_card"
+                ]
+              },
+              "success": {
+                "type": "boolean"
+              },
+              "error": {
+                "type": "string",
+                "default": ""
+              },
+              "data": {
+                "type": "object",
+                "properties": {
+                  "rows": {
+                    "type": "array",
+                    "items": {
+                      "type": "array",
+                      "items": {}
+                    },
+                    "description": "Result data rows"
+                  },
+                  "cols": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string",
+                          "description": "Column name"
+                        },
+                        "display_name": {
+                          "type": "string",
+                          "description": "Display name for column"
+                        },
+                        "base_type": {
+                          "type": "string",
+                          "description": "Base data type of column"
+                        }
+                      },
+                      "required": [
+                        "name"
+                      ],
+                      "additionalProperties": true
+                    },
+                    "description": "Column metadata"
+                  },
+                  "row_count": {
+                    "type": "number",
+                    "description": "Total number of rows returned"
+                  },
+                  "status": {
+                    "type": "string",
+                    "description": "Query execution status"
+                  }
+                },
+                "required": [
+                  "rows",
+                  "cols"
+                ],
+                "additionalProperties": true,
+                "description": "Flattened Metabase query result — rows and cols at top level"
+              }
+            },
+            "required": [
+              "operation",
+              "success"
+            ],
+            "additionalProperties": false
+          }
+        ]
+      },
+      "usageExample": "// Get Dashboard example\nconst metabase_get_dashboard = new MetabaseBubble({\n  operation: \"get_dashboard\", // Get dashboard by ID\n  dashboard_id: 42, // The dashboard ID to retrieve\n});\n\nconst result = await metabase_get_dashboard.action();\n// outputSchema for result.data when operation === 'get_dashboard':\n// {\n//   operation: \"get_dashboard\",\n//   success: boolean,\n//   error: string,\n//   data: { id: number // Unique dashboard identifier, name: string // Dashboard name, description: string | null | undefined // Dashboard description, collection_id: number | null | undefined // Collection the dashboard belongs to, dashcards: { id: number // Unique dashcard identifier, card_id: number | null // ID of the card in this dashcard, card: { id: number | null | undefined // Card ID (null/absent for text/heading dashcards), name: string | null | undefined // Card name (null/absent for text/heading dashcards), display: string | undefined // Card display type, description: string | null | undefined // Card description } | null | undefined // Embedded card metadata (null for virtual/text dashcards), row: number // Row position on dashboard grid, col: number // Column position on dashboard grid, size_x: number // Width in grid units, size_y: number // Height in grid units }[] | undefined // List of dashcards on this dashboard, parameters: Record<string, unknown>[] | undefined // Dashboard filter parameters, created_at: string | undefined // Creation timestamp, updated_at: string | undefined // Last update timestamp } | undefined // Metabase dashboard object\n// }\n\n\n// List Dashboards example\nconst metabase_list_dashboards = new MetabaseBubble({\n  operation: \"list_dashboards\", // List all available dashboards\n});\n\nconst result = await metabase_list_dashboards.action();\n// outputSchema for result.data when operation === 'list_dashboards':\n// {\n//   operation: \"list_dashboards\",\n//   success: boolean,\n//   error: string,\n//   data: { dashboards: { id: number // Unique dashboard identifier, name: string // Dashboard name, description: string | null | undefined // Dashboard description, collection_id: number | null | undefined // Collection the dashboard belongs to, model: string | undefined // Entity model type, created_at: string | undefined // Creation timestamp }[], total: number } | undefined\n// }\n\n\n// Get Card example\nconst metabase_get_card = new MetabaseBubble({\n  operation: \"get_card\", // Get card metadata by ID\n  card_id: 42, // The card ID to retrieve\n});\n\nconst result = await metabase_get_card.action();\n// outputSchema for result.data when operation === 'get_card':\n// {\n//   operation: \"get_card\",\n//   success: boolean,\n//   error: string,\n//   data: { id: number // Unique card identifier, name: string // Card name, description: string | null | undefined // Card description, display: string | undefined // Visualization type, collection_id: number | null | undefined // Collection the card belongs to, database_id: number | null | undefined // Database this card queries, dataset_query: Record<string, unknown> | undefined // The query definition, result_metadata: Record<string, unknown>[] | undefined // Column metadata from the result, created_at: string | undefined // Creation timestamp, updated_at: string | undefined // Last update timestamp } | undefined // Metabase card (saved question) object\n// }\n\n\n// Query Card example\nconst metabase_query_card = new MetabaseBubble({\n  operation: \"query_card\", // Execute a card's query and return results\n  card_id: 42, // The card ID to query\n  pivot: true, // Use the pivot endpoint (/api/card/pivot/:id/query) for pivot-table results\n  parameters: {}, // Optional query parameters (filters)\n});\n\nconst result = await metabase_query_card.action();\n// outputSchema for result.data when operation === 'query_card':\n// {\n//   operation: \"query_card\",\n//   success: boolean,\n//   error: string,\n//   data: { rows: unknown[][] // Result data rows, cols: { name: string // Column name, display_name: string | undefined // Display name for column, base_type: string | undefined // Base data type of column }[] // Column metadata, row_count: number | undefined // Total number of rows returned, status: string | undefined // Query execution status } | undefined // Flattened Metabase query result — rows and cols at top level\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`metabase failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "requiredCredentials": [
+        "METABASE_CRED"
+      ]
     }
   ]
 }