Frequently Asked Questions (FAQ)
Quick answers to common questions about Defense Catalyst.
Getting Started
What is Defense Catalyst?
Defense Catalyst is an AI-powered workflow automation platform optimized for defense technology and DoD use cases. It allows you to connect apps, automate tasks, and build workflows without coding.
Do I need to know how to code?
No! Defense Catalyst is designed for non-technical users. The visual flow builder lets you create workflows by dragging and dropping. However, if you do know how to code, you can use custom code steps for advanced scenarios.
How is Defense Catalyst different from Zapier or Make?
Defense Catalyst is:
- Self-hosted: Your data stays on your infrastructure
- Defense-focused: Optimized for DoD compliance and security
- Open-source based: Built on Activepieces with defense enhancements
- AI-powered: Includes AI Copilot for flow building assistance
- Air-gap capable: Can run in isolated networks
How do I get started?
- Read the Getting Started Guide
- Follow the Build Your First Workflow Tutorial
- Explore the Integrations Directory
- Check out example workflows in your workspace
Is there a free trial?
Contact your Defense Catalyst administrator for access to your organization’s workspace.
Flows & Workflows
What’s the difference between a flow and a workflow?
They’re the same thing! We use both terms interchangeably. A flow/workflow is an automation that connects a trigger with one or more actions.
How many flows can I create?
This depends on your workspace plan. Check with your administrator for specific limits.
Can I copy a flow?
Yes! In the flow list, click the three-dot menu next to a flow and select “Duplicate”. This creates a copy you can modify.
Can I share flows with my team?
Yes! All flows in a workspace are accessible to team members based on their role (Admin, Editor, or Viewer).
What happens if I delete a flow?
Deleted flows are moved to trash and can be restored within 30 days. After 30 days, they’re permanently deleted.
Can I export/import flows?
Yes! You can export flows as JSON files and import them into other workspaces. This is useful for moving flows between environments.
Triggers
What’s the difference between a trigger and an action?
- Trigger: Starts your flow (e.g., when a webhook is received, on a schedule)
- Action: Does something (e.g., send an email, create a record)
Every flow has exactly one trigger and one or more actions.
Can a flow have multiple triggers?
No, each flow has exactly one trigger. If you need multiple triggers, create separate flows or use a webhook trigger with multiple sources.
How often do polling triggers check for new data?
This depends on your plan and the specific integration. Common intervals are:
- Every 1 minute (premium)
- Every 5 minutes (standard)
- Every 15 minutes (basic)
Why isn’t my webhook trigger firing?
Common causes:
- Flow is not published (still in draft mode)
- Webhook URL is incorrect
- External service isn’t sending webhooks
- Webhook signature validation is failing
See Troubleshooting: Workflow Won’t Trigger
Actions & Integrations
How many integrations does Defense Catalyst support?
Defense Catalyst supports 280+ integrations including Slack, Google Sheets, GitHub, OpenAI, and many more. See the Integrations Directory for the full list.
Can I request a new integration?
Yes! Contact your administrator or submit a request with details about the integration you need.
How do I connect an app?
- Add an action for that app in your flow
- Click “New Connection”
- Follow the authentication steps (OAuth, API key, etc.)
- Test the connection
- Save and reuse across flows
Can I use the same connection in multiple flows?
Yes! Connections are workspace-level and can be reused across all flows.
What if my connection expires?
Some connections (especially OAuth) expire after a period. You’ll need to reconnect:
- Go to Connections in your workspace
- Find the expired connection
- Click “Reconnect”
- Re-authorize the app
Data & Mapping
How do I use data from previous steps?
Use the data picker (lightning bolt icon) to select data from previous steps. You can also type `` directly.
What if the data I need isn’t available?
Common causes:
- Previous step hasn’t run yet (test the flow)
- Previous step failed
- Data structure is different than expected
- Field name has changed
See Troubleshooting: Data Mapping Issues
Can I transform data?
Yes! Use:
- Text operations: Concatenate, split, replace, format
- Date operations: Format, add/subtract time, convert timezones
- JSON operations: Parse, stringify, extract values
- Array operations: Filter, map, reduce, sort
- Code step: Write custom JavaScript for complex transformations
How do I handle arrays/lists?
Use the Loop action to process each item in an array individually. You can also use array operations to filter, map, or transform the entire array at once.
Runs & Debugging
Where can I see my flow runs?
Click on a flow, then go to the “Runs” tab. You’ll see a history of all executions with status, timestamp, and duration.
What do the different run statuses mean?
- Running: Currently executing
- Succeeded: Completed successfully
- Failed: Encountered an error
- Stopped: Manually stopped by user
How long is run history kept?
Run history is retained for 30-90 days depending on your plan. Check with your administrator for specific retention periods.
Can I manually trigger a flow?
Yes! Click the “Test” button in the flow builder to run the flow immediately with test data.
Can I retry a failed run?
Yes! In the run details, click “Retry” to execute the flow again with the same input data.
Why did my flow fail?
Check the run details to see which step failed and the error message. Common causes:
- Connection expired or invalid
- Invalid data format
- API rate limit exceeded
- Timeout
- Missing required fields
See Troubleshooting: Run Failed
Performance & Limits
How long can a flow run?
Maximum execution time is typically 5-10 minutes per run, depending on your plan. If you need longer, consider breaking the flow into smaller flows.
Are there rate limits?
Yes, both Defense Catalyst and external APIs have rate limits:
- Defense Catalyst: Varies by plan
- External APIs: Varies by service (check integration docs)
Can flows run in parallel?
Yes! Multiple flows can run simultaneously. You can also use branches within a flow to execute actions in parallel.
How many steps can a flow have?
Most plans allow 50-100 steps per flow. For complex workflows, consider breaking them into multiple flows connected by webhooks.
Security & Privacy
Is my data secure?
Yes! Defense Catalyst:
- Encrypts data at rest and in transit
- Stores credentials securely
- Supports air-gapped deployments
- Follows DoD security standards
- Provides audit logging
Who can see my flows?
Only members of your workspace can see flows, based on their role:
- Admin: Full access to all flows
- Editor: Can create and edit flows
- Viewer: Can view flows but not edit
Where is my data stored?
Defense Catalyst is self-hosted on your infrastructure. Your data never leaves your environment.
Can I use Defense Catalyst in an air-gapped environment?
Yes! Defense Catalyst supports air-gapped deployments for classified or isolated networks. Contact your administrator for setup details.
How are API keys and passwords stored?
Credentials are encrypted at rest using industry-standard encryption. They’re never exposed in logs or run history.
AI Copilot
What is AI Copilot?
AI Copilot is a ChatGPT-style assistant that helps you build flows. It can:
- Suggest flow structures
- Help with data mapping
- Explain errors
- Recommend integrations
- Generate flow modifications
How do I access Copilot?
Click the “Copilot” button in the flow builder (if enabled for your workspace).
Is Copilot always available?
Copilot availability depends on your workspace configuration. Contact your administrator if you don’t see the Copilot button.
What data does Copilot see?
Copilot sees:
- Your flow structure
- Step configurations
- Validation errors
- Available integrations
Copilot does NOT see:
- Your actual data
- API keys or credentials
- Run history details
- Personal information
Can Copilot build flows for me?
Copilot can suggest flow structures and modifications, but you maintain full control. Review all suggestions before applying them.
Billing & Plans
How is Defense Catalyst priced?
Contact your organization’s administrator for pricing information. Defense Catalyst is typically licensed at the organization level.
What’s included in my plan?
Plan features vary by organization. Common features include:
- Number of flows
- Number of runs per month
- Run history retention
- Number of team members
- Support level
- Advanced features (AI Copilot, etc.)
Can I upgrade my plan?
Contact your administrator to discuss plan upgrades.
Troubleshooting
My flow isn’t working. What should I do?
- Check if the flow is published (not draft)
- Check if the flow is enabled
- Review recent run history for errors
- Test each step individually
- Check connection status
- Review the Troubleshooting Hub
Where can I find error codes?
See the Error Reference for a complete list of error codes and their meanings.
How do I debug a complex flow?
- Test each step individually
- Use the run history to see step-by-step execution
- Add logging steps to track data flow
- Simplify the flow to isolate the issue
- Check the Debugging Guide
Can I get help from support?
Yes! See Contact Support for how to reach our support team.
Advanced Features
Can I use custom code?
Yes! Use the Code step to write custom JavaScript or TypeScript. You have access to NPM packages and can perform complex data transformations.
Can I call my own APIs?
Yes! Use the HTTP Request action to call any API endpoint. See HTTP Request Integration.
Can I use databases?
Yes! Defense Catalyst supports:
- PostgreSQL
- MySQL
- MongoDB
- Microsoft SQL Server
- And more…
See PostgreSQL Integration for an example.
Can I schedule flows?
Yes! Use the Schedule trigger with cron expressions to run flows at specific times or intervals. See Schedule Integration.
Can I create reusable sub-flows?
Not directly, but you can:
- Create a flow with a webhook trigger
- Call it from other flows using HTTP Request
- Pass data via the webhook payload
Migration & Integration
Can I migrate from Zapier/Make?
Yes! While there’s no automatic migration tool, you can:
- Export your workflows from the other platform
- Recreate them in Defense Catalyst
- Use similar integrations and logic
- Test thoroughly before switching
Can Defense Catalyst integrate with our internal systems?
Yes! Use:
- HTTP Request for REST APIs
- Database integrations for direct database access
- Custom pieces for specialized integrations
- Webhooks for event-driven integration
Can I use Defense Catalyst with our CI/CD pipeline?
Yes! Common patterns:
- Trigger flows from CI/CD via webhooks
- Call APIs from flows to trigger deployments
- Send notifications to Slack/Discord
- Update databases with deployment info
Getting Help
Where can I find documentation?
How do I contact support?
See Contact Support for support options and what information to include in your request.
Is there a community forum?
Check with your administrator for internal community resources or forums.
Can I request new features?
Yes! Contact your administrator or submit a feature request with details about what you need.
Still Have Questions?
If your question isn’t answered here:
- Search the documentation
- Check the Troubleshooting Hub
- Contact Support
We’re here to help! 🚀