# What this brief covers
This brief explains how Workato's built-in Test Automation feature validates recipe logic, what it does not cover, and practical steps to use tests effectively in CI. Use it when you need to decide if a green recipe test is sufficient or if you must add higher-level checks.
# How Workato recipe tests work
Workato test cases live on a single recipe and are configured in the recipe's Test cases tab. Each test case supplies mock (simulated) data for the trigger and any steps that would reach a third-party app. Tests run the recipe with those mocks and assert on named step outputs using checks.
# The mock boundary and control flow
Mocks replace the trigger and any step that would reach an external application. Control flow elements—conditions, loops, Stop job, Monitor and ON ERROR blocks, and Return actions—execute normally during a test, so branches only run if the provided mock data satisfies their triggers. You can cover negative scenarios by feeding deliberately erroneous mock data and asserting that a step throws an error.
# Assertions: the 10 check operators
Workato provides ten check operators for assertions:
- Equals, Contains, Starts with, Ends with
- The four negations of those operators
- Is present and Is not present
# Test case limits and practical notes
- Test case size cap: 10 MB. Keep mocks and recorded outputs within that limit.
- Mocked steps do not reach the network. A green test means recipe logic is correct for those inputs, not that connectors or external APIs behave as expected.
# Test Automation API and CI gates
The Test Automation API accepts POST requests to /api/test_cases/run_requests and is rate-limited to 60 requests per minute. You can trigger runs by manifest, project, folder, recipe, or test case id, then poll the run request for status and coverage. Use these endpoints to integrate recipe tests into CI pipelines and deploy gates.
Because recipe tests do not exercise downstream systems, include an independent end-to-end business-process test suite that runs against real systems. Collect recipe test results and end-to-end checks in the same gate so deployments fail when either logic or integration assumptions are broken.
# Where recipe tests stop — common failure modes
Recipe tests commonly miss failures caused by:
- Schema drift upstream (field rename or type change) where mocks are stale
- Empty vs absent values that change runtime behavior
- Connector or downstream API changes that only show up when the real call runs
- Deleted or renamed assets that deployments may not remove — Workato deploys overwrite or add assets but leaves removed items in place, so deleted assets can persist in a Test environment
If your risk model includes these failure modes, add higher-level checks: contract tests, live connector smoke tests, or full end-to-end reconciliation tests.
# Practical checklist before deployment
- Keep test cases per recipe and limit payloads to stay under 10 MB.
- Mock every external step and assert on exact step outputs using the provided check operators.
- Add negative cases by passing invalid mock data and asserting that steps error where expected.
- Integrate Test Automation API runs into CI but cap calls to respect the 60/min rate limit.
- Run a separate end-to-end suite that exercises downstream systems and record both results together in your release gate.
# Bottom line
Workato's Test Automation is effective for verifying recipe logic with simulated data. Treat green recipe tests as one layer of defense, not a substitute for tests that validate real downstream behavior or catch schema drift in production data.