Documentation

Everything you need to build powerful automations with StitchOps.

Getting Started

Build your first automation workflow in under 5 minutes.

Prerequisites

  • StitchOps account
  • Desktop agent installed
  • Chrome or Firefox browser

Quick Start

Step 1: Install the Desktop Agent

The desktop agent is provided by StitchOps for your operating system. The agent runs locally and executes your workflows.

Download agents from the Admin Panel → Agent Downloads section (available to workspace administrators).

Step 2: Create Your First Workflow

  1. Click "New Workflow" from the main dashboard
  2. Give your workflow a name and description
  3. Drag nodes from the sidebar onto the canvas
  4. Connect nodes to define execution order
  5. Configure each node by clicking on it

Step 3: Execute and Monitor

Click the "Execute" button to run your workflow. Monitor real-time progress in the execution console.

Core Concepts

Understand the fundamental building blocks and architecture of StitchOps's intelligent automation platform.

Workflows

A workflow is a visual automation sequence built with nodes and connections. Think of it as a flowchart where each box performs an action (click a button, send an email, query a database) and arrows define the execution order.

Nodes

Nodes are the building blocks of workflows. Each node represents a single action: navigate to a URL, click an element, extract text, make an API call, run AI analysis, or execute custom logic.

Execution Context & Variables

As a workflow executes, each node can store data in the execution context—a shared memory space accessible to all subsequent nodes.

# Node 1: Extract email context.customer_email = "john@example.com" # Node 2: Send email using variable sendEmail(to: context.customer_email)

Selectors & Element Targeting

StitchOps supports multiple selector strategies:

  • CSS Selectors: #login-button, .submit-form, input[name="email"]
  • XPath: //button[contains(text(), "Login")]
  • Text-based: Click element containing "Submit"
  • Image Recognition: Click element matching screenshot template
  • AI Vision: "Click the blue submit button in the bottom right"

Error Handling & Resilience

Workflows include built-in error handling mechanisms:

  • Try/Catch nodes wrap risky operations and define fallback behavior
  • Retry logic automatically retries failed actions
  • Timeout settings prevent workflows from hanging indefinitely
  • Conditional branching allows workflows to adapt based on success/failure

StitchOps vs Traditional RPA/iPaaS

Why StitchOps represents the next generation of intelligent automation—combining the best of RPA, iPaaS, and AI at a fraction of the cost.

The Comparison

iPaaS Platforms (Zapier, Workato)

  • Connect cloud APIs excellently
  • Webhook-based triggers
  • Cannot access desktop apps
  • Cannot automate legacy systems
  • No UI automation capabilities
  • Expensive: $70,000-100,000/year for full stack

Traditional RPA (UiPath, AA)

  • Desktop automation
  • UI automation with selectors
  • Requires specialized RPA developers
  • Breaks when UI changes
  • High maintenance costs (30-40% of budget)
  • Expensive: $200,000+/year total cost

StitchOps: The Best of Both Worlds

  • Native API integrations + Desktop automation
  • AI-powered element identification
  • True low-code builder
  • Built-in data storage
  • Edge computing - data stays local
  • 90% lower cost than buying both platforms

Bottom Line: StitchOps eliminates the false choice between iPaaS and RPA. Get cloud API integrations, desktop automation, AI-powered self-healing, and built-in data intelligence—all in one platform at a fraction of the cost.

Stitch AI Copilot

Your AI-powered automation assistant that transforms natural language into production-ready workflows in seconds.

Natural Language to Workflow

Describe what you want in plain English, and Stitch builds the entire workflow:

User: "Check my Gmail for invoices from Acme Corp, download the PDFs, extract the total amounts, and write them to a Google Sheet" Stitch: Creates 8-node workflow with: • Gmail login node • Email search filter • PDF download loop • AI extraction for amounts • Google Sheets write • Error handling

Intelligent Visual Understanding

  • Identifies buttons and fields by appearance
  • Works across different languages and themes
  • Adapts when UI layouts change
  • No CSS selectors or XPaths needed

Self-Healing Workflows

  • Detects when UI elements have moved
  • Finds alternative paths to complete actions
  • Learns from failures and adapts
  • Zero downtime for cosmetic UI updates

Pro Tip: Stitch works best when you describe the business outcome, not the technical steps. Say "process invoices and update accounting system" instead of "click button, extract text, call API".

Node Reference

Complete reference for all available node types in StitchOps workflows.

Browser Actions

Automate web browser interactions including navigation, clicking, form filling, and data extraction.

BROWSER.OPEN

Open a new browser window

BROWSER.NAVIGATE

Navigate to a specific URL

BROWSER.CLICK

Click an element using selectors

BROWSER.TYPE

Type text into an input field

BROWSER.EXTRACT

Extract text or attribute values

BROWSER.SCREENSHOT

Capture a screenshot

Desktop Actions

Control desktop applications and perform system-level operations.

DESKTOP.LAUNCH_APP

Launch a desktop application

DESKTOP.CLICK_IMAGE

Click on a specific image

DESKTOP.CLICK_TEXT

Click on text found via OCR

DESKTOP.SCREENSHOT

Capture desktop screenshot

API Actions

Integrate with external services via REST, GraphQL, and HTTP APIs.

API.HTTP_REQUEST

Make HTTP request

API.GRAPHQL_REQUEST

Execute GraphQL query

API.POST

HTTP POST request

AI Actions

Leverage AI capabilities for text generation and image analysis.

AI.TEXT_COMPLETION

Generate text using AI models

AI.IMAGE_ANALYSIS

Analyze images and extract insights

Data Operations

