diff --git a/apps/docs/content/docs/en/execution/api.mdx b/apps/docs/content/docs/en/execution/api.mdx
index 61166941fb..5e8e2ea07c 100644
--- a/apps/docs/content/docs/en/execution/api.mdx
+++ b/apps/docs/content/docs/en/execution/api.mdx
@@ -6,7 +6,7 @@ import { Callout } from 'fumadocs-ui/components/callout'
import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
import { Video } from '@/components/ui/video'
-Sim provides a comprehensive external API for querying workflow execution logs and setting up webhooks for real-time notifications when workflows complete.
+Sim provides a comprehensive external API for querying workflow run logs and setting up webhooks for real-time notifications when workflows complete.
## Authentication
@@ -21,7 +21,7 @@ You can generate API keys from the Sim platform and navigate to **Settings**, th
## Logs API
-All API responses include information about your workflow execution limits and usage:
+All API responses include information about your workflow run limits and usage:
```json
"limits": {
@@ -48,11 +48,11 @@ All API responses include information about your workflow execution limits and u
}
```
-**Note:** Rate limits use a token bucket algorithm. `remaining` can exceed `requestsPerMinute` up to `maxBurst` when you haven't used your full allowance recently, allowing for burst traffic. The rate limits in the response body are for workflow executions. The rate limits for calling this API endpoint are in the response headers (`X-RateLimit-*`).
+**Note:** Rate limits use a token bucket algorithm. `remaining` can exceed `requestsPerMinute` up to `maxBurst` when you haven't used your full allowance recently, allowing for burst traffic. The rate limits in the response body are for workflow runs. The rate limits for calling this API endpoint are in the response headers (`X-RateLimit-*`).
### Query Logs
-Query workflow execution logs with extensive filtering options.
+Query workflow run logs with extensive filtering options.
@@ -70,11 +70,11 @@ Query workflow execution logs with extensive filtering options.
- `level` - Filter by level: `info`, `error`
- `startDate` - ISO timestamp for date range start
- `endDate` - ISO timestamp for date range end
- - `executionId` - Exact execution ID match
- - `minDurationMs` - Minimum execution duration in milliseconds
- - `maxDurationMs` - Maximum execution duration in milliseconds
- - `minCost` - Minimum execution cost
- - `maxCost` - Maximum execution cost
+ - `executionId` - Exact run ID match
+ - `minDurationMs` - Minimum run duration in milliseconds
+ - `maxDurationMs` - Maximum run duration in milliseconds
+ - `minCost` - Minimum run cost
+ - `maxCost` - Maximum run cost
- `model` - Filter by AI model used
**Pagination:**
@@ -213,9 +213,9 @@ Retrieve detailed information about a specific log entry.
-### Get Execution Details
+### Get Run Details
-Retrieve execution details including the workflow state snapshot.
+Retrieve run details including the workflow state snapshot.
@@ -248,7 +248,7 @@ Retrieve execution details including the workflow state snapshot.
## Notifications
-Get real-time notifications when workflow executions complete via webhook, email, or Slack. Notifications are configured at the workspace level from the Logs page.
+Get real-time notifications when workflow runs complete via webhook, email, or Slack. Notifications are configured at the workspace level from the Logs page.
### Configuration
@@ -256,7 +256,7 @@ Configure notifications from the Logs page by clicking the menu button and selec
**Notification Channels:**
- **Webhook**: Send HTTP POST requests to your endpoint
-- **Email**: Receive email notifications with execution details
+- **Email**: Receive email notifications with run details
- **Slack**: Post messages to a Slack channel
**Workflow Selection:**
@@ -269,38 +269,38 @@ Configure notifications from the Logs page by clicking the menu button and selec
**Optional Data:**
- `includeFinalOutput`: Include the workflow's final output
-- `includeTraceSpans`: Include detailed execution trace spans
+- `includeTraceSpans`: Include detailed trace spans
- `includeRateLimits`: Include rate limit information (sync/async limits and remaining)
- `includeUsageData`: Include billing period usage and limits
### Alert Rules
-Instead of receiving notifications for every execution, configure alert rules to be notified only when issues are detected:
+Instead of receiving notifications for every run, configure alert rules to be notified only when issues are detected:
**Consecutive Failures**
-- Alert after X consecutive failed executions (e.g., 3 failures in a row)
-- Resets when an execution succeeds
+- Alert after X consecutive failed runs (e.g., 3 failures in a row)
+- Resets when a run succeeds
**Failure Rate**
- Alert when failure rate exceeds X% over the last Y hours
-- Requires minimum 5 executions in the window
+- Requires minimum 5 runs in the window
- Only triggers after the full time window has elapsed
**Latency Threshold**
-- Alert when any execution takes longer than X seconds
+- Alert when any run takes longer than X seconds
- Useful for catching slow or hanging workflows
**Latency Spike**
-- Alert when execution is X% slower than the average
+- Alert when a run is X% slower than the average
- Compares against the average duration over the configured time window
-- Requires minimum 5 executions to establish baseline
+- Requires minimum 5 runs to establish baseline
**Cost Threshold**
-- Alert when a single execution costs more than $X
+- Alert when a single run costs more than $X
- Useful for catching expensive LLM calls
**No Activity**
-- Alert when no executions occur within X hours
+- Alert when no runs occur within X hours
- Useful for monitoring scheduled workflows that should run regularly
**Error Count**
@@ -317,7 +317,7 @@ For webhooks, additional options are available:
### Payload Structure
-When a workflow execution completes, Sim sends the following payload (via webhook POST, email, or Slack):
+When a workflow run completes, Sim sends the following payload (via webhook POST, email, or Slack):
```json
{
@@ -456,7 +456,7 @@ Failed webhook deliveries are retried with exponential backoff and jitter:
- Deliveries timeout after 30 seconds
- Webhook deliveries are processed asynchronously and don't affect workflow execution performance.
+ Webhook deliveries are processed asynchronously and don't affect workflow run performance.
## Best Practices
@@ -596,11 +596,11 @@ app.listen(3000, () => {
import { FAQ } from '@/components/ui/faq'
Sim Keys in the platform. Workflows with public API access enabled can also be called without authentication." },
{ question: "How does the webhook retry policy work?", answer: "Failed webhook deliveries are retried up to 5 times with exponential backoff: 5 seconds, 15 seconds, 1 minute, 3 minutes, and 10 minutes, plus up to 10% jitter. Only HTTP 5xx and 429 responses trigger retries. Each delivery times out after 30 seconds." },
- { question: "What rate limits apply to the Logs API?", answer: "Rate limits use a token bucket algorithm. Free plans get 30 requests/minute with 60 burst capacity, Pro gets 100/200, Team gets 200/400, and Enterprise gets 500/1000. These are separate from workflow execution rate limits, which are shown in the response body." },
+ { question: "What rate limits apply to the Logs API?", answer: "Rate limits use a token bucket algorithm. Free plans get 30 requests/minute with 60 burst capacity, Pro gets 100/200, Team gets 200/400, and Enterprise gets 500/1000. These are separate from workflow run rate limits, which are shown in the response body." },
{ question: "How do I verify that a webhook is from Sim?", answer: "Configure a webhook secret when setting up notifications. Sim signs each delivery with HMAC-SHA256 using the format 't={timestamp},v1={signature}' in the sim-signature header. Compute the HMAC of '{timestamp}.{body}' with your secret and compare it to the signature value." },
{ question: "What alert rules are available for notifications?", answer: "You can configure alerts for consecutive failures, failure rate thresholds, latency thresholds, latency spikes (percentage above average), cost thresholds, no-activity periods, and error counts within a time window. All alert types include a 1-hour cooldown to prevent notification spam." },
- { question: "Can I filter which executions trigger notifications?", answer: "Yes. You can filter notifications by specific workflows (or select all), log level (info or error), and trigger type (api, webhook, schedule, manual, chat). You can also choose whether to include final output, trace spans, rate limits, and usage data in the notification payload." },
+ { question: "Can I filter which runs trigger notifications?", answer: "Yes. You can filter notifications by specific workflows (or select all), log level (info or error), and trigger type (api, webhook, schedule, manual, chat). You can also choose whether to include final output, trace spans, rate limits, and usage data in the notification payload." },
]} />
diff --git a/apps/docs/content/docs/en/execution/basics.mdx b/apps/docs/content/docs/en/execution/basics.mdx
index 1777b7fdcf..60dc79cbd3 100644
--- a/apps/docs/content/docs/en/execution/basics.mdx
+++ b/apps/docs/content/docs/en/execution/basics.mdx
@@ -6,7 +6,7 @@ import { Callout } from 'fumadocs-ui/components/callout'
import { Card, Cards } from 'fumadocs-ui/components/card'
import { Image } from '@/components/ui/image'
-Understanding how workflows execute in Sim is key to building efficient and reliable automations. The execution engine automatically handles dependencies, concurrency, and data flow to ensure your workflows run smoothly and predictably.
+Understanding how workflows run in Sim is key to building efficient and reliable automations. The execution engine automatically handles dependencies, concurrency, and data flow to ensure your workflows run smoothly and predictably.
## How Workflows Execute
@@ -14,7 +14,7 @@ Sim's execution engine processes workflows intelligently by analyzing dependenci
### Concurrent Execution by Default
-Multiple blocks run concurrently when they don't depend on each other. This parallel execution dramatically improves performance without requiring manual configuration.
+Multiple blocks run concurrently when they don't depend on each other. This dramatically improves performance without requiring manual configuration.
-This workflow demonstrates how execution can follow different paths based on conditions or AI decisions, with each path executing independently.
+This workflow demonstrates how a run can follow different paths based on conditions or AI decisions, with each path running independently.
## Block Types
@@ -57,7 +57,7 @@ Sim provides different types of blocks that serve specific purposes in your work
- **Starter blocks** initiate workflows and **Webhook blocks** respond to external events. Every workflow needs a trigger to begin execution.
+ **Starter blocks** initiate workflows and **Webhook blocks** respond to external events. Every workflow needs a trigger to begin a run.
@@ -73,37 +73,37 @@ Sim provides different types of blocks that serve specific purposes in your work
-All blocks execute automatically based on their dependencies - you don't need to manually manage execution order or timing.
+All blocks run automatically based on their dependencies - you don't need to manually manage run order or timing.
-## Execution Monitoring
+## Run Monitoring
-When workflows run, Sim provides real-time visibility into the execution process:
+When workflows run, Sim provides real-time visibility into the process:
-- **Live Block States**: See which blocks are currently executing, completed, or failed
-- **Execution Logs**: Detailed logs appear in real-time showing inputs, outputs, and any errors
-- **Performance Metrics**: Track execution time and costs for each block
-- **Path Visualization**: Understand which execution paths were taken through your workflow
+- **Live Block States**: See which blocks are currently running, completed, or failed
+- **Run Logs**: Detailed logs appear in real-time showing inputs, outputs, and any errors
+- **Performance Metrics**: Track run time and costs for each block
+- **Path Visualization**: Understand which paths were taken through your workflow
- All execution details are captured and available for review even after workflows complete, helping with debugging and optimization.
+ All run details are captured and available for review even after workflows complete, helping with debugging and optimization.
-## Key Execution Principles
+## Key Principles
Understanding these core principles will help you build better workflows:
1. **Dependency-Based Execution**: Blocks only run when all their dependencies have completed
2. **Automatic Parallelization**: Independent blocks run concurrently without configuration
3. **Smart Data Flow**: Outputs flow automatically to connected blocks
-4. **Error Handling**: Failed blocks stop their execution path but don't affect independent paths
-5. **Response Blocks as Exit Points**: When a Response block executes, the entire workflow stops and the API response is sent immediately. Multiple Response blocks can exist on different branches — the first one to execute wins
-6. **State Persistence**: All block outputs and execution details are preserved for debugging
-7. **Cycle Protection**: Workflows that call other workflows (via Workflow blocks, MCP tools, or API blocks) are tracked with a call chain. If the chain exceeds 25 hops, execution is stopped to prevent infinite loops
+4. **Error Handling**: Failed blocks stop their run path but don't affect independent paths
+5. **Response Blocks as Exit Points**: When a Response block runs, the entire workflow stops and the API response is sent immediately. Multiple Response blocks can exist on different branches — the first one to run wins
+6. **State Persistence**: All block outputs and run details are preserved for debugging
+7. **Cycle Protection**: Workflows that call other workflows (via Workflow blocks, MCP tools, or API blocks) are tracked with a call chain. If the chain exceeds 25 hops, the run is stopped to prevent infinite loops
## Next Steps
Now that you understand execution basics, explore:
- **[Block Types](/blocks)** - Learn about specific block capabilities
-- **[Logging](/execution/logging)** - Monitor workflow executions and debug issues
+- **[Logging](/execution/logging)** - Monitor workflow runs and debug issues
- **[Cost Calculation](/execution/costs)** - Understand and optimize workflow costs
- **[Triggers](/triggers)** - Set up different ways to run your workflows
diff --git a/apps/docs/content/docs/en/execution/costs.mdx b/apps/docs/content/docs/en/execution/costs.mdx
index 13b23f4ce7..a2391a0b83 100644
--- a/apps/docs/content/docs/en/execution/costs.mdx
+++ b/apps/docs/content/docs/en/execution/costs.mdx
@@ -6,7 +6,7 @@ import { Callout } from 'fumadocs-ui/components/callout'
import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
import { Image } from '@/components/ui/image'
-Sim automatically calculates costs for all workflow executions, providing transparent pricing based on AI model usage and execution charges. Understanding these costs helps you optimize workflows and manage your budget effectively.
+Sim automatically calculates costs for all workflow runs, providing transparent pricing based on AI model usage and run charges. Understanding these costs helps you optimize workflows and manage your budget effectively.
## Credits
@@ -16,18 +16,18 @@ All plan limits, usage meters, and billing thresholds are displayed in credits t
## How Costs Are Calculated
-Every workflow execution includes two cost components:
+Every workflow run includes two cost components:
-**Base Execution Charge**: 1 credit ($0.005) per execution
+**Base Run Charge**: 1 credit ($0.005) per run
**AI Model Usage**: Variable cost based on token consumption
```javascript
modelCost = (inputTokens × inputPrice + outputTokens × outputPrice) / 1,000,000
-totalCredits = baseExecutionCharge + modelCost × 200
+totalCredits = baseRunCharge + modelCost × 200
```
- AI model prices are per million tokens. The calculation divides by 1,000,000 to get the actual cost. Workflows without AI blocks only incur the base execution charge.
+ AI model prices are per million tokens. The calculation divides by 1,000,000 to get the actual cost. Workflows without AI blocks only incur the base run charge.
## Model Breakdown in Logs
@@ -48,7 +48,7 @@ The model breakdown shows:
- **Token Usage**: Input and output token counts for each model
- **Cost Breakdown**: Individual costs per model and operation
- **Model Distribution**: Which models were used and how many times
-- **Total Cost**: Aggregate cost for the entire workflow execution
+- **Total Cost**: Aggregate cost for the entire workflow run
## Pricing Options
@@ -330,18 +330,18 @@ Max (individual) shares the same rate limits as team plans. Team plans (Pro or M
Team plans (Pro or Max for Teams) use 500 GB.
-### Execution Time Limits
+### Run Time Limits
| Plan | Sync | Async |
|------|------|-------|
| **Free** | 5 minutes | 90 minutes |
| **Pro / Max / Team / Enterprise** | 50 minutes | 90 minutes |
-**Sync executions** run immediately and return results directly. These are triggered via the API with `async: false` (default) or through the UI.
-**Async executions** (triggered via API with `async: true`, webhooks, or schedules) run in the background.
+**Sync runs** complete immediately and return results directly. These are triggered via the API with `async: false` (default) or through the UI.
+**Async runs** (triggered via API with `async: true`, webhooks, or schedules) run in the background.
- If a workflow exceeds its time limit, it will be terminated and marked as failed with a timeout error. Design long-running workflows to use async execution or break them into smaller workflows.
+ If a workflow exceeds its time limit, it will be terminated and marked as failed with a timeout error. Design long-running workflows to use async runs or break them into smaller workflows.
## Billing Model
@@ -452,18 +452,18 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
## Next Steps
- Review your current usage in [Settings → Subscription](https://sim.ai/settings/subscription)
-- Learn about [Logging](/execution/logging) to track execution details
+- Learn about [Logging](/execution/logging) to track run details
- Explore the [External API](/execution/api) for programmatic cost monitoring
- Check out [workflow optimization techniques](/blocks) to reduce costs
import { FAQ } from '@/components/ui/faq'
diff --git a/apps/docs/content/docs/en/execution/files.mdx b/apps/docs/content/docs/en/execution/files.mdx
index 4a7093c9b4..41c04692c4 100644
--- a/apps/docs/content/docs/en/execution/files.mdx
+++ b/apps/docs/content/docs/en/execution/files.mdx
@@ -156,7 +156,7 @@ Use `url` for direct downloads or `base64` for inline processing.
- **Dropbox** - Dropbox file operations
- Files are automatically available to downstream blocks. The execution engine handles all file transfer and format conversion.
+ Files are automatically available to downstream blocks. The engine handles all file transfer and format conversion.
## Best Practices
@@ -165,15 +165,15 @@ Use `url` for direct downloads or `base64` for inline processing.
2. **Check file types** - Ensure the file type matches what the receiving block expects. The Vision block needs images, the File block handles documents.
-3. **Consider file size** - Large files increase execution time. For very large files, consider using storage blocks (S3, Supabase) for intermediate storage.
+3. **Consider file size** - Large files increase run time. For very large files, consider using storage blocks (S3, Supabase) for intermediate storage.
import { FAQ } from '@/components/ui/faq'
) and the receiving block will extract the data it needs." },
- { question: "How do file fields work in the Start block's input format?", answer: "When you define a field with type 'file[]' in the Start block's input format, the execution engine automatically processes incoming file data (base64 or URL) and uploads it to storage, converting it into UserFile objects before the workflow runs." },
+ { question: "How do file fields work in the Start block's input format?", answer: "When you define a field with type 'file[]' in the Start block's input format, the engine automatically processes incoming file data (base64 or URL) and uploads it to storage, converting it into UserFile objects before the workflow runs." },
]} />
diff --git a/apps/docs/content/docs/en/execution/index.mdx b/apps/docs/content/docs/en/execution/index.mdx
index cc80425ecf..7b67747313 100644
--- a/apps/docs/content/docs/en/execution/index.mdx
+++ b/apps/docs/content/docs/en/execution/index.mdx
@@ -7,10 +7,10 @@ import { Card, Cards } from 'fumadocs-ui/components/card'
import { Image } from '@/components/ui/image'
import { FAQ } from '@/components/ui/faq'
-Sim's execution engine brings your workflows to life by processing blocks in the correct order, managing data flow, and handling errors gracefully, so you can understand exactly how workflows are executed in Sim.
+Sim's execution engine brings your workflows to life by processing blocks in the correct order, managing data flow, and handling errors gracefully, so you can understand exactly how workflows run in Sim.
- Every workflow execution follows a deterministic path based on your block connections and logic, ensuring predictable and reliable results.
+ Every workflow run follows a deterministic path based on your block connections and logic, ensuring predictable and reliable results.
## Documentation Overview
@@ -22,33 +22,33 @@ Sim's execution engine brings your workflows to life by processing blocks in the
- Monitor workflow executions with comprehensive logging and real-time visibility
+ Monitor workflow runs with comprehensive logging and real-time visibility
-
+
- Understand how workflow execution costs are calculated and optimized
+ Understand how workflow run costs are calculated and optimized
-
+
- Access execution logs and set up webhooks programmatically via REST API
+ Access run logs and set up webhooks programmatically via REST API
## Key Concepts
### Topological Execution
-Blocks execute in dependency order, similar to how a spreadsheet recalculates cells. The execution engine automatically determines which blocks can run based on completed dependencies.
+Blocks run in dependency order, similar to how a spreadsheet recalculates cells. The execution engine automatically determines which blocks can run based on completed dependencies.
### Path Tracking
-The engine actively tracks execution paths through your workflow. Router and Condition blocks dynamically update these paths, ensuring only relevant blocks execute.
+The engine actively tracks run paths through your workflow. Router and Condition blocks dynamically update these paths, ensuring only relevant blocks run.
### Layer-Based Processing
Instead of executing blocks one-by-one, the engine identifies layers of blocks that can run in parallel, optimizing performance for complex workflows.
-### Execution Context
-Each workflow maintains a rich context during execution containing:
+### Run Context
+Each workflow maintains a rich context during a run containing:
- Block outputs and states
-- Active execution paths
+- Active run paths
- Loop and parallel iteration tracking
- Environment variables
- Routing decisions
@@ -56,7 +56,7 @@ Each workflow maintains a rich context during execution containing:
## Deployment Snapshots
-API, Chat, Schedule, and Webhook executions run against the workflow’s active deployment snapshot. Manual runs from the editor execute the current draft canvas state, letting you test changes before deploying. Publish a new deployment whenever you change the canvas so every trigger uses the updated version.
+API, Chat, Schedule, and Webhook runs use the workflow’s active deployment snapshot. Manual runs from the editor use the current draft canvas state, letting you test changes before deploying. Publish a new deployment whenever you change the canvas so every trigger uses the updated version.
diff --git a/apps/docs/content/docs/en/execution/logging.mdx b/apps/docs/content/docs/en/execution/logging.mdx
index 12376de01a..dbbf50a383 100644
--- a/apps/docs/content/docs/en/execution/logging.mdx
+++ b/apps/docs/content/docs/en/execution/logging.mdx
@@ -6,7 +6,7 @@ import { Callout } from 'fumadocs-ui/components/callout'
import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
import { Image } from '@/components/ui/image'
-Sim provides comprehensive logging for all workflow executions, giving you complete visibility into how your workflows run, what data flows through them, and where issues might occur.
+Sim provides comprehensive logging for all workflow runs, giving you complete visibility into how your workflows run, what data flows through them, and where issues might occur.
## Logging System
@@ -14,7 +14,7 @@ Sim offers two complementary logging interfaces to match different workflows and
### Real-Time Console
-During manual or chat workflow execution, logs appear in real-time in the Console panel on the right side of the workflow editor:
+During manual or chat workflow runs, logs appear in real-time in the Console panel on the right side of the workflow editor:
The console shows:
-- Block execution progress with active block highlighting
+- Block progress with active block highlighting
- Real-time outputs as blocks complete
-- Execution timing for each block
+- Timing for each block
- Success/error status indicators
### Logs Page
-All workflow executions—whether triggered manually, via API, Chat, Schedule, or Webhook—are logged to the dedicated Logs page:
+All workflow runs—whether triggered manually, via API, Chat, Schedule, or Webhook—are logged to the dedicated Logs page:
- **Output Tab** shows the block's execution result:
+ **Output Tab** shows the block's result:
- Structured data with JSON formatting
- Markdown rendering for AI-generated content
- Copy button for easy data extraction
@@ -87,17 +87,17 @@ View the complete data flow for each block with tabs to switch between:
-### Execution Timeline
+### Run Timeline
-For workflow-level logs, view detailed execution metrics:
+For workflow-level logs, view detailed run metrics:
- Start and end timestamps
- Total workflow duration
-- Individual block execution times
+- Individual block run times
- Performance bottleneck identification
## Workflow Snapshots
-For any logged execution, click "View Snapshot" to see the exact workflow state at execution time:
+For any logged run, click "View Snapshot" to see the exact workflow state at the time of the run:
- Workflow snapshots are only available for executions after the enhanced logging system was introduced. Older migrated logs show a "Logged State Not Found" message.
+ Workflow snapshots are only available for runs after the enhanced logging system was introduced. Older migrated logs show a "Logged State Not Found" message.
## Log Retention
@@ -134,11 +134,11 @@ The snapshot provides:
### For Production
- Monitor the Logs page regularly for errors or performance issues
- Set up filters to focus on specific workflows or time periods
-- Use live mode during critical deployments to watch executions in real-time
+- Use live mode during critical deployments to watch runs in real-time
### For Debugging
-- Always check the execution timeline to identify slow blocks
-- Compare inputs between working and failing executions
+- Always check the run timeline to identify slow blocks
+- Compare inputs between working and failing runs
- Use workflow snapshots to see the exact state when issues occurred
## Next Steps
@@ -150,10 +150,10 @@ The snapshot provides:
import { FAQ } from '@/components/ui/faq'
\ No newline at end of file
diff --git a/apps/docs/content/docs/en/tools/jira.mdx b/apps/docs/content/docs/en/tools/jira.mdx
index db433a3d4d..17742deeda 100644
--- a/apps/docs/content/docs/en/tools/jira.mdx
+++ b/apps/docs/content/docs/en/tools/jira.mdx
@@ -251,7 +251,7 @@ Update a Jira issue
| `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
| `issueKey` | string | Yes | Jira issue key to update \(e.g., PROJ-123\) |
| `summary` | string | No | New summary for the issue |
-| `description` | string | No | New description for the issue |
+| `description` | string | No | New description for the issue. Accepts plain text \(auto-wrapped in ADF\) or a raw ADF document object |
| `priority` | string | No | New priority ID or name for the issue \(e.g., "High"\) |
| `assignee` | string | No | New assignee account ID for the issue |
| `labels` | json | No | Labels to set on the issue \(array of label name strings\) |
@@ -284,7 +284,7 @@ Create a new Jira issue
| `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
| `projectId` | string | Yes | Jira project key \(e.g., PROJ\) |
| `summary` | string | Yes | Summary for the issue |
-| `description` | string | No | Description for the issue |
+| `description` | string | No | Description for the issue. Accepts plain text \(auto-wrapped in ADF\) or a raw ADF document object |
| `priority` | string | No | Priority ID or name for the issue \(e.g., "10000" or "High"\) |
| `assignee` | string | No | Assignee account ID for the issue |
| `cloudId` | string | No | Jira Cloud ID for the instance. If not provided, it will be fetched using the domain. |
diff --git a/apps/docs/content/docs/en/tools/microsoft_excel.mdx b/apps/docs/content/docs/en/tools/microsoft_excel.mdx
index 4da61a5b9c..08733e5eb3 100644
--- a/apps/docs/content/docs/en/tools/microsoft_excel.mdx
+++ b/apps/docs/content/docs/en/tools/microsoft_excel.mdx
@@ -45,6 +45,7 @@ Read data from a specific sheet in a Microsoft Excel spreadsheet
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Yes | The ID of the spreadsheet/workbook to read from \(e.g., "01ABC123DEF456"\) |
+| `driveId` | string | No | The ID of the drive containing the spreadsheet. Required for SharePoint files. If omitted, uses personal OneDrive. |
| `range` | string | No | The range of cells to read from. Accepts "SheetName!A1:B2" for explicit ranges or just "SheetName" to read the used range of that sheet. If omitted, reads the used range of the first sheet. |
#### Output
@@ -67,6 +68,7 @@ Write data to a specific sheet in a Microsoft Excel spreadsheet
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Yes | The ID of the spreadsheet/workbook to write to \(e.g., "01ABC123DEF456"\) |
+| `driveId` | string | No | The ID of the drive containing the spreadsheet. Required for SharePoint files. If omitted, uses personal OneDrive. |
| `range` | string | No | The range of cells to write to \(e.g., "Sheet1!A1:B2"\) |
| `values` | array | Yes | The data to write as a 2D array \(e.g., \[\["Name", "Age"\], \["Alice", 30\]\]\) or array of objects |
| `valueInputOption` | string | No | The format of the data to write |
diff --git a/apps/docs/content/docs/en/triggers/index.mdx b/apps/docs/content/docs/en/triggers/index.mdx
index 29279243cf..9936968505 100644
--- a/apps/docs/content/docs/en/triggers/index.mdx
+++ b/apps/docs/content/docs/en/triggers/index.mdx
@@ -29,7 +29,7 @@ Use the Start block for everything originating from the editor, deploy-to-API, o
Receive external webhook payloads
- Cron or interval based execution
+ Cron or interval based runs
Monitor RSS and Atom feeds for new content
@@ -59,17 +59,17 @@ Use the Start block for everything originating from the editor, deploy-to-API, o
> Deployments power every trigger. Update the workflow, redeploy, and all trigger entry points pick up the new snapshot. Learn more in [Execution → Deployment Snapshots](/execution).
-## Manual Execution Priority
+## Manual Run Priority
-When you click **Run** in the editor, Sim automatically selects which trigger to execute based on the following priority order:
+When you click **Run** in the editor, Sim automatically selects which trigger to run based on the following priority order:
1. **Start Block** (highest priority)
2. **Schedule Triggers**
3. **External Triggers** (webhooks, integrations like Slack, Gmail, Airtable, etc.)
-If your workflow has multiple triggers, the highest priority trigger will be executed. For example, if you have both a Start block and a Webhook trigger, clicking Run will execute the Start block.
+If your workflow has multiple triggers, the highest priority trigger will be used. For example, if you have both a Start block and a Webhook trigger, clicking Run will use the Start block.
-**External triggers with mock payloads**: When external triggers (webhooks and integrations) are executed manually, Sim automatically generates mock payloads based on the trigger's expected data structure. This ensures downstream blocks can resolve variables correctly during testing.
+**External triggers with mock payloads**: When external triggers (webhooks and integrations) are run manually, Sim automatically generates mock payloads based on the trigger's expected data structure. This ensures downstream blocks can resolve variables correctly during testing.
## Email Polling Groups
@@ -94,10 +94,10 @@ Invitees receive an email with a link to connect their account. Once connected,
When configuring an email trigger, select your polling group from the credentials dropdown instead of an individual account. The system creates webhooks for each member and routes all emails through your workflow.
diff --git a/apps/docs/content/docs/en/triggers/rss.mdx b/apps/docs/content/docs/en/triggers/rss.mdx
index 3f15c384d7..93f86d3587 100644
--- a/apps/docs/content/docs/en/triggers/rss.mdx
+++ b/apps/docs/content/docs/en/triggers/rss.mdx
@@ -51,9 +51,9 @@ RSS triggers only fire for items published after you save the trigger. Existing
diff --git a/apps/docs/content/docs/en/triggers/schedule.mdx b/apps/docs/content/docs/en/triggers/schedule.mdx
index 2bd193191c..8c59882ceb 100644
--- a/apps/docs/content/docs/en/triggers/schedule.mdx
+++ b/apps/docs/content/docs/en/triggers/schedule.mdx
@@ -79,10 +79,10 @@ Schedule blocks cannot receive incoming connections and serve as workflow entry
diff --git a/apps/docs/content/docs/en/triggers/start.mdx b/apps/docs/content/docs/en/triggers/start.mdx
index 8997372e8e..672da65024 100644
--- a/apps/docs/content/docs/en/triggers/start.mdx
+++ b/apps/docs/content/docs/en/triggers/start.mdx
@@ -19,12 +19,12 @@ The Start block is the default trigger for workflows built in Sim. It collects s
-The Start block sits in the start slot when you create a workflow. Keep it there when you want the same entry point to serve editor runs, deploy-to-API requests, and chat sessions. Swap it with Webhook or Schedule triggers when you only need event-driven execution.
+The Start block sits in the start slot when you create a workflow. Keep it there when you want the same entry point to serve editor runs, deploy-to-API requests, and chat sessions. Swap it with Webhook or Schedule triggers when you only need event-driven runs.
## Fields exposed by Start
-The Start block emits different data depending on the execution surface:
+The Start block emits different data depending on the run surface:
- **Input Format fields** — Every field you add becomes available as <start.fieldName>. For example, a `customerId` field shows up as <start.customerId> in downstream blocks and templates.
- **Chat-only fields** — When the workflow runs from the chat side panel or a deployed chat experience, Sim also provides <start.input> (latest user message), <start.conversationId> (active session id), and <start.files> (chat attachments).
@@ -33,11 +33,11 @@ Keep Input Format fields scoped to the names you expect to reference later—tho
## Configure the Input Format
-Use the Input Format sub-block to define the schema that applies across execution modes:
+Use the Input Format sub-block to define the schema that applies across run modes:
1. Add a field for each value you want to collect.
2. Choose a type (`string`, `number`, `boolean`, `object`, `array`, or `files`). File fields accept uploads from chat and API callers.
-3. Provide default values when you want the manual run modal to populate test data automatically. These defaults are ignored for deployed executions.
+3. Provide default values when you want the manual run modal to populate test data automatically. These defaults are ignored for deployed runs.
4. Reorder fields to control how they appear in the editor form.
Reference structured values downstream with expressions such as <start.customerId> depending on the block you connect.
@@ -53,7 +53,7 @@ Reference structured values downstream with expressions such as <start.
tools or storage steps.
- Deploying to API turns the Input Format into a JSON contract for clients. Each field becomes part of the request body, and Sim coerces primitive types on ingestion. File fields expect objects that reference uploaded files; use the execution file upload endpoint before invoking the workflow.
+ Deploying to API turns the Input Format into a JSON contract for clients. Each field becomes part of the request body, and Sim coerces primitive types on ingestion. File fields expect objects that reference uploaded files; use the file upload endpoint before invoking the workflow.
API callers can include additional optional properties. They are preserved
inside <start.fieldName> outputs so you can experiment
diff --git a/apps/docs/content/docs/en/triggers/webhook.mdx b/apps/docs/content/docs/en/triggers/webhook.mdx
index d897db7681..33d3a6dd95 100644
--- a/apps/docs/content/docs/en/triggers/webhook.mdx
+++ b/apps/docs/content/docs/en/triggers/webhook.mdx
@@ -8,7 +8,7 @@ import { Image } from '@/components/ui/image'
import { Video } from '@/components/ui/video'
import { FAQ } from '@/components/ui/faq'
-Webhooks allow external services to trigger workflow execution by sending HTTP requests to your workflow. Sim supports two approaches for webhook-based triggers.
+Webhooks allow external services to trigger workflow runs by sending HTTP requests to your workflow. Sim supports two approaches for webhook-based triggers.
## Generic Webhook Trigger
@@ -30,7 +30,7 @@ The Generic Webhook block creates a flexible endpoint that can receive any paylo
2. **Configure Payload** - Set up the expected payload structure (optional)
3. **Get Webhook URL** - Copy the automatically generated unique endpoint
4. **External Integration** - Configure your external service to send POST requests to this URL
-5. **Workflow Execution** - Every request to the webhook URL triggers the workflow
+5. **Workflow Run** - Every request to the webhook URL triggers the workflow
### Features
@@ -38,7 +38,7 @@ The Generic Webhook block creates a flexible endpoint that can receive any paylo
- **Automatic Parsing**: Webhook data is automatically parsed and available to subsequent blocks
- **Authentication**: Optional bearer token or custom header authentication
- **Rate Limiting**: Built-in protection against abuse
-- **Deduplication**: Prevents duplicate executions from repeated requests
+- **Deduplication**: Prevents duplicate runs from repeated requests
The Generic Webhook trigger fires every time the webhook URL receives a request, making it perfect for real-time integrations.
@@ -58,7 +58,7 @@ Alternatively, you can use specific service blocks (like Slack, GitHub, etc.) in
2. **Enable Trigger Mode** - Toggle "Use as Trigger" in the block settings
3. **Configure Service** - Set up authentication and event filters specific to that service
4. **Webhook Registration** - The service automatically registers the webhook with the external platform
-5. **Event-Based Execution** - Workflow triggers only for specific events from that service
+5. **Event-Based Runs** - Workflow triggers only for specific events from that service
### When to Use Each Approach
@@ -120,7 +120,7 @@ Alternatively, you can use specific service blocks (like Slack, GitHub, etc.) in
### Testing Webhooks
1. Use tools like Postman or curl to test your webhook endpoints
-2. Check workflow execution logs for debugging
+2. Check workflow run logs for debugging
3. Verify payload structure matches your expectations
4. Test authentication and error scenarios
@@ -153,8 +153,8 @@ Always validate and sanitize incoming webhook data before processing it in your
{ question: "What HTTP methods does the Generic Webhook endpoint accept?", answer: "The webhook endpoint handles POST requests for triggering workflows. GET requests are only used for provider-specific verification challenges (such as Microsoft Graph or WhatsApp verification). Other methods return a 405 Method Not Allowed response." },
{ question: "How do I authenticate webhook requests?", answer: "Enable the Require Authentication toggle in the webhook configuration, then set an Authentication Token. Callers can send the token as a Bearer token in the Authorization header, or you can specify a custom header name (e.g., X-Secret-Key) and the token will be matched against that header instead." },
{ question: "Can I define the expected payload structure for a webhook?", answer: "Yes. The Generic Webhook block includes an Input Format field where you can define the expected JSON schema. This is optional but helps document the expected structure. You can also use type \"file[]\" for file upload fields." },
- { question: "Does the webhook have deduplication built in?", answer: "Yes. The webhook processing pipeline includes idempotency checks to prevent duplicate executions from repeated requests with the same payload." },
+ { question: "Does the webhook have deduplication built in?", answer: "Yes. The webhook processing pipeline includes idempotency checks to prevent duplicate runs from repeated requests with the same payload." },
{ question: "What data from the webhook request is available in my workflow?", answer: "All request data including headers, body, and query parameters is parsed and made available to subsequent blocks. Common fields like event, id, and data are automatically extracted from the payload when present." },
- { question: "Do I need to deploy my workflow for the webhook URL to work?", answer: "Yes. The webhook endpoint checks that the associated workflow is deployed before triggering execution. If the workflow is not deployed, the webhook returns a not-found response." },
- { question: "Does the webhook auto-disable after repeated failures?", answer: "No. Unlike polling-based triggers (RSS, Gmail, IMAP), push-based generic webhooks do not auto-disable after consecutive failures. Each incoming request is processed independently. If your workflow consistently fails, check the execution logs for error details." },
+ { question: "Do I need to deploy my workflow for the webhook URL to work?", answer: "Yes. The webhook endpoint checks that the associated workflow is deployed before triggering a run. If the workflow is not deployed, the webhook returns a not-found response." },
+ { question: "Does the webhook auto-disable after repeated failures?", answer: "No. Unlike polling-based triggers (RSS, Gmail, IMAP), push-based generic webhooks do not auto-disable after consecutive failures. Each incoming request is processed independently. If your workflow consistently fails, check the run logs for error details." },
]} />
diff --git a/apps/sim/app/(landing)/blog/authors/[id]/page.tsx b/apps/sim/app/(landing)/blog/authors/[id]/page.tsx
index 3362e3ee91..bbbc8a5591 100644
--- a/apps/sim/app/(landing)/blog/authors/[id]/page.tsx
+++ b/apps/sim/app/(landing)/blog/authors/[id]/page.tsx
@@ -2,6 +2,7 @@ import type { Metadata } from 'next'
import Image from 'next/image'
import Link from 'next/link'
import { getAllPostMeta } from '@/lib/blog/registry'
+import { SITE_URL } from '@/lib/core/utils/urls'
export const revalidate = 3600
@@ -17,11 +18,11 @@ export async function generateMetadata({
return {
title: `${name} — Sim Blog`,
description: `Read articles by ${name} on the Sim blog.`,
- alternates: { canonical: `https://sim.ai/blog/authors/${id}` },
+ alternates: { canonical: `${SITE_URL}/blog/authors/${id}` },
openGraph: {
title: `${name} — Sim Blog`,
description: `Read articles by ${name} on the Sim blog.`,
- url: `https://sim.ai/blog/authors/${id}`,
+ url: `${SITE_URL}/blog/authors/${id}`,
siteName: 'Sim',
type: 'profile',
...(author?.avatarUrl
@@ -55,25 +56,25 @@ export default async function AuthorPage({ params }: { params: Promise<{ id: str
{
'@type': 'Person',
name: author.name,
- url: `https://sim.ai/blog/authors/${author.id}`,
+ url: `${SITE_URL}/blog/authors/${author.id}`,
sameAs: author.url ? [author.url] : [],
image: author.avatarUrl,
worksFor: {
'@type': 'Organization',
name: 'Sim',
- url: 'https://sim.ai',
+ url: SITE_URL,
},
},
{
'@type': 'BreadcrumbList',
itemListElement: [
- { '@type': 'ListItem', position: 1, name: 'Home', item: 'https://sim.ai' },
- { '@type': 'ListItem', position: 2, name: 'Blog', item: 'https://sim.ai/blog' },
+ { '@type': 'ListItem', position: 1, name: 'Home', item: SITE_URL },
+ { '@type': 'ListItem', position: 2, name: 'Blog', item: `${SITE_URL}/blog` },
{
'@type': 'ListItem',
position: 3,
name: author.name,
- item: `https://sim.ai/blog/authors/${author.id}`,
+ item: `${SITE_URL}/blog/authors/${author.id}`,
},
],
},
diff --git a/apps/sim/app/(landing)/blog/layout.tsx b/apps/sim/app/(landing)/blog/layout.tsx
index 512f41a32e..96b81a7dca 100644
--- a/apps/sim/app/(landing)/blog/layout.tsx
+++ b/apps/sim/app/(landing)/blog/layout.tsx
@@ -1,4 +1,5 @@
import { getNavBlogPosts } from '@/lib/blog/registry'
+import { SITE_URL } from '@/lib/core/utils/urls'
import Footer from '@/app/(landing)/components/footer/footer'
import Navbar from '@/app/(landing)/components/navbar/navbar'
@@ -8,10 +9,10 @@ export default async function StudioLayout({ children }: { children: React.React
'@context': 'https://schema.org',
'@type': 'Organization',
name: 'Sim',
- url: 'https://sim.ai',
+ url: SITE_URL,
description:
'Sim is the open-source AI workspace where teams build, deploy, and manage AI agents.',
- logo: 'https://sim.ai/logo/primary/small.png',
+ logo: `${SITE_URL}/logo/primary/small.png`,
sameAs: [
'https://x.com/simdotai',
'https://github.com/simstudioai/sim',
@@ -23,7 +24,7 @@ export default async function StudioLayout({ children }: { children: React.React
'@context': 'https://schema.org',
'@type': 'WebSite',
name: 'Sim',
- url: 'https://sim.ai',
+ url: SITE_URL,
}
return (
diff --git a/apps/sim/app/(landing)/blog/page.tsx b/apps/sim/app/(landing)/blog/page.tsx
index a7339cc76a..f12f73ed25 100644
--- a/apps/sim/app/(landing)/blog/page.tsx
+++ b/apps/sim/app/(landing)/blog/page.tsx
@@ -4,6 +4,7 @@ import Link from 'next/link'
import { Badge } from '@/components/emcn'
import { getAllPostMeta } from '@/lib/blog/registry'
import { buildCollectionPageJsonLd } from '@/lib/blog/seo'
+import { SITE_URL } from '@/lib/core/utils/urls'
export async function generateMetadata({
searchParams,
@@ -26,7 +27,7 @@ export async function generateMetadata({
if (tag) canonicalParams.set('tag', tag)
if (pageNum > 1) canonicalParams.set('page', String(pageNum))
const qs = canonicalParams.toString()
- const canonical = `https://sim.ai/blog${qs ? `?${qs}` : ''}`
+ const canonical = `${SITE_URL}/blog${qs ? `?${qs}` : ''}`
return {
title,
@@ -41,7 +42,7 @@ export async function generateMetadata({
type: 'website',
images: [
{
- url: 'https://sim.ai/logo/primary/medium.png',
+ url: `${SITE_URL}/logo/primary/medium.png`,
width: 1200,
height: 630,
alt: 'Sim Blog',
diff --git a/apps/sim/app/(landing)/blog/rss.xml/route.ts b/apps/sim/app/(landing)/blog/rss.xml/route.ts
index fdabfce7eb..6460e03221 100644
--- a/apps/sim/app/(landing)/blog/rss.xml/route.ts
+++ b/apps/sim/app/(landing)/blog/rss.xml/route.ts
@@ -1,12 +1,13 @@
import { NextResponse } from 'next/server'
import { getAllPostMeta } from '@/lib/blog/registry'
+import { SITE_URL } from '@/lib/core/utils/urls'
export const revalidate = 3600
export async function GET() {
const posts = await getAllPostMeta()
const items = posts.slice(0, 50)
- const site = 'https://sim.ai'
+ const site = SITE_URL
const lastBuildDate =
items.length > 0 ? new Date(items[0].date).toUTCString() : new Date().toUTCString()
diff --git a/apps/sim/app/(landing)/blog/sitemap-images.xml/route.ts b/apps/sim/app/(landing)/blog/sitemap-images.xml/route.ts
index 7fa302f299..c40833c02c 100644
--- a/apps/sim/app/(landing)/blog/sitemap-images.xml/route.ts
+++ b/apps/sim/app/(landing)/blog/sitemap-images.xml/route.ts
@@ -1,11 +1,12 @@
import { NextResponse } from 'next/server'
import { getAllPostMeta } from '@/lib/blog/registry'
+import { SITE_URL } from '@/lib/core/utils/urls'
export const revalidate = 3600
export async function GET() {
const posts = await getAllPostMeta()
- const base = 'https://sim.ai'
+ const base = SITE_URL
const xml = `
${posts
diff --git a/apps/sim/app/(landing)/blog/tags/page.tsx b/apps/sim/app/(landing)/blog/tags/page.tsx
index 1b5ccceea3..b18cff5a46 100644
--- a/apps/sim/app/(landing)/blog/tags/page.tsx
+++ b/apps/sim/app/(landing)/blog/tags/page.tsx
@@ -1,15 +1,16 @@
import type { Metadata } from 'next'
import Link from 'next/link'
import { getAllTags } from '@/lib/blog/registry'
+import { SITE_URL } from '@/lib/core/utils/urls'
export const metadata: Metadata = {
title: 'Tags',
description: 'Browse Sim blog posts by topic — AI agents, workflows, integrations, and more.',
- alternates: { canonical: 'https://sim.ai/blog/tags' },
+ alternates: { canonical: `${SITE_URL}/blog/tags` },
openGraph: {
title: 'Blog Tags | Sim',
description: 'Browse Sim blog posts by topic — AI agents, workflows, integrations, and more.',
- url: 'https://sim.ai/blog/tags',
+ url: `${SITE_URL}/blog/tags`,
siteName: 'Sim',
locale: 'en_US',
type: 'website',
@@ -26,9 +27,9 @@ const breadcrumbJsonLd = {
'@context': 'https://schema.org',
'@type': 'BreadcrumbList',
itemListElement: [
- { '@type': 'ListItem', position: 1, name: 'Home', item: 'https://sim.ai' },
- { '@type': 'ListItem', position: 2, name: 'Blog', item: 'https://sim.ai/blog' },
- { '@type': 'ListItem', position: 3, name: 'Tags', item: 'https://sim.ai/blog/tags' },
+ { '@type': 'ListItem', position: 1, name: 'Home', item: SITE_URL },
+ { '@type': 'ListItem', position: 2, name: 'Blog', item: `${SITE_URL}/blog` },
+ { '@type': 'ListItem', position: 3, name: 'Tags', item: `${SITE_URL}/blog/tags` },
],
}
diff --git a/apps/sim/app/(landing)/components/structured-data.tsx b/apps/sim/app/(landing)/components/structured-data.tsx
index b03c4fb45e..5a55b1c1c5 100644
--- a/apps/sim/app/(landing)/components/structured-data.tsx
+++ b/apps/sim/app/(landing)/components/structured-data.tsx
@@ -1,3 +1,5 @@
+import { SITE_URL } from '@/lib/core/utils/urls'
+
/**
* JSON-LD structured data for the landing page.
*
@@ -23,22 +25,22 @@ export default function StructuredData() {
'@graph': [
{
'@type': 'Organization',
- '@id': 'https://sim.ai/#organization',
+ '@id': `${SITE_URL}/#organization`,
name: 'Sim',
alternateName: 'Sim Studio',
description:
'Sim is the open-source AI workspace where teams build, deploy, and manage AI agents. Connect 1,000+ integrations and every major LLM to create agents that automate real work.',
- url: 'https://sim.ai',
+ url: SITE_URL,
logo: {
'@type': 'ImageObject',
- '@id': 'https://sim.ai/#logo',
- url: 'https://sim.ai/logo/b%26w/text/b%26w.svg',
- contentUrl: 'https://sim.ai/logo/b%26w/text/b%26w.svg',
+ '@id': `${SITE_URL}/#logo`,
+ url: `${SITE_URL}/logo/b%26w/text/b%26w.svg`,
+ contentUrl: `${SITE_URL}/logo/b%26w/text/b%26w.svg`,
width: 49.78314,
height: 24.276,
caption: 'Sim Logo',
},
- image: { '@id': 'https://sim.ai/#logo' },
+ image: { '@id': `${SITE_URL}/#logo` },
sameAs: [
'https://x.com/simdotai',
'https://github.com/simstudioai/sim',
@@ -53,44 +55,42 @@ export default function StructuredData() {
},
{
'@type': 'WebSite',
- '@id': 'https://sim.ai/#website',
- url: 'https://sim.ai',
+ '@id': `${SITE_URL}/#website`,
+ url: SITE_URL,
name: 'Sim — The AI Workspace | Build, Deploy & Manage AI Agents',
description:
'Sim is the open-source AI workspace where teams build, deploy, and manage AI agents. Connect 1,000+ integrations and every major LLM. Join 100,000+ builders.',
- publisher: { '@id': 'https://sim.ai/#organization' },
+ publisher: { '@id': `${SITE_URL}/#organization` },
inLanguage: 'en-US',
},
{
'@type': 'WebPage',
- '@id': 'https://sim.ai/#webpage',
- url: 'https://sim.ai',
+ '@id': `${SITE_URL}/#webpage`,
+ url: SITE_URL,
name: 'Sim — The AI Workspace | Build, Deploy & Manage AI Agents',
- isPartOf: { '@id': 'https://sim.ai/#website' },
- about: { '@id': 'https://sim.ai/#software' },
+ isPartOf: { '@id': `${SITE_URL}/#website` },
+ about: { '@id': `${SITE_URL}/#software` },
datePublished: '2024-01-01T00:00:00+00:00',
dateModified: new Date().toISOString(),
description:
'Sim is the open-source AI workspace where teams build, deploy, and manage AI agents. Connect 1,000+ integrations and every major LLM to create agents that automate real work.',
- breadcrumb: { '@id': 'https://sim.ai/#breadcrumb' },
+ breadcrumb: { '@id': `${SITE_URL}/#breadcrumb` },
inLanguage: 'en-US',
speakable: {
'@type': 'SpeakableSpecification',
cssSelector: ['#hero-heading', '[id="hero"] p'],
},
- potentialAction: [{ '@type': 'ReadAction', target: ['https://sim.ai'] }],
+ potentialAction: [{ '@type': 'ReadAction', target: [SITE_URL] }],
},
{
'@type': 'BreadcrumbList',
- '@id': 'https://sim.ai/#breadcrumb',
- itemListElement: [
- { '@type': 'ListItem', position: 1, name: 'Home', item: 'https://sim.ai' },
- ],
+ '@id': `${SITE_URL}/#breadcrumb`,
+ itemListElement: [{ '@type': 'ListItem', position: 1, name: 'Home', item: SITE_URL }],
},
{
'@type': 'WebApplication',
- '@id': 'https://sim.ai/#software',
- url: 'https://sim.ai',
+ '@id': `${SITE_URL}/#software`,
+ url: SITE_URL,
name: 'Sim — The AI Workspace',
description:
'Sim is the open-source AI workspace where teams build, deploy, and manage AI agents. Connect 1,000+ integrations and every major LLM to create agents that automate real work — visually, conversationally, or with code. Trusted by over 100,000 builders. SOC2 compliant.',
@@ -98,7 +98,7 @@ export default function StructuredData() {
applicationSubCategory: 'AI Workspace',
operatingSystem: 'Web',
browserRequirements: 'Requires a modern browser with JavaScript enabled',
- installUrl: 'https://sim.ai/signup',
+ installUrl: `${SITE_URL}/signup`,
offers: [
{
'@type': 'Offer',
@@ -175,16 +175,16 @@ export default function StructuredData() {
},
{
'@type': 'SoftwareSourceCode',
- '@id': 'https://sim.ai/#source',
+ '@id': `${SITE_URL}/#source`,
codeRepository: 'https://github.com/simstudioai/sim',
programmingLanguage: ['TypeScript', 'Python'],
runtimePlatform: 'Node.js',
license: 'https://opensource.org/licenses/Apache-2.0',
- isPartOf: { '@id': 'https://sim.ai/#software' },
+ isPartOf: { '@id': `${SITE_URL}/#software` },
},
{
'@type': 'FAQPage',
- '@id': 'https://sim.ai/#faq',
+ '@id': `${SITE_URL}/#faq`,
mainEntity: [
{
'@type': 'Question',
diff --git a/apps/sim/app/(landing)/integrations/[slug]/page.tsx b/apps/sim/app/(landing)/integrations/[slug]/page.tsx
index e93bf9c73f..d48ea6f405 100644
--- a/apps/sim/app/(landing)/integrations/[slug]/page.tsx
+++ b/apps/sim/app/(landing)/integrations/[slug]/page.tsx
@@ -2,7 +2,7 @@ import type { Metadata } from 'next'
import Image from 'next/image'
import Link from 'next/link'
import { notFound } from 'next/navigation'
-import { getBaseUrl } from '@/lib/core/utils/urls'
+import { SITE_URL } from '@/lib/core/utils/urls'
import { IntegrationCtaButton } from '@/app/(landing)/integrations/[slug]/components/integration-cta-button'
import { IntegrationFAQ } from '@/app/(landing)/integrations/[slug]/components/integration-faq'
import { TemplateCardButton } from '@/app/(landing)/integrations/[slug]/components/template-card-button'
@@ -14,7 +14,7 @@ import { TEMPLATES } from '@/app/workspace/[workspaceId]/home/components/templat
const allIntegrations = integrations as Integration[]
const INTEGRATION_COUNT = allIntegrations.length
-const baseUrl = getBaseUrl()
+const baseUrl = SITE_URL
/** Fast O(1) lookups — avoids repeated linear scans inside render loops. */
const bySlug = new Map(allIntegrations.map((i) => [i.slug, i]))
diff --git a/apps/sim/app/(landing)/integrations/layout.tsx b/apps/sim/app/(landing)/integrations/layout.tsx
index 23614abe12..231771091c 100644
--- a/apps/sim/app/(landing)/integrations/layout.tsx
+++ b/apps/sim/app/(landing)/integrations/layout.tsx
@@ -1,11 +1,11 @@
import { getNavBlogPosts } from '@/lib/blog/registry'
-import { getBaseUrl } from '@/lib/core/utils/urls'
+import { SITE_URL } from '@/lib/core/utils/urls'
import Footer from '@/app/(landing)/components/footer/footer'
import Navbar from '@/app/(landing)/components/navbar/navbar'
export default async function IntegrationsLayout({ children }: { children: React.ReactNode }) {
const blogPosts = await getNavBlogPosts()
- const url = getBaseUrl()
+ const url = SITE_URL
const orgJsonLd = {
'@context': 'https://schema.org',
'@type': 'Organization',
diff --git a/apps/sim/app/(landing)/integrations/page.tsx b/apps/sim/app/(landing)/integrations/page.tsx
index 60927489ee..3340ba7f27 100644
--- a/apps/sim/app/(landing)/integrations/page.tsx
+++ b/apps/sim/app/(landing)/integrations/page.tsx
@@ -1,6 +1,6 @@
import type { Metadata } from 'next'
import { Badge } from '@/components/emcn'
-import { getBaseUrl } from '@/lib/core/utils/urls'
+import { SITE_URL } from '@/lib/core/utils/urls'
import { IntegrationCard } from './components/integration-card'
import { IntegrationGrid } from './components/integration-grid'
import { RequestIntegrationModal } from './components/request-integration-modal'
@@ -18,7 +18,7 @@ const INTEGRATION_COUNT = allIntegrations.length
*/
const TOP_NAMES = [...new Set(POPULAR_WORKFLOWS.flatMap((p) => [p.from, p.to]))].slice(0, 6)
-const baseUrl = getBaseUrl()
+const baseUrl = SITE_URL
/** Curated featured integrations — high-recognition services shown as cards. */
const FEATURED_SLUGS = ['slack', 'notion', 'github', 'gmail'] as const
diff --git a/apps/sim/app/(landing)/layout.tsx b/apps/sim/app/(landing)/layout.tsx
index bb6ee98275..3b10895f16 100644
--- a/apps/sim/app/(landing)/layout.tsx
+++ b/apps/sim/app/(landing)/layout.tsx
@@ -1,9 +1,10 @@
import type { Metadata } from 'next'
+import { SITE_URL } from '@/lib/core/utils/urls'
import { martianMono } from '@/app/_styles/fonts/martian-mono/martian-mono'
import { season } from '@/app/_styles/fonts/season/season'
export const metadata: Metadata = {
- metadataBase: new URL('https://sim.ai'),
+ metadataBase: new URL(SITE_URL),
manifest: '/manifest.webmanifest',
icons: {
icon: [{ url: '/icon.svg', type: 'image/svg+xml', sizes: 'any' }],
diff --git a/apps/sim/app/(landing)/models/[provider]/[model]/page.tsx b/apps/sim/app/(landing)/models/[provider]/[model]/page.tsx
index 7334c689cb..c8ab7d8c42 100644
--- a/apps/sim/app/(landing)/models/[provider]/[model]/page.tsx
+++ b/apps/sim/app/(landing)/models/[provider]/[model]/page.tsx
@@ -1,7 +1,7 @@
import type { Metadata } from 'next'
import Link from 'next/link'
import { notFound } from 'next/navigation'
-import { getBaseUrl } from '@/lib/core/utils/urls'
+import { SITE_URL } from '@/lib/core/utils/urls'
import { LandingFAQ } from '@/app/(landing)/components/landing-faq'
import { FeaturedModelCard, ProviderIcon } from '@/app/(landing)/models/components/model-primitives'
import {
@@ -18,7 +18,7 @@ import {
getRelatedModels,
} from '@/app/(landing)/models/utils'
-const baseUrl = getBaseUrl()
+const baseUrl = SITE_URL
export async function generateStaticParams() {
return ALL_CATALOG_MODELS.map((model) => ({
@@ -221,7 +221,7 @@ export default async function ModelPage({
)
@@ -139,8 +139,8 @@ export function ExecutionSnapshot({
Logged State Not Found
- This log was migrated from the old logging system. The workflow state at execution time
- is not available.
+ This log was migrated from the old logging system. The workflow state at the time of
+ this run is not available.
Note: {workflowState._note}
@@ -191,7 +191,7 @@ export function ExecutionSnapshot({
>
- Copy Execution ID
+ Copy Run ID
,
diff --git a/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/log-details.tsx b/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/log-details.tsx
index 3c8f4e499d..994b4d7daf 100644
--- a/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/log-details.tsx
+++ b/apps/sim/app/workspace/[workspaceId]/logs/components/log-details/log-details.tsx
@@ -448,11 +448,11 @@ export const LogDetails = memo(function LogDetails({
- {/* Execution ID */}
+ {/* Run ID */}
{log.executionId && (
- Execution ID
+ Run ID
{log.executionId}
@@ -576,7 +576,7 @@ export const LogDetails = memo(function LogDetails({
- Base Execution:
+ Base Run:
{formatCost(BASE_EXECUTION_CHARGE)}
@@ -643,8 +643,8 @@ export const LogDetails = memo(function LogDetails({
- Total cost includes a base execution charge of{' '}
- {formatCost(BASE_EXECUTION_CHARGE)} plus any model and tool usage costs.
+ Total cost includes a base run charge of {formatCost(BASE_EXECUTION_CHARGE)}{' '}
+ plus any model and tool usage costs.