chore(blocks): one-time shift of all docsLinks to the new docs URLs

Block definitions are the patterns coding agents copy from, so redirects alone
leave new blocks minting dead conventions. Every docs.sim.ai link in apps/sim
now points at the final URL scheme: /tools/<slug> -> /integrations/<slug>
(433 links), /blocks/<core> -> /workflows/blocks/<core> (knowledge/enrichment/
logs -> /integrations/*), native /triggers/* -> /workflows/triggers/*,
/mcp -> /agents/mcp, /self-hosting + /enterprise -> /platform/*, plus the
llms.txt listings and the blocks.test.ts assertions.

Verified every rewritten target against the docs tree: all resolve except ten
hidden blocks (vision, spotify, thinking, tts...) and a2a whose links were
already dead pre-reorg — no regressions introduced.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: ouiliame

apps/sim/app/(landing)/components/footer/footer.tsx

@@ -18,9 +18,9 @@ const PRODUCT_LINKS: FooterItem[] = [
   { label: 'Workflows', href: 'https://docs.sim.ai', external: true },
   { label: 'Knowledge Base', href: 'https://docs.sim.ai/knowledgebase', external: true },
   { label: 'Tables', href: 'https://docs.sim.ai/tables', external: true },
-  { label: 'MCP', href: 'https://docs.sim.ai/mcp', external: true },
+  { label: 'MCP', href: 'https://docs.sim.ai/agents/mcp', external: true },
   { label: 'API', href: 'https://docs.sim.ai/api-reference/getting-started', external: true },
-  { label: 'Self Hosting', href: 'https://docs.sim.ai/self-hosting', external: true },
+  { label: 'Self Hosting', href: 'https://docs.sim.ai/platform/self-hosting', external: true },
   { label: 'Status', href: 'https://status.sim.ai', external: true, externalArrow: true },
 ]
 
@@ -35,38 +35,46 @@ const RESOURCES_LINKS: FooterItem[] = [
 ]
 
 const BLOCK_LINKS: FooterItem[] = [
-  { label: 'Agent', href: 'https://docs.sim.ai/blocks/agent', external: true },
-  { label: 'Router', href: 'https://docs.sim.ai/blocks/router', external: true },
-  { label: 'Function', href: 'https://docs.sim.ai/blocks/function', external: true },
-  { label: 'Condition', href: 'https://docs.sim.ai/blocks/condition', external: true },
-  { label: 'API Block', href: 'https://docs.sim.ai/blocks/api', external: true },
-  { label: 'Workflow', href: 'https://docs.sim.ai/blocks/workflow', external: true },
-  { label: 'Parallel', href: 'https://docs.sim.ai/blocks/parallel', external: true },
-  { label: 'Guardrails', href: 'https://docs.sim.ai/blocks/guardrails', external: true },
-  { label: 'Evaluator', href: 'https://docs.sim.ai/blocks/evaluator', external: true },
-  { label: 'Loop', href: 'https://docs.sim.ai/blocks/loop', external: true },
+  { label: 'Agent', href: 'https://docs.sim.ai/workflows/blocks/agent', external: true },
+  { label: 'Router', href: 'https://docs.sim.ai/workflows/blocks/router', external: true },
+  { label: 'Function', href: 'https://docs.sim.ai/workflows/blocks/function', external: true },
+  { label: 'Condition', href: 'https://docs.sim.ai/workflows/blocks/condition', external: true },
+  { label: 'API Block', href: 'https://docs.sim.ai/workflows/blocks/api', external: true },
+  { label: 'Workflow', href: 'https://docs.sim.ai/workflows/blocks/workflow', external: true },
+  { label: 'Parallel', href: 'https://docs.sim.ai/workflows/blocks/parallel', external: true },
+  { label: 'Guardrails', href: 'https://docs.sim.ai/workflows/blocks/guardrails', external: true },
+  { label: 'Evaluator', href: 'https://docs.sim.ai/workflows/blocks/evaluator', external: true },
+  { label: 'Loop', href: 'https://docs.sim.ai/workflows/blocks/loop', external: true },
 ]
 
 const INTEGRATION_LINKS: FooterItem[] = [
   { label: 'All Integrations', href: '/integrations' },
-  { label: 'Confluence', href: 'https://docs.sim.ai/tools/confluence', external: true },
-  { label: 'Slack', href: 'https://docs.sim.ai/tools/slack', external: true },
-  { label: 'GitHub', href: 'https://docs.sim.ai/tools/github', external: true },
-  { label: 'Gmail', href: 'https://docs.sim.ai/tools/gmail', external: true },
-  { label: 'HubSpot', href: 'https://docs.sim.ai/tools/hubspot', external: true },
-  { label: 'Salesforce', href: 'https://docs.sim.ai/tools/salesforce', external: true },
-  { label: 'Notion', href: 'https://docs.sim.ai/tools/notion', external: true },
-  { label: 'Google Drive', href: 'https://docs.sim.ai/tools/google_drive', external: true },
-  { label: 'Google Sheets', href: 'https://docs.sim.ai/tools/google_sheets', external: true },
-  { label: 'Supabase', href: 'https://docs.sim.ai/tools/supabase', external: true },
-  { label: 'Stripe', href: 'https://docs.sim.ai/tools/stripe', external: true },
-  { label: 'Jira', href: 'https://docs.sim.ai/tools/jira', external: true },
-  { label: 'Linear', href: 'https://docs.sim.ai/tools/linear', external: true },
-  { label: 'Airtable', href: 'https://docs.sim.ai/tools/airtable', external: true },
-  { label: 'Firecrawl', href: 'https://docs.sim.ai/tools/firecrawl', external: true },
-  { label: 'Discord', href: 'https://docs.sim.ai/tools/discord', external: true },
-  { label: 'Microsoft Teams', href: 'https://docs.sim.ai/tools/microsoft_teams', external: true },
-  { label: 'Telegram', href: 'https://docs.sim.ai/tools/telegram', external: true },
+  { label: 'Confluence', href: 'https://docs.sim.ai/integrations/confluence', external: true },
+  { label: 'Slack', href: 'https://docs.sim.ai/integrations/slack', external: true },
+  { label: 'GitHub', href: 'https://docs.sim.ai/integrations/github', external: true },
+  { label: 'Gmail', href: 'https://docs.sim.ai/integrations/gmail', external: true },
+  { label: 'HubSpot', href: 'https://docs.sim.ai/integrations/hubspot', external: true },
+  { label: 'Salesforce', href: 'https://docs.sim.ai/integrations/salesforce', external: true },
+  { label: 'Notion', href: 'https://docs.sim.ai/integrations/notion', external: true },
+  { label: 'Google Drive', href: 'https://docs.sim.ai/integrations/google_drive', external: true },
+  {
+    label: 'Google Sheets',
+    href: 'https://docs.sim.ai/integrations/google_sheets',
+    external: true,
+  },
+  { label: 'Supabase', href: 'https://docs.sim.ai/integrations/supabase', external: true },
+  { label: 'Stripe', href: 'https://docs.sim.ai/integrations/stripe', external: true },
+  { label: 'Jira', href: 'https://docs.sim.ai/integrations/jira', external: true },
+  { label: 'Linear', href: 'https://docs.sim.ai/integrations/linear', external: true },
+  { label: 'Airtable', href: 'https://docs.sim.ai/integrations/airtable', external: true },
+  { label: 'Firecrawl', href: 'https://docs.sim.ai/integrations/firecrawl', external: true },
+  { label: 'Discord', href: 'https://docs.sim.ai/integrations/discord', external: true },
+  {
+    label: 'Microsoft Teams',
+    href: 'https://docs.sim.ai/integrations/microsoft_teams',
+    external: true,
+  },
+  { label: 'Telegram', href: 'https://docs.sim.ai/integrations/telegram', external: true },
 ]
 
 const SOCIAL_LINKS: FooterItem[] = [

apps/sim/app/(landing)/components/navbar/components/docs-dropdown.tsx

@@ -18,19 +18,19 @@ const RESOURCE_CARDS = [
   {
     title: 'Agent',
     description: 'Build AI agents',
-    href: 'https://docs.sim.ai/blocks/agent',
+    href: 'https://docs.sim.ai/workflows/blocks/agent',
     icon: AgentIcon,
   },
   {
     title: 'MCP',
     description: 'Connect tools',
-    href: 'https://docs.sim.ai/mcp',
+    href: 'https://docs.sim.ai/agents/mcp',
     icon: McpIcon,
   },
   {
     title: 'Self-hosting',
     description: 'Host on your infra',
-    href: 'https://docs.sim.ai/self-hosting',
+    href: 'https://docs.sim.ai/platform/self-hosting',
     icon: GithubOutlineIcon,
   },
 ] as const

apps/sim/app/(landing)/components/structured-data.tsx

@@ -255,7 +255,7 @@ export default function StructuredData() {
             name: 'Can I self-host Sim?',
             acceptedAnswer: {
               '@type': 'Answer',
-              text: 'Yes. Sim can be self-hosted using Docker. Documentation is available at docs.sim.ai/self-hosting. Enterprise customers can also get dedicated infrastructure and on-premise deployment.',
+              text: 'Yes. Sim can be self-hosted using Docker. Documentation is available at docs.sim.ai/platform/self-hosting. Enterprise customers can also get dedicated infrastructure and on-premise deployment.',
             },
           },
         ],

apps/sim/app/llms.txt/route.ts

@@ -20,8 +20,8 @@ Sim lets teams create agents visually with the workflow builder, conversationall
 ## Documentation
 
 - [Documentation](https://docs.sim.ai): Product guides and technical reference
-- [Quickstart](https://docs.sim.ai/quickstart): Fastest path to getting started
-- [API Reference](https://docs.sim.ai/api): API documentation
+- [Quickstart](https://docs.sim.ai/getting-started): Fastest path to getting started
+- [API Reference](https://docs.sim.ai/api-reference): API documentation
 
 ## Key Concepts
 

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/subflows/loop/loop-config.ts

@@ -9,5 +9,5 @@ export const LoopTool = {
   name: 'Loop',
   icon: RepeatIcon,
   bgColor: '#2FB3FF',
-  docsLink: 'https://docs.sim.ai/blocks/loop',
+  docsLink: 'https://docs.sim.ai/workflows/blocks/loop',
 } as const

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/subflows/parallel/parallel-config.ts

@@ -9,5 +9,5 @@ export const ParallelTool = {
   name: 'Parallel',
   icon: SplitIcon,
   bgColor: '#FEE12B',
-  docsLink: 'https://docs.sim.ai/blocks/parallel',
+  docsLink: 'https://docs.sim.ai/workflows/blocks/parallel',
 } as const

apps/sim/blocks/blocks.test.ts

@@ -696,10 +696,10 @@ describe.concurrent('Blocks Module', () => {
 
     it('should handle blocks with docsLink', () => {
       const functionBlock = getBlock('function')
-      expect(functionBlock?.docsLink).toBe('https://docs.sim.ai/blocks/function')
+      expect(functionBlock?.docsLink).toBe('https://docs.sim.ai/workflows/blocks/function')
 
       const apiBlock = getBlock('api')
-      expect(apiBlock?.docsLink).toBe('https://docs.sim.ai/blocks/api')
+      expect(apiBlock?.docsLink).toBe('https://docs.sim.ai/workflows/blocks/api')
     })
   })
 

apps/sim/blocks/blocks/a2a.ts

@@ -62,7 +62,7 @@ export const A2ABlock: BlockConfig<A2AResponse> = {
     'Use the A2A (Agent-to-Agent) protocol to interact with external AI agents. ' +
     'Send messages, query task status, cancel tasks, or discover agent capabilities. ' +
     'Compatible with any A2A-compliant agent including LangGraph, Google ADK, and other Sim workflows.',
-  docsLink: 'https://docs.sim.ai/blocks/a2a',
+  docsLink: 'https://docs.sim.ai/workflows/blocks/a2a',
   category: 'blocks',
   integrationType: IntegrationType.DevOps,
   bgColor: '#4151B5',

apps/sim/blocks/blocks/agent.ts

@@ -77,7 +77,7 @@ export const AgentBlock: BlockConfig<AgentResponse> = {
   - Prefer using integrations as tools within the agent block over separate integration blocks unless complete determinism needed. 
   - Response Format should be a valid JSON Schema. This determines the output of the agent only if present. Fields can be accessed at root level by the following blocks: e.g. <agent1.field>. If response format is not present, the agent will return the standard outputs: content, model, tokens, toolCalls.
   `,
-  docsLink: 'https://docs.sim.ai/blocks/agent',
+  docsLink: 'https://docs.sim.ai/workflows/blocks/agent',
   category: 'blocks',
   integrationType: IntegrationType.AI,
   bgColor: 'var(--brand)',

apps/sim/blocks/blocks/agentmail.ts

@@ -8,7 +8,7 @@ export const AgentMailBlock: BlockConfig = {
   description: 'Manage email inboxes, threads, and messages with AgentMail',
   longDescription:
     'Integrate AgentMail into your workflow. Create and manage email inboxes, send and receive messages, reply to threads, manage drafts, and organize threads with labels. Requires API Key.',
-  docsLink: 'https://docs.sim.ai/tools/agentmail',
+  docsLink: 'https://docs.sim.ai/integrations/agentmail',
   category: 'tools',
   integrationType: IntegrationType.Email,
   bgColor: '#000000',