Store, transform, and manage data using FlexSchemas.

DATA.CREATE_RECORD

Create a new record

DATA.READ

Read records with filters

DATA.UPDATE_USER_ATTRIBUTE

Update a specific field

DATA.PARSE_JSON

Parse JSON string

File Operations

Read, write, and process files in various formats.

FILE.READ_TEXT_FILE

Read plain text file

FILE.WRITE_TEXT_FILE

Write text to file

FILE.READ_CSV

Read and parse CSV

FILE.READ_EXCEL

Read Excel spreadsheet

FILE.READ_PDF

Extract text from PDF

Application Connectors

Securely connect to external applications and services with encrypted credential storage in your StitchOps Crypt vault.

SaaS & Cloud Applications

Google Workspace

Gmail automation, Google Sheets sync, Drive management

OAuth 2.0

Okta

User provisioning, MFA management, identity automation

API Token

Salesforce

CRM data sync, lead management, opportunity tracking

API Key / OAuth

Slack

Send notifications, post messages, create channels

Bot Token

Microsoft 365

Outlook email, OneDrive files, Teams messages

OAuth 2.0

Security: Credentials are encrypted in your customer-isolated StitchOps Crypt vault. Only your desktop agent can access decrypted values during workflow execution—never exposed in the UI, never logged.

AI Capabilities

Bring your own AI provider for intelligent automation with context-aware decision making.

Controlled Intelligence

Unlike cloud-based AI agents that make unpredictable decisions, StitchOps workflows execute exactly what you define. AI enhances your automation within boundaries you set.

StitchOps Approach

  • • Workflows execute exactly what you define
  • • AI makes decisions within boundaries
  • • Deterministic, auditable behavior
  • • You control the workflow logic

Cloud AI Agents

  • • AI makes autonomous decisions
  • • Unpredictable hallucinated actions
  • • Black box behavior
  • • No audit trail or control

Bring Your Own AI (BYOAI)

Connect your own API keys for the best models from any provider—or use local models for complete data privacy.

OpenAI

GPT-4o, GPT-4 Turbo, GPT-4 Vision

Anthropic

Claude 3.5 Sonnet, Claude 3 Opus

Google

Gemini Pro, Gemini Vision

Local Models

Llama, Mistral, custom fine-tunes

Cost Control: Use cheaper models for simple tasks and premium models for complex reasoning. You control the budget.

Security Architecture

Bank-grade security with customer-isolated encryption and edge computing architecture.

StitchOps Crypt: Your Personal Vault

When you store credentials, they go into your own secure vault that only you can unlock. Each customer gets their own unique encryption key.

  • Customer-isolated encryption keys
  • Other customers cannot decrypt your data—ever
  • Even StitchOps staff cannot access encrypted credentials
  • Automatic key rotation keeps your vault secure

Edge Computing: Your Data Stays Local

Sensitive data is processed locally on your desktop agent. The cloud only receives workflow instructions and metrics—never your actual data.

Stored in Cloud

  • • Workflow definitions
  • • Execution metrics
  • • Error codes (not values)

Never Leaves Local

  • • Passwords & API keys
  • • Business data
  • • Personally identifiable info (PII)

Compliance: SOC 2 Type II ready, GDPR compliant by design, HIPAA compatible, PCI DSS applicable features.

Use Cases

Real-world automation scenarios and implementation patterns.

Invoice Processing

Intermediate

Download invoices, extract data with AI, validate against purchase orders, and update accounting systems.

Employee Onboarding

Intermediate

Automate multi-department onboarding with role-specific checklists and system provisioning.

Lead Data Collection

Beginner

Extract leads from LinkedIn, Crunchbase, or company websites and store them in your CRM.

E-commerce Inventory Sync

Intermediate

Synchronize product inventory across Shopify, Amazon, eBay, and internal systems in real-time.

Identity System Reconciliation

Advanced

Unify user identities across Active Directory, HRIS, Salesforce, and custom applications.

API Reference

Authentication

All API requests must include an API key in the request headers. Generate API keys from the Admin panel.

X-API-Key: your_api_key_here Content-Type: application/json

Workflows API

Programmatically manage and execute workflows.

GET /api/workflows

Retrieve all workflows in your workspace

POST /api/workflows/:id/execute

Trigger a workflow execution programmatically

GET /api/workflows/:id/executions/:execution_id

Check the status and results of a workflow execution

Data Storage API

Create custom data models tailored to your business needs with instant retrieval and unlimited scale.

POST /api/flex/schemas

Define a new data schema with custom fields

POST /api/flex/data/:schemaName

Insert a new data record into a schema

GET /api/flex/data/:schemaName

Query schema data with filters and sorting

Troubleshooting

Common issues and their solutions.

Agent Not Connecting

  • Verify the desktop agent is running
  • Check that the worker key is correct in agent config
  • Ensure network connectivity to api.stitchops.io
  • Verify firewall/proxy settings allow WebSocket connections

Workflow Execution Failed

  • Review error messages in the execution console
  • Verify all required credentials are configured
  • Test individual nodes in isolation
  • Check that target systems are accessible from the agent

Browser Automation Not Working

  • Ensure Chrome or Firefox is installed
  • Verify browser remote debugging is enabled
  • Confirm element selectors are valid
  • Increase timeout values if pages load slowly

API Authentication Errors

  • Verify API key is in X-API-Key header
  • Check that the API key is active
  • Ensure requests include Content-Type header
  • Verify tenant_id matches your workspace

Still need help? Contact support or use the Stitch AI copilot to generate solutions.

Need Help?

Can't find what you're looking for? Our support team is here to help.

Contact our support team