# Kadoa Kadoa is an API-first platform that enables users to create, manage, and monitor data extraction workflows from unstructured data sources. - **Category:** ai web scraping - **Auth:** API_KEY - **Composio Managed App Available?** N/A - **Tools:** 77 - **Triggers:** 0 - **Slug:** `KADOA` - **Version:** 20260227_00 ## Tools ### Bulk Approve Validation Rules **Slug:** `KADOA_APPROVE_BULK_VALIDATION_RULES` Tool to bulk approve preview validation rules for a workflow. Use after generating validation rules to activate multiple rules at once. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `ruleIds` | array | Yes | Array of rule IDs to approve. Must contain at least one rule ID. | | `workflowId` | string | Yes | The unique identifier of the workflow containing the rules to approve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Crawl Config **Slug:** `KADOA_CREATE_CRAWL_CONFIG` Tool to create a new crawling configuration in Kadoa. Use when you need to configure a custom crawl with specific options like navigation settings, extraction rules, or artifact capture preferences. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | Single URL to start crawling (for backward compatibility) | | `jobId` | string | No | Internal: Job ID for workflow tracking | | `dataKey` | string | No | Internal: Data key for Parquet storage path | | `rawMode` | boolean | No | Whether this is a raw data mode crawl | | `timeout` | integer | No | Timeout in milliseconds | | `maxDepth` | integer | No | Maximum crawling depth | | `maxPages` | integer | No | Maximum number of pages to crawl | | `safeMode` | boolean | No | Enable safe mode for crawling | | `blueprint` | array | No | Blueprint fields applied during crawling | | `proxyType` | string | No | Type of proxy to use | | `startUrls` | array | No | List of URLs for crawling | | `loadImages` | boolean | No | Whether to load images during crawling | | `maxMatches` | integer | No | Maximum number of matched pages to crawl before stopping | | `callbackUrl` | string | No | Webhook URL for completion notifications | | `concurrency` | integer | No | Number of concurrent crawlers | | `crawlMethod` | object | No | Crawl method configuration. | | `proxyCountry` | string | No | Country for proxy selection | | `strictDomain` | boolean | No | Whether to stay within the same domain | | `billingSource` | string | No | Internal: Billing source identifier | | `outputOptions` | object | No | Output options for raw mode. | | `pathsFilterIn` | array | No | Regex patterns to include specific full URLs. Accepts array or JSON-stringified array of regex source strings. | | `matchThreshold` | number | No | Match threshold override for blueprint filtering | | `pathsFilterOut` | array | No | Regex patterns to exclude specific full URLs. Accepts array or JSON-stringified array of regex source strings. | | `artifactOptions` | object | No | Artifact capture options for crawled pages. | | `extractionOptions` | object | No | Extraction-related options derived from legacy launch summary. | | `navigationOptions` | object | No | Navigation-related options derived from legacy launch summary. | | `processDuringCrawl` | boolean | No | Whether to run preprocessing and extraction during the crawl phase | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Notification Channel **Slug:** `KADOA_CREATE_NOTIFICATION_CHANNEL` Tool to create a notification channel for alerts delivery. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Human-readable name for the notification channel | | `config` | object | Yes | Channel-specific configuration object. Required fields vary by channelType: EMAIL requires {'recipients': ['email@example.com']}; SLACK requires {'webhookUrl': 'https://hooks.slack.com/...'}; WEBHOOK requires {'webhookUrl': 'https://...', 'httpMethod': 'POST' or 'GET'}; WEBSOCKET requires {'endpoint': 'wss://...'} | | `channelType` | string ("EMAIL" | "SLACK" | "WEBHOOK" | "WEBSOCKET") | Yes | Type of the notification channel | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Schema **Slug:** `KADOA_CREATE_SCHEMA` Create a new data schema with specified fields and entity type. Use this tool to define a reusable schema for data extraction workflows. Schemas can have Data Fields (typed data like STRING, NUMBER), Raw Content Fields (HTML/Markdown), or Classification Fields (predefined categories). Note: Field names must be camelCase (start lowercase, letters/numbers only). STRING dataType fields require an example value. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Name of the schema (1-255 characters) | | `entity` | string | Yes | Entity type for the schema (e.g., 'product', 'article'). Required for schemas with structured data fields. | | `fields` | array | Yes | Schema fields for extraction - choose from Data Field (typed data), Raw Content Field (HTML/Markdown), or Classification Field (predefined categories). At least one field is required. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Support Issue **Slug:** `KADOA_CREATE_SUPPORT_ISSUE` Tool to create a support ticket in Kadoa. Use when you need to report bugs, request features, or get help with workflows or integrations. User information is automatically inferred from the authentication context. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `files` | array | No | Optional array of files to attach to the issue | | `title` | string | Yes | Title of the support issue | | `category` | string ("bug" | "feature" | "workflow_issue" | "integration") | Yes | Category of the issue: 'bug' for bugs, 'feature' for feature requests, 'workflow_issue' for data extraction problems, 'integration' for integration issues | | `priority` | integer | No | Priority level from 0 (lowest) to 4 (highest) | | `workflowId` | string | No | Optional workflow ID to link the issue to a specific workflow | | `description` | string | Yes | Detailed description of the issue | | `subcategory` | string ("wrong_data" | "missing_fields" | "wrong_website" | "scraper_broken" | "other" | "integration_slack" | "integration_snowflake" | "integration_cloud_storage" | "integration_sdk" | "integration_other") | No | Subcategory for workflow or integration issues. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Workflow Trigger **Slug:** `KADOA_CREATE_WORKFLOW_TRIGGER` Tool to create a trigger that fires when a source workflow emits an event. Use when you need to chain workflows together, triggering one workflow based on events from another. Common use case: trigger data processing workflow when scraping workflow finishes. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `enabled` | boolean | No | Whether the trigger is enabled. Set to false to temporarily disable without deleting. | | `eventType` | string ("workflow_started" | "workflow_finished" | "workflow_failed" | "workflow_data_change" | "workflow_sample_finished" | "workflow_export_completed" | "workflow_validation_anomaly_change") | Yes | Event type that triggers the target workflow. Most common: 'workflow_finished' to trigger when source completes successfully. | | `workflowId` | string | Yes | ID of the source workflow that will emit events to trigger the target workflow | | `targetWorkflowId` | string | Yes | ID of the workflow to trigger when the source workflow emits an event | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete All Validation Rules **Slug:** `KADOA_DELETE_ALL_VALIDATION_RULES` Tool to soft-delete all validation rules for a specific workflow with optional audit trail. This is a bulk operation that marks rules as deleted without permanently removing them. Use when reconfiguring workflows or cleaning up validation rules. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `reason` | string | No | Optional reason for deletion to maintain audit trail. Must be between 1 and 500 characters if provided. | | `workflowId` | string | Yes | The unique identifier of the workflow whose validation rules should be deleted | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Crawl Configuration **Slug:** `KADOA_DELETE_CRAWL_CONFIG` Tool to delete a crawling configuration by its config ID. Use when you need to remove an existing crawl configuration. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `configId` | string | Yes | Unique identifier of the crawl configuration to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Notification Channel **Slug:** `KADOA_DELETE_NOTIFICATION_CHANNEL` Tool to delete a notification channel by its ID. Use when you need to remove a channel that is no longer needed. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `channel_id` | string | Yes | Unique identifier (UUID) of the notification channel to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Schema **Slug:** `KADOA_DELETE_SCHEMA` Tool to delete a schema and all its revisions. Use when you need to permanently remove a schema from your Kadoa account. This operation cannot be undone. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `schemaId` | string | Yes | Unique identifier (UUID) of the schema to delete. This will delete the schema and all its revisions permanently. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Validation Rule **Slug:** `KADOA_DELETE_VALIDATION_RULE` Tool to delete a validation rule from a Kadoa workflow. Performs a soft delete with optional audit reason. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `reason` | string | No | Optional reason for deleting the rule, used for audit trail. Maximum 500 characters. | | `ruleId` | string | Yes | The unique identifier (UUID) of the validation rule to delete. | | `workflowId` | string | Yes | The workflow ID associated with the validation rule. Required for authorization and validation. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Validation Rules (Bulk) **Slug:** `KADOA_DELETE_VALIDATION_RULES_BULK` Tool to bulk delete multiple validation rules for a workflow. Use when you need to remove multiple rules at once instead of deleting them individually. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `reason` | string | No | Optional reason for deleting these rules. Maximum length is 500 characters. | | `ruleIds` | array | Yes | Array of rule IDs (UUIDs) to delete. Must contain at least one rule ID. | | `workflowId` | string | Yes | The unique identifier (UUID) of the workflow containing the rules to delete. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Workflow **Slug:** `KADOA_DELETE_WORKFLOW` Delete a workflow permanently from your Kadoa account. Use this tool when you need to permanently remove a workflow. This action cannot be undone. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflow_id` | string | Yes | Unique identifier of the workflow to delete (UUID format) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Workflow Trigger **Slug:** `KADOA_DELETE_WORKFLOW_TRIGGER` Tool to delete a trigger from a Kadoa workflow. Use when you need to remove a specific trigger configuration. This action cannot be undone. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `trigger_id` | string | Yes | Unique identifier of the trigger to delete (UUID format) | | `workflow_id` | string | Yes | Unique identifier of the workflow (UUID format) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Disable Validation Rule **Slug:** `KADOA_DISABLE_VALIDATION_RULE` Tool to disable a validation rule with a mandatory reason. Use when you need to temporarily or permanently deactivate a data validation rule. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `reason` | string | Yes | The reason for disabling the validation rule. Must be between 1 and 500 characters. | | `ruleId` | string | Yes | The unique identifier (UUID) of the validation rule to disable. Obtain this from the List Validation Rules action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Enable Data Validation **Slug:** `KADOA_ENABLE_DATA_VALIDATION` Tool to enable data validation on a specified workflow. Use after creating or updating a workflow to enforce its validation rules. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | Yes | The unique identifier (UUID) of the workflow to enable data validation for. Obtain this from the GET /workflows endpoint. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Execute Bulk Workflow Operations **Slug:** `KADOA_EXECUTE_BULK_WORKFLOW_OPERATIONS` Execute actions on multiple workflows at once. Use when you need to perform the same operation on many workflows efficiently. Best-effort processing: each workflow is processed independently, so some may succeed while others fail. Check the response to see individual results and summary statistics. Supported actions: run, pause, resume, delete, approve, assignTags. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `action` | string ("run" | "pause" | "resume" | "delete" | "approve" | "assignTags") | Yes | The action to perform on all workflows: run (start workflow), pause (stop workflow), resume (restart paused workflow), delete (remove workflow), approve (approve pending workflow), assignTags (assign tags) | | `params` | object | No | Action-specific parameters for bulk operations. | | `workflowIds` | array | Yes | Array of workflow IDs to operate on (max 50) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Export Activity Events **Slug:** `KADOA_EXPORT_ACTIVITY` Tool to export activity events from audit logs to CSV format for compliance and audit purposes. Use when you need to retrieve historical activity data, generate audit reports, or track user actions across workflows. Supports filtering by time range, user, workflow, event types, and other criteria. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of activity records to export. If not specified, all matching records are returned. | | `offset` | integer | No | Number of records to skip before starting export (for pagination) | | `userId` | string | No | Filter activity events by specific user ID who triggered the action | | `endDate` | string | No | Filter events up to this date (ISO 8601 format, e.g., 2024-12-31T23:59:59Z) | | `startDate` | string | No | Filter events from this date onwards (ISO 8601 format, e.g., 2024-01-01T00:00:00Z) | | `eventTypes` | string | No | Comma-separated list of event types to include (e.g., 'workflow_started,workflow_finished') | | `interfaces` | string | No | Comma-separated list of interfaces to filter by (e.g., 'api,ui,webhook') | | `workflowId` | string | No | Filter activity events by specific workflow ID (UUID format) | | `relativeTime` | string | No | Relative time window counted backwards from now (e.g., '6h' for 6 hours, '1d' for 1 day, '2w' for 2 weeks). Mutually exclusive with startDate/endDate. | | `resourceTypes` | string | No | Comma-separated list of resource types to filter by (e.g., 'workflow,user,account') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Export Activity Workflows **Slug:** `KADOA_EXPORT_ACTIVITY_WORKFLOWS` Tool to export workflow configurations and metadata as CSV for portfolio reviews and compliance reporting. Use when you need to generate compliance reports or review workflow activity across a specific time period. Returns CSV data containing workflow details, states, and activity metadata. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `timeFilter` | string ("last-week" | "last-month" | "last-6-months" | "all-time") | No | Time range filter for workflow export. Filters workflows by their creation or activity date within the specified timeframe. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Workflow by ID **Slug:** `KADOA_FETCH_WORKFLOW_CONFIGURATION` Retrieve detailed configuration of a workflow by its ID. Returns workflow metadata, extraction schema, scheduling settings, data validation config, and run status. Use this to inspect a workflow's setup or check its current state. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflow_id` | string | Yes | Unique identifier of the workflow to retrieve (UUID format) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get all locations **Slug:** `KADOA_GET_ALL_LOCATIONS` Retrieves all available scraping proxy locations (countries) supported by Kadoa. Returns ISO country codes (e.g., US, GB, DE) that can be used when configuring workflows to scrape from specific geographic regions. Use this to see which locations are available before creating location-specific scraping workflows. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Crawl Bucket Data **Slug:** `KADOA_GET_CRAWL_BUCKET_DATA` Tool to retrieve file content from the Kadoa crawling bucket (HTML or screenshot). Use when you need to access raw files stored during a crawl session. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `filenameb64` | string | Yes | Base64-encoded filename of the file to retrieve from the crawling bucket. Obtain this from crawl session pages (e.g., from GET /v4/crawl/{sessionId}/pages). The filename typically includes the session ID and file type (html/screenshot). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Crawl Configuration **Slug:** `KADOA_GET_CRAWL_CONFIG` Tool to retrieve a crawling configuration by its ID. Use when you need to view the detailed settings of an existing crawl configuration. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `configId` | string | Yes | Unique identifier of the crawling configuration to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Crawled Page Content **Slug:** `KADOA_GET_CRAWLED_PAGE_CONTENT` Tool to retrieve content of a crawled page. Use when you need the HTML or Markdown of a page from a specific crawling session. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `format` | string ("html" | "md") | No | Desired output format: 'html' for HTML content or 'md' for Markdown content. Defaults to 'html' | | `pageId` | string | Yes | Unique ID of the crawled page. Obtain this from the GET /crawl/{sessionId}/pages endpoint | | `sessionId` | string | Yes | Unique ID of the crawling session. Obtain this from the POST /crawl endpoint or GET /crawl/{sessionId}/status | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Crawled Pages **Slug:** `KADOA_GET_CRAWLED_PAGES` Tool to list pages crawled during a session. Use when you need to paginate through results after starting a crawl session. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pageSize` | integer | No | Number of items per page for pagination | | `sessionId` | string | Yes | Unique identifier of the crawling session returned from POST /v4/crawl | | `currentPage` | integer | No | Current page number for pagination, starts at 1 | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Crawl Status **Slug:** `KADOA_GET_CRAWL_STATUS` Tool to fetch current status of a crawling session. Use when you need to check progress of a crawl by its session ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `session_id` | string | Yes | UUID of the crawling session returned from POST /v4/crawl (start crawl session) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Event Type Details **Slug:** `KADOA_GET_EVENT_TYPE` Tool to retrieve details for a specific notification event type. Use when you need to understand the schema, description, or configuration of a particular event type for setting up notifications. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `eventType` | string | Yes | Event type identifier to retrieve details for. Common examples: workflow_started, workflow_finished, workflow_failed, workflow_sample_finished, workflow_data_change, system_maintenance, service_degradation, credits_low, free_trial_ending. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Notification Event Types **Slug:** `KADOA_GET_EVENT_TYPES` Tool to retrieve supported notification event types. Use when you need to enumerate available notification triggers. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Latest Workflow Data **Slug:** `KADOA_GET_LATEST_WORKFLOW_DATA` Retrieves the extracted data from a Kadoa workflow's most recent run (or a specific run if runId is provided). Returns paginated records in JSON or CSV format. Use Get Workflows action first to obtain a valid workflowId. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `gzip` | boolean | No | Enable gzip compression for the response | | `page` | integer | No | Page number for pagination (starts at 1) | | `limit` | integer | No | Number of items per page. Use 0 to retrieve all items (streaming mode). | | `order` | string ("asc" | "desc") | No | Sort direction: 'asc' for ascending, 'desc' for descending | | `runId` | string | No | Optional UUID of a specific workflow run. If omitted, returns data from the most recent run. | | `format` | string ("json" | "csv") | No | Response format: 'json' returns structured data, 'csv' returns raw CSV text | | `sortBy` | string | No | Field name to sort results by (e.g., a schema field from the workflow) | | `filters` | array | No | Optional list of filter objects to narrow down results by field values | | `workflowId` | string | Yes | The unique identifier (UUID) of the workflow. Obtain this from the Get Workflows action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Latest Workflow Validation **Slug:** `KADOA_GET_LATEST_WORKFLOW_VALIDATION` Retrieves the latest validation results for the most recent job of a workflow. Returns comprehensive validation data including anomaly counts, detailed anomaly lists by rule, schema issues, and change detection summaries. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | Yes | Identifier of the workflow to fetch the latest validation for | | `includeDryRun` | boolean | No | Whether to include dry-run validation results | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Notification Channel **Slug:** `KADOA_GET_NOTIFICATION_CHANNEL` Tool to retrieve details of a specific notification channel. Use when you have a channel's ID and need its configuration. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `channel_id` | string | Yes | Unique identifier (UUID) of the notification channel to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Notification Logs **Slug:** `KADOA_GET_NOTIFICATION_LOGS` Tool to retrieve notification event logs with optional filtering by workflow, event type, and date range. Use when you need to audit notification delivery, troubleshoot missing notifications, or review event history. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Number of events to return per page (1-100, default 50) | | `offset` | integer | No | Number of events to skip for pagination (default 0) | | `endDate` | string | No | Filter events until this date (optional). ISO 8601 format recommended. | | `eventType` | string | No | Filter by event type (optional). Common types include: workflow_started, workflow_finished, workflow_failed, workflow_sample_finished, workflow_data_change, system_maintenance, service_degradation, credits_low, free_trial_ending. | | `startDate` | string | No | Filter events from this date (optional). ISO 8601 format recommended. | | `workflowId` | string | No | Filter by workflow ID (optional). Obtain this from the KADOA_GET_WORKFLOWS action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Notification Setting **Slug:** `KADOA_GET_NOTIFICATION_SETTING` Retrieves a specific notification setting by its unique identifier. Use this tool to fetch details about how notifications are configured for specific events and which channels are linked. Returns the event type, enabled status, linked channels, and timestamps. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `settingsId` | string | Yes | Unique identifier (UUID) of the notification setting to retrieve. Obtain this from creating a notification setting or listing existing settings. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Schema by ID **Slug:** `KADOA_GET_SCHEMA` Retrieve a specific schema by its unique identifier. Returns schema metadata, field definitions, and configuration. Use this to inspect available data structures or validate schema configurations for workflows. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `schemaId` | string | Yes | Unique identifier (UUID) of the schema to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Validation Anomalies **Slug:** `KADOA_GET_VALIDATION_ANOMALIES` Tool to retrieve all anomalies for a specific validation. Use this when you need to fetch detailed anomaly data detected during a data validation run, grouped by validation rules with pagination support. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | integer | No | Page number for pagination, must be >= 1 | | `pageSize` | integer | No | Number of items per page, between 1 and 100 | | `validationId` | string | Yes | Unique identifier of the validation to fetch anomalies for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Validation Anomalies By Rule **Slug:** `KADOA_GET_VALIDATION_ANOMALIES_BY_RULE` Tool to retrieve anomalies for a specific validation rule. Use this to investigate specific rule violations and understand what data failed validation checks. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | integer | No | Page number for pagination, must be ≥ 1 | | `pageSize` | integer | No | Number of items per page, between 1 and 100 | | `ruleName` | string | Yes | The rule name to filter anomalies by (will be URL encoded automatically) | | `validationId` | string | Yes | The unique identifier of the validation to retrieve anomalies for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Validation Configuration **Slug:** `KADOA_GET_VALIDATION_CONFIG` Tool to retrieve the data validation configuration for a specific workflow. Use this to check validation status, alerting thresholds, and rule counts before modifying validation settings. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | Yes | The unique identifier of the workflow to retrieve validation configuration for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Validation Rule **Slug:** `KADOA_GET_VALIDATION_RULE` Tool to retrieve a specific validation rule by its ID. Use this to inspect rule details including configuration, status, and metadata. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `ruleId` | string | Yes | The unique identifier of the validation rule to retrieve | | `includeDeleted` | string | No | Whether to include soft-deleted rules (admin only). Note: API has strict boolean validation. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Workflow Audit Log **Slug:** `KADOA_GET_WORKFLOW_AUDIT_LOG` Retrieve audit log entries for a workflow. Use when you need to track changes and operations performed on a workflow. Returns paginated log entries showing operation type, user information, and changed values. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | integer | No | Page number for pagination (starts at 1) | | `limit` | integer | No | Number of items per page (1-100) | | `workflowId` | string | Yes | The unique identifier of the workflow. Obtain this from the Get Workflows action | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Workflow Job **Slug:** `KADOA_GET_WORKFLOW_JOB` Tool to retrieve the current status and telemetry information for a specific workflow job. Use when you need to check the execution status, errors, or metadata of a particular job run. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `jobId` | string | Yes | The unique identifier of the job. Obtain this from the Get Workflow Run History action | | `workflowId` | string | Yes | The unique identifier of the workflow. Obtain this from the Get Workflows action | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Workflow Run History **Slug:** `KADOA_GET_WORKFLOW_RUN_HISTORY` Tool to fetch workflow run history. Use when you need to retrieve past run records for a workflow after execution. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | Yes | The unique identifier of the workflow. Obtain this from the KADOA_GET_WORKFLOWS action | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Workflows **Slug:** `KADOA_GET_WORKFLOWS` Retrieve a paginated list of workflows with optional filtering. Use this tool to list all workflows in your Kadoa account. You can filter by: - search: Find workflows by name, URL, or ID - state: Filter by workflow state (ACTIVE, PAUSED, ERROR, etc.) - monitoring: Filter by whether monitoring is enabled Returns workflow details including name, state, URLs, schema, and run statistics. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of items to skip (offset) for pagination, must be >= 0 | | `limit` | integer | No | Maximum number of workflows to return per page (1-100) | | `state` | string ("ACTIVE" | "ERROR" | "PAUSED" | "NOT_SUPPORTED" | "PREVIEW" | "QUEUED" | "SETUP_RUNNING" | "ERROR_SETUP") | No | Filter by workflow state (e.g., ACTIVE, PAUSED, ERROR) | | `search` | string | No | Search term to filter workflows by name, URL, or ID | | `monitoring` | boolean | No | Filter workflows by monitoring status. True returns only monitored workflows, False returns only non-monitored workflows. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Workflow Trigger **Slug:** `KADOA_GET_WORKFLOW_TRIGGER` Tool to retrieve a specific trigger for a workflow. Use this when you need to inspect trigger details including its configuration and status. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `triggerId` | string | Yes | The unique identifier of the trigger to retrieve | | `workflowId` | string | Yes | The unique identifier of the workflow | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Workflow Validation Results **Slug:** `KADOA_GET_WORKFLOW_VALIDATION_RESULTS` Retrieves the latest validation results for a specific workflow job. Returns validation details including anomalies detected, rules executed, and schema issues. Returns has_results=false if no validation results exist for the specified job. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `jobId` | string | Yes | Identifier of the job within the workflow | | `workflowId` | string | Yes | Identifier of the workflow to fetch validation results for | | `includeDryRun` | boolean | No | Whether to include dry-run validation results | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Workspace Details **Slug:** `KADOA_GET_WORKSPACE_DETAILS` Tool to retrieve detailed information about a workspace (user, team, or organization). Use when you need to get workspace metadata including name, type, email, feature flags, and team information. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workspaceId` | string | Yes | Workspace ID (user, team, or organization). This is the unique identifier for the workspace whose details you want to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Activity Events **Slug:** `KADOA_LIST_ACTIVITY` Tool to retrieve activity events from audit logs with basic filtering and pagination. Use when you need to track workflow events, user actions, or system activities. Supports time-based filtering (absolute or relative), event type filtering, and resource filtering. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of activity events to return per page | | `offset` | integer | No | Number of items to skip (offset) for pagination, must be >= 0 | | `userId` | string | No | Filter by user ID to show only activity events performed by a specific user | | `endDate` | string | No | Filter events that occurred on or before this date (ISO 8601 format or epoch timestamp) | | `startDate` | string | No | Filter events that occurred on or after this date (ISO 8601 format or epoch timestamp) | | `eventTypes` | string | No | Comma-separated list of event types to filter by (e.g., 'workflow_created,workflow_updated') | | `interfaces` | string | No | Comma-separated list of request sources to filter by (e.g., SYSTEM, UI, SDK, API) - filters by requestSource field | | `workflowId` | string | No | Filter by workflow ID to show only activity events related to a specific workflow | | `relativeTime` | string | No | Relative time window counted backwards from now (e.g., 6h for last 6 hours, 1d for last day, 2w for last 2 weeks) | | `resourceTypes` | string | No | Comma-separated list of resource types to filter by (e.g., WORKFLOW, DATA_QUALITY_RULE, SCHEMA, NOTIFICATION_CHANNEL) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Changes **Slug:** `KADOA_LIST_CHANGES` Tool to retrieve all data changes detected across workflows in your Kadoa account. Use this when you need to monitor what data has changed in your workflows over time. You can filter changes by workflow IDs, date range, and paginate through results. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of records to skip for pagination (offset). Must be >= 0. | | `limit` | integer | No | Number of records to return per page. Must be >= 1. | | `endDate` | string | No | End date to filter changes in ISO 8601 format (e.g., '2024-12-31T23:59:59Z'). Only changes detected on or before this date will be returned. | | `exclude` | string | No | Comma-separated list of fields to exclude from each change object (e.g., 'data,differences'). Use this to reduce response size when you don't need all fields. | | `startDate` | string | No | Start date to filter changes in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Only changes detected on or after this date will be returned. | | `workflowIds` | string | No | Comma-separated list of workflow IDs to filter changes. If not provided, returns changes for all ACTIVE workflows. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Crawl Sessions **Slug:** `KADOA_LIST_CRAWL_SESSIONS` Tool to retrieve a paginated list of crawling sessions with optional filtering. Use when you need to view all crawl sessions or filter by user ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | integer | No | Page number for pagination, starts at 1 | | `userId` | string | No | Filter sessions by user ID | | `pageSize` | integer | No | Number of items per page | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Job Validations **Slug:** `KADOA_LIST_JOB_VALIDATIONS` Tool to list all validation runs for a specific job with pagination support. Use when you need to retrieve the full validation history for a job, not just the latest result. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | integer | No | Page number for pagination, must be ≥ 1 | | `jobId` | string | Yes | The unique identifier of the job within the workflow | | `pageSize` | integer | No | Number of items per page, between 1 and 100 | | `workflowId` | string | Yes | The unique identifier of the workflow | | `includeDryRun` | boolean | No | Include dry run validations in results | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Notification Channels **Slug:** `KADOA_LIST_NOTIFICATION_CHANNELS` Tool to retrieve all notification channels configured for the account. Use when you need to list available channels for alerts delivery. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | No | Workflow ID (optional, if provided returns channels linked to this workflow) | | `includeConfigurations` | boolean | No | Include linked notification configurations with workflow information | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Notification Settings **Slug:** `KADOA_LIST_NOTIFICATION_SETTINGS` Tool to retrieve all notification settings, with optional filtering by workflow ID or event type. Use when you need to list configured notifications or check existing settings before creating new ones. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `eventType` | string ("workflow_started" | "workflow_finished" | "workflow_failed" | "workflow_sample_finished" | "workflow_data_change" | "system_maintenance" | "service_degradation" | "credits_low" | "free_trial_ending") | No | Filter settings by event type. If omitted, returns settings for all event types. | | `workflowId` | string | No | Workflow ID(s) to filter settings. Can be a single ID, comma-separated IDs, or 'null' for workspace-level settings. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Schemas **Slug:** `KADOA_LIST_SCHEMAS` Tool to retrieve all schemas accessible by the authenticated user. Use this when you need to see available schema definitions or find a specific schema by name or entity type. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Support States **Slug:** `KADOA_LIST_SUPPORT_STATES` Tool to retrieve available support issue states. Use when you need to see what states can be assigned to support tickets. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Validation Rules **Slug:** `KADOA_LIST_VALIDATION_RULES` Tool to list all data validation rules with optional pagination and filtering. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `page` | integer | No | Page number for pagination, must be ≥ 1 | | `status` | string ("preview" | "enabled" | "disabled") | No | Filter rules by status | | `groupId` | string | No | Group ID to filter validation rules | | `pageSize` | integer | No | Number of items per page, between 1 and 100 | | `workflowId` | string | No | Workflow ID to filter validation rules. Optional; if omitted returns rules across workflows. | | `includeDeleted` | boolean | No | Whether to include soft-deleted rules (admin only) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Workflow Triggers **Slug:** `KADOA_LIST_WORKFLOW_TRIGGERS` Tool to get all triggers where the specified workflow is the source. Use when you need to retrieve the list of triggers associated with a workflow, such as understanding what actions or workflows are triggered by this workflow's execution. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | Yes | Unique identifier of the source workflow (UUID format). Obtain this from the KADOA_GET_WORKFLOWS action | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Pause Crawl Session **Slug:** `KADOA_PAUSE_CRAWL_SESSION` Tool to pause an active crawling session. Use when you need to temporarily stop a running crawl without terminating it completely. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sessionId` | string | Yes | ID of the crawling session to pause | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Pause Workflow **Slug:** `KADOA_PAUSE_WORKFLOW` Tool to pause a running or scheduled workflow. Use when you need to temporarily stop a workflow from executing. The workflow will remain paused until explicitly resumed or reactivated. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | Yes | The unique identifier of the workflow to pause. Obtain this from the Get Workflows action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Advanced Workflow **Slug:** `KADOA_POST_ADVANCED_WORKFLOW` Tool to create an advanced workflow. Use when you need a valid advanced workflow ID before updating steps. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Optional user-friendly name for the new advanced workflow | | `limit` | integer | No | Optional maximum number of steps allowed in the workflow | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Start Crawl Session **Slug:** `KADOA_POST_CRAWL` Starts a new web crawling session to crawl and index pages from a website. Use this tool when you need to: - Crawl an entire website or specific sections - Gather page content for extraction or analysis - Index multiple pages from a domain Returns a session_id that can be used with get_crawl_status to monitor progress and get_crawled_pages to retrieve the crawled content. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | URL to start crawling, must be a valid URI | | `timeout` | integer | No | Maximum crawling time in milliseconds, e.g., 1800000 for 30 minutes | | `maxDepth` | integer | No | Maximum depth to traverse during the crawl | | `maxPages` | integer | No | Maximum number of pages to crawl | | `startUrls` | array | No | Multiple start URLs (mutually exclusive with 'url'). Must belong to same domain/subdomain | | `proxyCountry` | string | No | Country code for proxy configuration, e.g., 'DE' | | `strictDomain` | boolean | No | Restrict crawler to the exact domain without subdomains | | `pathsFilterIn` | array | No | List of path patterns to include in the crawl | | `pathsFilterOut` | array | No | List of path patterns to exclude from the crawl | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Notification Setting **Slug:** `KADOA_POST_NOTIFICATION_SETTING` Tool to create a notification setting linking channels to events. Use when subscribing workflows or workspace-level notifications to specific events. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `enabled` | boolean | No | Whether the subscription is active. Defaults to true. | | `eventType` | string ("workflow_started" | "workflow_finished" | "workflow_failed" | "workflow_sample_finished" | "workflow_data_change" | "system_maintenance" | "service_degradation" | "credits_low" | "free_trial_ending") | Yes | Type of event to subscribe to. | | `channelIds` | array | Yes | List of notification channel IDs to link with this setting. | | `workflowId` | string | No | Workflow ID to scope the setting; omit for a workspace-level setting. | | `eventConfiguration` | object | Yes | Configuration object for the event. Currently accepts an empty object; reserved for future extensions. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Send Test Notification **Slug:** `KADOA_POST_NOTIFICATION_TEST` Sends a test notification event to verify notification channel configurations are working correctly. Use this tool to test that your notification channels (email, Slack, Teams, webhooks, etc.) are properly configured before relying on them for production workflows. The test sends a simulated event of the specified type, which will be delivered to all configured notification channels for that event type. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `eventType` | string ("workflow_data_change" | "workflow_sample_finished" | "workflow_finished" | "workflow_failed" | "workflow_validation_anomaly_change") | Yes | The type of notification event to simulate. Options: 'workflow_data_change' (triggered when workflow data changes), 'workflow_sample_finished' (triggered when a sample extraction completes), 'workflow_finished' (triggered when a workflow run completes), 'workflow_failed' (triggered when a workflow fails), 'workflow_validation_anomaly_change' (triggered when validation detects anomalies). | | `workflowId` | string | No | Optional workflow ID to associate with the test notification event. When provided, the test notification will include this workflow ID in its payload. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Subscribe to Webhook Events **Slug:** `KADOA_POST_WEBHOOK_SUBSCRIPTION` Tool to subscribe to specified webhook events. This will create a webhook channel and then create notification settings for the provided events linking that channel. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `events` | array | Yes | List of event names to subscribe to. Valid event types include: workflow_started, workflow_finished, workflow_failed, workflow_export_completed, workflow_sample_finished, workflow_data_change, workflow_validation_anomaly_change, system_maintenance, service_degradation, credits_low, free_trial_ending. Use GET /v5/notifications/event-types to fetch the full list. | | `webhookUrl` | string | Yes | Destination URL for webhook deliveries | | `workflowId` | string | No | Optional workflow ID to scope the subscription. Omit for workspace-level. | | `channelName` | string | No | Optional name for the created webhook channel. If omitted, a default will be used. | | `webhookHttpMethod` | string ("GET" | "POST") | Yes | HTTP method to use when sending the webhook | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Workflow **Slug:** `KADOA_POST_WORKFLOW` Create a new Kadoa web scraping workflow. This tool creates a workflow that can extract structured data from web pages. Provide URLs to scrape, specify a navigation mode, and define the data schema. For structured extraction: Use 'single-page' mode with entity + fields. For paginated content: Use 'paginated-page' mode. For AI-driven navigation: Use 'agentic-navigation' mode with userPrompt (Enterprise only). Note: Workflow creation may take 60+ seconds as Kadoa analyzes the target URLs. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Human-readable name of the workflow | | `tags` | array | No | Tags for categorization | | `urls` | array | Yes | List of URLs to scrape | | `limit` | integer | No | Maximum number of items to scrape | | `entity` | string | No | Entity name for extraction; required unless using agentic-navigation or schemaId | | `fields` | array | No | Schema fields for extraction; required unless using agentic-navigation or schemaId | | `interval` | string ("ONLY_ONCE" | "EVERY_10_MINUTES" | "HALF_HOURLY" | "HOURLY" | "THREE_HOURLY" | "SIX_HOURLY" | "TWELVE_HOURLY" | "EIGHTEEN_HOURLY" | "DAILY" | "TWO_DAY" | "THREE_DAY" | "WEEKLY" | "BIWEEKLY" | "TRIWEEKLY" | "FOUR_WEEKLY" | "MONTHLY" | "REAL_TIME" | "CUSTOM") | No | Update frequency for the workflow | | `location` | object | No | Location configuration for scraping. | | `schemaId` | string | No | Reference an existing schema instead of providing entity/fields | | `autoStart` | boolean | No | If true, automatically start the workflow after creation | | `schedules` | array | No | Cron expressions for custom schedules | | `monitoring` | object | No | Monitoring configuration object | | `userPrompt` | string | No | Prompt for agentic-navigation; required when navigationMode is 'agentic-navigation' | | `description` | string | No | Workflow description, max 500 characters | | `interactions` | array | No | Browser interactions to perform before scraping | | `bypassPreview` | boolean | No | If true, bypass preview and install immediately | | `navigationMode` | string ("single-page" | "paginated-page" | "page-and-detail" | "agentic-navigation") | Yes | Navigation mode: 'single-page' for single URL extraction, 'paginated-page' for paginated lists, 'page-and-detail' for list+detail pages, 'agentic-navigation' for AI-driven (Enterprise only) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Configure Workflow Monitoring **Slug:** `KADOA_POST_WORKFLOW_MONITORING` Configure monitoring and scheduling for a Kadoa workflow to detect data changes. This tool allows you to: - Set up recurring workflow runs at specified intervals (daily, hourly, weekly, etc.) - Enable monitoring to detect when specific fields change (e.g., price changes, stock updates) - Configure conditions to filter which changes trigger notifications Use this after creating a workflow or to update an existing workflow's monitoring settings. The workflow must exist before you can configure its monitoring. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `date` | string | No | ISO 8601 datetime for the next scheduled run. If not provided, defaults to 1 hour from now. Example: '2025-01-25T14:00:00Z' | | `schedules` | array | No | Cron expressions for custom schedules. Required only when updateInterval is 'CUSTOM'. Example: ['0 9 * * 1-5'] runs at 9 AM on weekdays. | | `monitoring` | object | No | Configuration for workflow monitoring and change detection. | | `workflowId` | string | Yes | The unique identifier of the workflow to configure. Obtain this from the 'Get Workflows' or 'Create Workflow' actions. | | `updateInterval` | string ("ONLY_ONCE" | "EVERY_10_MINUTES" | "HALF_HOURLY" | "HOURLY" | "THREE_HOURLY" | "SIX_HOURLY" | "TWELVE_HOURLY" | "EIGHTEEN_HOURLY" | "DAILY" | "TWO_DAY" | "THREE_DAY" | "WEEKLY" | "BIWEEKLY" | "TRIWEEKLY" | "FOUR_WEEKLY" | "MONTHLY" | "REAL_TIME" | "CUSTOM") | No | How often the workflow should run. Common values: 'DAILY' for once per day, 'HOURLY' for every hour, 'WEEKLY' for once per week. Use 'CUSTOM' with schedules for cron-based scheduling. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Generate Workflow Validation Rule **Slug:** `KADOA_POST_WORKFLOW_VALIDATION_RULE` Generate an AI-powered data validation rule for a Kadoa workflow. This tool uses AI to convert a natural-language description into a SQL-based validation rule that can detect data quality issues in workflow outputs. Prerequisites: - The workflow must have completed at least one successful job run - The workflow must have data validation enabled The generated rule will be created in 'preview' status for testing before activation. Use the List Validation Rules action to view created rules, and the Bulk Approve Validation Rules action to activate them. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `jobId` | string | No | Optional job ID to use for generating the rule. If not provided, the most recent completed job will be used. | | `userPrompt` | string | Yes | A natural-language description of the data validation rule to generate. The AI will convert this into a SQL-based validation rule. Be specific about field names and conditions. | | `workflowId` | string | Yes | The unique identifier of the workflow to add a validation rule to. The workflow must have completed at least one job run successfully. | | `isPreviewRun` | boolean | No | If true, the rule is created in preview mode for testing before activation. Defaults to creating rules in preview status. | | `selectedColumns` | array | No | Optional list of specific column names to target when generating the validation rule. If omitted, the AI may target any relevant columns based on the prompt. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Notification Channel **Slug:** `KADOA_PUT_NOTIFICATION_CHANNEL` Tool to update an existing notification channel. Use when you need to modify channel details. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Human-readable name for the notification channel | | `config` | object | Yes | Channel-specific configuration. For EMAIL: {'recipients': ['email@example.com']}. For SLACK: {'webhookUrl': 'https://hooks.slack.com/...'}. For WEBHOOK: {'webhookUrl': 'https://...', 'httpMethod': 'POST'}. For WEBSOCKET: {'endpoint': 'wss://...'} | | `channelId` | string | Yes | Unique identifier (UUID) of the notification channel to update. Obtain this from the Create Notification Channel or Get Notification Channel actions. | | `channelType` | string ("EMAIL" | "SLACK" | "WEBHOOK" | "WEBSOCKET") | Yes | Type of notification channel: EMAIL, SLACK, WEBHOOK, or WEBSOCKET | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Resume Crawl Session **Slug:** `KADOA_RESUME_CRAWL_SESSION` Tool to resume a paused crawling session. Use when you need to restart a crawl that was previously paused or stopped. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sessionId` | string | Yes | ID of the crawling session to resume | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Resume Workflow **Slug:** `KADOA_RESUME_WORKFLOW` Resumes a paused, preview, or error workflow. Use when you need to activate a workflow that is not currently running. Cannot resume workflows in certain states; check workflow state first using Get Workflows action. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | Yes | The unique identifier (UUID) of the workflow to resume. Obtain this from the Get Workflows action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Run Ad-hoc Extraction **Slug:** `KADOA_RUN_ADHOC_EXTRACTION` Tool to synchronously extract data from a URL using a given template. Use after choosing the schemaId (custom or 'html', 'body', 'markdown'). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `link` | string | Yes | The URL to scrape | | `location` | object | No | Proxy location settings, including selection type and ISO country code. | | `schemaId` | string | Yes | Custom schema ID or one of 'html', 'body', 'markdown' to control output format | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Run Workflow **Slug:** `KADOA_RUN_WORKFLOW` Tool to trigger a workflow to run immediately. Use when you need to start a workflow execution on demand. Returns a job ID that can be used to track the execution status. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Optional limit for the number of records to process during this workflow execution | | `variables` | object | No | Optional variables to pass to the workflow execution. These variables can be used within the workflow for dynamic behavior. | | `workflowId` | string | Yes | The unique identifier (UUID) of the workflow to run. Obtain this from the Get Workflows action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Schedule Validation Job **Slug:** `KADOA_SCHEDULE_VALIDATION_JOB` Tool to schedule a data validation job for a specific workflow job. Use this to trigger validation rules on job data, detect anomalies, and ensure data quality. Supports custom SQL rules, dry-run mode, and idempotent validation IDs. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `jobId` | string | Yes | The unique identifier (UUID) of the job within the workflow to validate | | `dryRun` | boolean | No | If true, validation runs without persisting results. Useful for testing rules. | | `strategy` | string ("ISOLATED" | "LINKING_COLUMNS") | No | Strategy for data validation execution. | | `usedPrompt` | string | No | Optional LLM prompt used to generate or explain rules, for tracking purposes | | `workflowId` | string | Yes | The unique identifier (UUID) of the workflow to validate | | `customRules` | array | No | Optional list of custom SQL validation rules to apply in addition to library rules | | `validationId` | string | No | Client-provided validation ID (UUID) for idempotency. If omitted, server generates one. | | `skipLibraryRules` | boolean | No | If true, only custom rules will be used. If false or omitted, both library and custom rules are applied. | | `isWorkflowTriggered` | boolean | No | Internal flag: true when validation is triggered by workflow execution | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Unsubscribe from Webhook Events **Slug:** `KADOA_UNSUBSCRIBE_FROM_WEBHOOK_EVENTS` Unsubscribe from webhook event notifications by deleting a notification setting. Use this tool when you need to: - Remove an existing notification subscription by its settings ID - Stop receiving webhook notifications for specific events - Clean up notification configurations The settings ID can be obtained from the response of the Subscribe to Webhook Events action or from listing notification settings. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `settingsId` | string | Yes | The unique identifier (UUID) of the notification settings to delete. This ID is returned when creating notification settings via the POST /v5/notifications/settings endpoint or Subscribe to Webhook Events action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Notification Settings **Slug:** `KADOA_UPDATE_NOTIFICATION_SETTINGS` Tool to update existing notification settings for events. Use when modifying notification configurations such as enabled status, event type, event configuration, or linked channels. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `enabled` | boolean | No | Whether the notification setting is active. Set to true to enable, false to disable. | | `eventType` | string ("workflow_started" | "workflow_finished" | "workflow_failed" | "workflow_sample_finished" | "workflow_data_change" | "system_maintenance" | "service_degradation" | "credits_low" | "free_trial_ending") | No | Type of event to subscribe to. | | `channelIds` | array | No | Array of channel IDs to link to this settings. Updates the list of notification channels associated with this setting. | | `settingsId` | string | Yes | Unique identifier (UUID) of the notification setting to update. Obtain this from creating a notification setting or listing existing settings. | | `eventConfiguration` | object | No | Settings specific to the event type. Currently accepts an empty object {}. This object will be extended in future releases to support event-specific configuration options. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Schema **Slug:** `KADOA_UPDATE_SCHEMA` Tool to update an existing Kadoa schema. Use when you need to modify schema metadata (name, entity) or update the field definitions. At least one of name, entity, or fields must be provided to update the schema. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | Name of the schema (1-255 characters) | | `entity` | string | No | Entity type for the schema | | `fields` | array | No | Array of field definitions. Each field can be a DataField (with name, description, dataType), RawContentField (with name, fieldType='RAW_CONTENT', metadataKey), or ClassificationField (with name, fieldType='CLASSIFICATION', categories). | | `schemaId` | string | Yes | Unique identifier (UUID) of the schema to update | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Validation Configuration **Slug:** `KADOA_UPDATE_VALIDATION_CONFIG` Tool to update the complete data validation configuration including alerting settings for a specific workflow. Use this to modify validation status, alert thresholds, and notification preferences. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `workflowId` | string | Yes | The unique identifier of the workflow to update validation configuration for | | `dataValidation` | object | Yes | Data validation configuration with alerting settings to update | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Workflow Metadata **Slug:** `KADOA_UPDATE_WORKFLOW_METADATA` Tool to update workflow metadata such as name, description, tags, and configuration settings. Use when you need to modify an existing workflow's properties without recreating it. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | No | The new name for the workflow | | `tags` | array | No | The tags for the workflow | | `urls` | array | No | List of target URLs for the workflow | | `limit` | integer | No | The new limit for the workflow (maximum items to extract) | | `entity` | string | No | The new entity for the workflow | | `schema` | array | No | The new extraction schema for the workflow (required when switching from agentic-navigation to other modes) | | `location` | object | No | Location configuration for the workflow. | | `maxDepth` | integer | No | Maximum crawl depth (only for crawler workflows, 1-200) | | `maxPages` | integer | No | Maximum pages to crawl (only for crawler workflows, 1-100000) | | `schedules` | array | No | Array of cron expressions for the workflow schedule | | `monitoring` | object | No | Monitoring configuration for the workflow. | | `userPrompt` | string | No | User prompt for agentic navigation mode (required when switching to agentic-navigation, 10-5000 characters) | | `workflowId` | string | Yes | ID of the workflow to update | | `description` | string | No | The new description for the workflow | | `pathsFilterIn` | array | No | Regex patterns to include specific paths (only for crawler workflows) | | `additionalData` | object | No | Additional static data for the workflow | | `navigationMode` | string ("single-page" | "paginated-page" | "page-and-detail" | "agentic-navigation" | "all-pages") | No | Navigation mode for scraping. Switching between modes may require additional fields: to 'agentic-navigation' requires userPrompt (10-5000 characters), from 'agentic-navigation' to other modes requires schema and entity, to 'all-pages' requires all URLs to have the same hostname | | `pathsFilterOut` | array | No | Regex patterns to exclude specific paths (only for crawler workflows) | | `updateInterval` | string ("ONLY_ONCE" | "HOURLY" | "DAILY" | "WEEKLY" | "MONTHLY" | "CUSTOM") | No | The new update interval for the workflow | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Workflow Trigger **Slug:** `KADOA_UPDATE_WORKFLOW_TRIGGER` Tool to update trigger properties including event type and enabled status. Use when you need to modify an existing workflow trigger's configuration. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `enabled` | boolean | No | Whether the trigger is enabled. Set to true to enable the trigger, false to disable it. | | `eventType` | string ("workflow_started" | "workflow_finished" | "workflow_failed" | "workflow_data_change" | "workflow_sample_finished" | "workflow_export_completed" | "workflow_validation_anomaly_change") | No | Event types for workflow triggers. | | `triggerId` | string | Yes | The unique identifier of the trigger to update. | | `workflowId` | string | Yes | The unique identifier of the workflow. Obtain this from the Get Workflows action. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not |