From 3df909bba4d15fb810a1b5c540fff34f555ced2a Mon Sep 17 00:00:00 2001 From: Devon-White Date: Tue, 8 Sep 2026 12:32:30 -0400 Subject: [PATCH 1/3] Fix legacy Agents SDK and SWML redirects that dropped readers on section indexes Refs #526. The /docs/agents-sdk/:slug* wildcard collapsed every legacy Agents SDK URL to the Server SDKs product root. All 70 old guide slugs survive unchanged under /docs/server-sdks/guides/, so the wildcards now preserve the tail, with explicit entries for the reference pages that moved elsewhere. Also adds the old /docs/swml/methods/* tree (404 today) and the SWAIG.defaults path, which never had its own page. Co-Authored-By: Claude Fable 5.1 --- fern/docs.yml | 78 +++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 76 insertions(+), 2 deletions(-) diff --git a/fern/docs.yml b/fern/docs.yml index 76b47e5bd9..d295ca3754 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -194,14 +194,75 @@ css: - components/voice-widget/styles.css redirects: + # Legacy Agents SDK product (#526). The old tree was + # /docs/agents-sdk/python/guides/ and /docs/agents-sdk/python/reference/; + # every guide slug survived unchanged under /docs/server-sdks/guides/, so the + # wildcards preserve the tail. A redirect to a section index is worse than a + # 404 for a reader or a model, so nothing here lands on the product root + # except the bare product path. Specific entries precede their wildcards. - source: /docs/agents-sdk destination: /docs/server-sdks - - source: /docs/agents-sdk/:slug* + - source: /docs/agents-sdk/python destination: /docs/server-sdks + - source: /docs/agents-sdk/python/guides/:slug* + destination: /docs/server-sdks/guides/:slug* + # Reference pages that moved somewhere other than their like-named agents/ page. + - source: /docs/agents-sdk/python/reference/cli-swaig-test + destination: /docs/server-sdks/reference/python/agents/cli/swaig-test + - source: /docs/agents-sdk/python/reference/cli-sw-search + destination: /docs/server-sdks/reference/python/agents/cli/sw-search + - source: /docs/agents-sdk/python/reference/cli-sw-agent-init + destination: /docs/server-sdks/reference/python/agents/cli/sw-agent-init + - source: /docs/agents-sdk/python/reference/contexts + destination: /docs/server-sdks/reference/python/agents/context-builder + - source: /docs/agents-sdk/python/reference/environment-variables + destination: /docs/server-sdks/reference/python/agents/configuration/environment-variables + - source: /docs/agents-sdk/python/reference/ai-parameters-reference + destination: /docs/server-sdks/guides/ai-parameters + - source: /docs/agents-sdk/python/reference/troubleshooting + destination: /docs/server-sdks/guides/troubleshooting + # Appendix pages with no successor (best-practices, patterns, changelog, + # migration, swml-schema) fall through to the Python reference index. + - source: /docs/agents-sdk/python/reference/best-practices + destination: /docs/server-sdks/reference/python + - source: /docs/agents-sdk/python/reference/patterns + destination: /docs/server-sdks/reference/python + - source: /docs/agents-sdk/python/reference/changelog + destination: /docs/server-sdks/reference/python + - source: /docs/agents-sdk/python/reference/migration + destination: /docs/server-sdks/reference/python + - source: /docs/agents-sdk/python/reference/swml-schema + destination: /docs/server-sdks/reference/python + - source: /docs/agents-sdk/python/reference/:slug* + destination: /docs/server-sdks/reference/python/agents/:slug* + # Short forms still surfaced by search engines and the developer.signalwire.com + # redirector: /docs/agents-sdk/
/ and /docs/agents-sdk/. + - source: /docs/agents-sdk/getting-started/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/core-concepts/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/building-agents/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/swaig-functions/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/skills/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/prefabs/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/deployment/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/advanced/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/signalwire-integration/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/examples/:slug* + destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/:slug* + destination: /docs/server-sdks/guides/:slug* - source: /docs/server-sdk destination: /docs/server-sdks - source: /docs/server-sdk/:slug* - destination: /docs/server-sdks + destination: /docs/server-sdks/:slug* # Browser SDK v3 guides removed (v3 is deprecated); point old guide URLs at # the v4 migration guide, which covers the v3->v4 API mapping and flags the # features v4 does not implement yet. These must precede the general @@ -246,6 +307,19 @@ redirects: - source: /docs/swml/reference destination: /docs/swml/reference/calling + # Older still: methods lived under /docs/swml/methods/ (#526). Point the + # whole tree at the calling reference, tail preserved. + - source: /docs/swml/methods + destination: /docs/swml/reference/calling + - source: /docs/swml/methods/:slug* + destination: /docs/swml/reference/calling/:slug* + + # SWAIG.defaults never had its own page; it is documented on the SWAIG page (#526). + - source: /docs/swml/reference/ai/swaig/defaults + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/reference/calling/ai/swaig/defaults + destination: /docs/swml/reference/calling/ai/swaig + # Folder-style methods with nested sub-pages — wildcard catches every old child path. - source: /docs/swml/reference/ai destination: /docs/swml/reference/calling/ai From 2ff200836ac5f9bad87cf5b6550c69e9a21798ff Mon Sep 17 00:00:00 2001 From: Devon-White Date: Tue, 8 Sep 2026 12:54:08 -0400 Subject: [PATCH 2/3] Add explicit redirects for legacy example index pages with no successor Co-Authored-By: Claude Fable 5.1 --- fern/docs.yml | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/fern/docs.yml b/fern/docs.yml index d295ca3754..89dd27dc14 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -204,8 +204,6 @@ redirects: destination: /docs/server-sdks - source: /docs/agents-sdk/python destination: /docs/server-sdks - - source: /docs/agents-sdk/python/guides/:slug* - destination: /docs/server-sdks/guides/:slug* # Reference pages that moved somewhere other than their like-named agents/ page. - source: /docs/agents-sdk/python/reference/cli-swaig-test destination: /docs/server-sdks/reference/python/agents/cli/swaig-test @@ -221,6 +219,15 @@ redirects: destination: /docs/server-sdks/guides/ai-parameters - source: /docs/agents-sdk/python/reference/troubleshooting destination: /docs/server-sdks/guides/troubleshooting + # Example index pages have no successor; land on the build-ai-agents guide index. + - source: /docs/agents-sdk/python/guides/by-complexity + destination: /docs/server-sdks/guides/build-ai-agents + - source: /docs/agents-sdk/python/guides/by-feature + destination: /docs/server-sdks/guides/build-ai-agents + - source: /docs/agents-sdk/examples/:slug* + destination: /docs/server-sdks/guides/build-ai-agents + - source: /docs/agents-sdk/python/guides/:slug* + destination: /docs/server-sdks/guides/:slug* # Appendix pages with no successor (best-practices, patterns, changelog, # migration, swml-schema) fall through to the Python reference index. - source: /docs/agents-sdk/python/reference/best-practices @@ -255,8 +262,6 @@ redirects: destination: /docs/server-sdks/guides/:slug* - source: /docs/agents-sdk/signalwire-integration/:slug* destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/examples/:slug* - destination: /docs/server-sdks/guides/:slug* - source: /docs/agents-sdk/:slug* destination: /docs/server-sdks/guides/:slug* - source: /docs/server-sdk From d38fd976ca265ef3abf1bbe940bdb3ab062654fe Mon Sep 17 00:00:00 2001 From: Devon-White Date: Tue, 8 Sep 2026 13:21:51 -0400 Subject: [PATCH 3/3] Map legacy URLs only to equivalent existing documentation --- fern/docs.yml | 640 +++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 578 insertions(+), 62 deletions(-) diff --git a/fern/docs.yml b/fern/docs.yml index 89dd27dc14..029624af15 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -194,76 +194,280 @@ css: - components/voice-widget/styles.css redirects: - # Legacy Agents SDK product (#526). The old tree was - # /docs/agents-sdk/python/guides/ and /docs/agents-sdk/python/reference/; - # every guide slug survived unchanged under /docs/server-sdks/guides/, so the - # wildcards preserve the tail. A redirect to a section index is worse than a - # 404 for a reader or a model, so nothing here lands on the product root - # except the bare product path. Specific entries precede their wildcards. + # Legacy Agents SDK pages (#526). Use known paths and equivalent existing + # content only. Exact entries prevent unknown or removed pages (examples, + # best-practices, patterns, migration, changelog) from redirecting to an + # unrelated overview or a nonexistent guide. Those paths remain not found. - source: /docs/agents-sdk destination: /docs/server-sdks + - source: /docs/agents-sdk/advanced/call-recording + destination: /docs/server-sdks/guides/call-recording + - source: /docs/agents-sdk/advanced/call-transfer + destination: /docs/server-sdks/guides/call-transfer + - source: /docs/agents-sdk/advanced/contexts-workflows + destination: /docs/server-sdks/guides/contexts-workflows + - source: /docs/agents-sdk/advanced/mcp-gateway + destination: /docs/server-sdks/guides/mcp-gateway + - source: /docs/agents-sdk/advanced/multi-agent + destination: /docs/server-sdks/guides/multi-agent + - source: /docs/agents-sdk/advanced/search-knowledge + destination: /docs/server-sdks/guides/search-knowledge + - source: /docs/agents-sdk/advanced/state-management + destination: /docs/server-sdks/guides/state-management + - source: /docs/agents-sdk/api/agent-base + destination: /docs/server-sdks/reference/python/agents/agent-base + - source: /docs/agents-sdk/api/cli-sw-agent-init + destination: /docs/server-sdks/reference/python/agents/cli/sw-agent-init + - source: /docs/agents-sdk/api/cli-sw-search + destination: /docs/server-sdks/reference/python/agents/cli/sw-search + - source: /docs/agents-sdk/api/cli/swaig-test + destination: /docs/server-sdks/reference/python/agents/cli/swaig-test + - source: /docs/agents-sdk/api/configuration + destination: /docs/server-sdks/reference/python/agents/configuration + - source: /docs/agents-sdk/api/contexts + destination: /docs/server-sdks/reference/python/agents/context-builder + - source: /docs/agents-sdk/api/data-map + destination: /docs/server-sdks/reference/python/agents/data-map + - source: /docs/agents-sdk/api/environment-variables + destination: /docs/server-sdks/reference/python/agents/configuration/environment-variables + - source: /docs/agents-sdk/api/function-result + destination: /docs/server-sdks/reference/python/agents/function-result + - source: /docs/agents-sdk/api/skill-base + destination: /docs/server-sdks/reference/python/agents/skill-base + - source: /docs/agents-sdk/api/swaig-function + destination: /docs/server-sdks/reference/python/agents/swaig-function + - source: /docs/agents-sdk/api/swml-schema + destination: /docs/server-sdks/guides/swml + - source: /docs/agents-sdk/api/swml-service + destination: /docs/server-sdks/reference/python/agents/swml-service + - source: /docs/agents-sdk/appendix/ai-parameters-reference + destination: /docs/server-sdks/guides/ai-parameters + - source: /docs/agents-sdk/appendix/troubleshooting + destination: /docs/server-sdks/guides/troubleshooting + - source: /docs/agents-sdk/building-agents/agent-base + destination: /docs/server-sdks/guides/agent-base + - source: /docs/agents-sdk/building-agents/ai-parameters + destination: /docs/server-sdks/guides/ai-parameters + - source: /docs/agents-sdk/building-agents/call-flow + destination: /docs/server-sdks/guides/call-flow + - source: /docs/agents-sdk/building-agents/hints + destination: /docs/server-sdks/guides/hints + - source: /docs/agents-sdk/building-agents/prompts-pom + destination: /docs/server-sdks/guides/prompts-pom + - source: /docs/agents-sdk/building-agents/static-vs-dynamic + destination: /docs/server-sdks/guides/static-vs-dynamic + - source: /docs/agents-sdk/building-agents/voice-language + destination: /docs/server-sdks/guides/voice-language + - source: /docs/agents-sdk/core-concepts/architecture + destination: /docs/server-sdks/guides/architecture + - source: /docs/agents-sdk/core-concepts/lifecycle + destination: /docs/server-sdks/guides/lifecycle + - source: /docs/agents-sdk/core-concepts/security + destination: /docs/server-sdks/guides/security + - source: /docs/agents-sdk/core-concepts/swaig + destination: /docs/server-sdks/guides/swaig + - source: /docs/agents-sdk/core-concepts/swml + destination: /docs/server-sdks/guides/swml + - source: /docs/agents-sdk/deployment/cgi-mode + destination: /docs/server-sdks/guides/cgi-mode + - source: /docs/agents-sdk/deployment/docker-kubernetes + destination: /docs/server-sdks/guides/docker-kubernetes + - source: /docs/agents-sdk/deployment/local-development + destination: /docs/server-sdks/guides/local-development + - source: /docs/agents-sdk/deployment/production + destination: /docs/server-sdks/guides/production + - source: /docs/agents-sdk/deployment/serverless + destination: /docs/server-sdks/guides/serverless + - source: /docs/agents-sdk/dev-environment + destination: /docs/server-sdks/guides/dev-environment + - source: /docs/agents-sdk/exposing-agents + destination: /docs/server-sdks/guides/exposing-agents + - source: /docs/agents-sdk/getting-started/dev-environment + destination: /docs/server-sdks/guides/dev-environment + - source: /docs/agents-sdk/getting-started/exposing-agents + destination: /docs/server-sdks/guides/exposing-agents + - source: /docs/agents-sdk/getting-started/installation + destination: /docs/server-sdks/guides/installation + - source: /docs/agents-sdk/getting-started/quickstart + destination: /docs/server-sdks/guides/quickstart + - source: /docs/agents-sdk/installation + destination: /docs/server-sdks/guides/installation + - source: /docs/agents-sdk/prefabs/concierge + destination: /docs/server-sdks/guides/concierge + - source: /docs/agents-sdk/prefabs/faq-bot + destination: /docs/server-sdks/guides/faq-bot + - source: /docs/agents-sdk/prefabs/info-gatherer + destination: /docs/server-sdks/guides/info-gatherer + - source: /docs/agents-sdk/prefabs/receptionist + destination: /docs/server-sdks/guides/receptionist + - source: /docs/agents-sdk/prefabs/survey + destination: /docs/server-sdks/guides/survey - source: /docs/agents-sdk/python destination: /docs/server-sdks - # Reference pages that moved somewhere other than their like-named agents/ page. - - source: /docs/agents-sdk/python/reference/cli-swaig-test - destination: /docs/server-sdks/reference/python/agents/cli/swaig-test - - source: /docs/agents-sdk/python/reference/cli-sw-search - destination: /docs/server-sdks/reference/python/agents/cli/sw-search + - source: /docs/agents-sdk/python/guides/account-setup + destination: /docs/server-sdks/guides/account-setup + - source: /docs/agents-sdk/python/guides/adding-skills + destination: /docs/server-sdks/guides/adding-skills + - source: /docs/agents-sdk/python/guides/agent-base + destination: /docs/server-sdks/guides/agent-base + - source: /docs/agents-sdk/python/guides/ai-parameters + destination: /docs/server-sdks/guides/ai-parameters + - source: /docs/agents-sdk/python/guides/architecture + destination: /docs/server-sdks/guides/architecture + - source: /docs/agents-sdk/python/guides/builtin-skills + destination: /docs/server-sdks/guides/builtin-skills + - source: /docs/agents-sdk/python/guides/call-flow + destination: /docs/server-sdks/guides/call-flow + - source: /docs/agents-sdk/python/guides/call-recording + destination: /docs/server-sdks/guides/call-recording + - source: /docs/agents-sdk/python/guides/call-transfer + destination: /docs/server-sdks/guides/call-transfer + - source: /docs/agents-sdk/python/guides/cgi-mode + destination: /docs/server-sdks/guides/cgi-mode + - source: /docs/agents-sdk/python/guides/concierge + destination: /docs/server-sdks/guides/concierge + - source: /docs/agents-sdk/python/guides/contexts-workflows + destination: /docs/server-sdks/guides/contexts-workflows + - source: /docs/agents-sdk/python/guides/custom + destination: /docs/server-sdks/guides/custom + - source: /docs/agents-sdk/python/guides/data-map + destination: /docs/server-sdks/guides/data-map + - source: /docs/agents-sdk/python/guides/defining-functions + destination: /docs/server-sdks/guides/defining-functions + - source: /docs/agents-sdk/python/guides/dev-environment + destination: /docs/server-sdks/guides/dev-environment + - source: /docs/agents-sdk/python/guides/docker-kubernetes + destination: /docs/server-sdks/guides/docker-kubernetes + - source: /docs/agents-sdk/python/guides/exposing-agents + destination: /docs/server-sdks/guides/exposing-agents + - source: /docs/agents-sdk/python/guides/faq-bot + destination: /docs/server-sdks/guides/faq-bot + - source: /docs/agents-sdk/python/guides/hints + destination: /docs/server-sdks/guides/hints + - source: /docs/agents-sdk/python/guides/info-gatherer + destination: /docs/server-sdks/guides/info-gatherer + - source: /docs/agents-sdk/python/guides/installation + destination: /docs/server-sdks/guides/installation + - source: /docs/agents-sdk/python/guides/lifecycle + destination: /docs/server-sdks/guides/lifecycle + - source: /docs/agents-sdk/python/guides/local-development + destination: /docs/server-sdks/guides/local-development + - source: /docs/agents-sdk/python/guides/mapping-numbers + destination: /docs/server-sdks/guides/mapping-numbers + - source: /docs/agents-sdk/python/guides/mcp-gateway + destination: /docs/server-sdks/guides/mcp-gateway + - source: /docs/agents-sdk/python/guides/multi-agent + destination: /docs/server-sdks/guides/multi-agent + - source: /docs/agents-sdk/python/guides/native-functions + destination: /docs/server-sdks/guides/native-functions + - source: /docs/agents-sdk/python/guides/parameters + destination: /docs/server-sdks/guides/parameters + - source: /docs/agents-sdk/python/guides/phone-numbers + destination: /docs/server-sdks/guides/phone-numbers + - source: /docs/agents-sdk/python/guides/production + destination: /docs/server-sdks/guides/production + - source: /docs/agents-sdk/python/guides/prompts-pom + destination: /docs/server-sdks/guides/prompts-pom + - source: /docs/agents-sdk/python/guides/quickstart + destination: /docs/server-sdks/guides/quickstart + - source: /docs/agents-sdk/python/guides/receptionist + destination: /docs/server-sdks/guides/receptionist + - source: /docs/agents-sdk/python/guides/result-actions + destination: /docs/server-sdks/guides/result-actions + - source: /docs/agents-sdk/python/guides/search-knowledge + destination: /docs/server-sdks/guides/search-knowledge + - source: /docs/agents-sdk/python/guides/security + destination: /docs/server-sdks/guides/security + - source: /docs/agents-sdk/python/guides/serverless + destination: /docs/server-sdks/guides/serverless + - source: /docs/agents-sdk/python/guides/skill-config + destination: /docs/server-sdks/guides/skill-config + - source: /docs/agents-sdk/python/guides/state-management + destination: /docs/server-sdks/guides/state-management + - source: /docs/agents-sdk/python/guides/static-vs-dynamic + destination: /docs/server-sdks/guides/static-vs-dynamic + - source: /docs/agents-sdk/python/guides/survey + destination: /docs/server-sdks/guides/survey + - source: /docs/agents-sdk/python/guides/swaig + destination: /docs/server-sdks/guides/swaig + - source: /docs/agents-sdk/python/guides/swml + destination: /docs/server-sdks/guides/swml + - source: /docs/agents-sdk/python/guides/testing + destination: /docs/server-sdks/guides/testing + - source: /docs/agents-sdk/python/guides/troubleshooting + destination: /docs/server-sdks/guides/troubleshooting + - source: /docs/agents-sdk/python/guides/understanding-skills + destination: /docs/server-sdks/guides/understanding-skills + - source: /docs/agents-sdk/python/guides/voice-language + destination: /docs/server-sdks/guides/voice-language + - source: /docs/agents-sdk/python/reference/agent-base + destination: /docs/server-sdks/reference/python/agents/agent-base + - source: /docs/agents-sdk/python/reference/ai-parameters-reference + destination: /docs/server-sdks/guides/ai-parameters - source: /docs/agents-sdk/python/reference/cli-sw-agent-init destination: /docs/server-sdks/reference/python/agents/cli/sw-agent-init + - source: /docs/agents-sdk/python/reference/cli-sw-search + destination: /docs/server-sdks/reference/python/agents/cli/sw-search + - source: /docs/agents-sdk/python/reference/cli-swaig-test + destination: /docs/server-sdks/reference/python/agents/cli/swaig-test + - source: /docs/agents-sdk/python/reference/configuration + destination: /docs/server-sdks/reference/python/agents/configuration - source: /docs/agents-sdk/python/reference/contexts destination: /docs/server-sdks/reference/python/agents/context-builder + - source: /docs/agents-sdk/python/reference/data-map + destination: /docs/server-sdks/reference/python/agents/data-map - source: /docs/agents-sdk/python/reference/environment-variables destination: /docs/server-sdks/reference/python/agents/configuration/environment-variables - - source: /docs/agents-sdk/python/reference/ai-parameters-reference - destination: /docs/server-sdks/guides/ai-parameters + - source: /docs/agents-sdk/python/reference/function-result + destination: /docs/server-sdks/reference/python/agents/function-result + - source: /docs/agents-sdk/python/reference/skill-base + destination: /docs/server-sdks/reference/python/agents/skill-base + - source: /docs/agents-sdk/python/reference/swaig-function + destination: /docs/server-sdks/reference/python/agents/swaig-function + - source: /docs/agents-sdk/python/reference/swml-schema + destination: /docs/server-sdks/guides/swml + - source: /docs/agents-sdk/python/reference/swml-service + destination: /docs/server-sdks/reference/python/agents/swml-service - source: /docs/agents-sdk/python/reference/troubleshooting destination: /docs/server-sdks/guides/troubleshooting - # Example index pages have no successor; land on the build-ai-agents guide index. - - source: /docs/agents-sdk/python/guides/by-complexity - destination: /docs/server-sdks/guides/build-ai-agents - - source: /docs/agents-sdk/python/guides/by-feature - destination: /docs/server-sdks/guides/build-ai-agents - - source: /docs/agents-sdk/examples/:slug* - destination: /docs/server-sdks/guides/build-ai-agents - - source: /docs/agents-sdk/python/guides/:slug* - destination: /docs/server-sdks/guides/:slug* - # Appendix pages with no successor (best-practices, patterns, changelog, - # migration, swml-schema) fall through to the Python reference index. - - source: /docs/agents-sdk/python/reference/best-practices - destination: /docs/server-sdks/reference/python - - source: /docs/agents-sdk/python/reference/patterns - destination: /docs/server-sdks/reference/python - - source: /docs/agents-sdk/python/reference/changelog - destination: /docs/server-sdks/reference/python - - source: /docs/agents-sdk/python/reference/migration - destination: /docs/server-sdks/reference/python - - source: /docs/agents-sdk/python/reference/swml-schema - destination: /docs/server-sdks/reference/python - - source: /docs/agents-sdk/python/reference/:slug* - destination: /docs/server-sdks/reference/python/agents/:slug* - # Short forms still surfaced by search engines and the developer.signalwire.com - # redirector: /docs/agents-sdk/
/ and /docs/agents-sdk/. - - source: /docs/agents-sdk/getting-started/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/core-concepts/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/building-agents/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/swaig-functions/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/skills/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/prefabs/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/deployment/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/advanced/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/signalwire-integration/:slug* - destination: /docs/server-sdks/guides/:slug* - - source: /docs/agents-sdk/:slug* - destination: /docs/server-sdks/guides/:slug* + - source: /docs/agents-sdk/quickstart + destination: /docs/server-sdks/guides/quickstart + - source: /docs/agents-sdk/security + destination: /docs/server-sdks/guides/security + - source: /docs/agents-sdk/signalwire-integration/account-setup + destination: /docs/server-sdks/guides/account-setup + - source: /docs/agents-sdk/signalwire-integration/mapping-numbers + destination: /docs/server-sdks/guides/mapping-numbers + - source: /docs/agents-sdk/signalwire-integration/phone-numbers + destination: /docs/server-sdks/guides/phone-numbers + - source: /docs/agents-sdk/signalwire-integration/testing + destination: /docs/server-sdks/guides/testing + - source: /docs/agents-sdk/signalwire-integration/troubleshooting + destination: /docs/server-sdks/guides/troubleshooting + - source: /docs/agents-sdk/skills/adding-skills + destination: /docs/server-sdks/guides/adding-skills + - source: /docs/agents-sdk/skills/builtin-skills + destination: /docs/server-sdks/guides/builtin-skills + - source: /docs/agents-sdk/skills/custom + destination: /docs/server-sdks/guides/custom + - source: /docs/agents-sdk/skills/skill-config + destination: /docs/server-sdks/guides/skill-config + - source: /docs/agents-sdk/skills/understanding-skills + destination: /docs/server-sdks/guides/understanding-skills + - source: /docs/agents-sdk/swaig-functions/data-map + destination: /docs/server-sdks/guides/data-map + - source: /docs/agents-sdk/swaig-functions/datamap + destination: /docs/server-sdks/guides/data-map + - source: /docs/agents-sdk/swaig-functions/defining-functions + destination: /docs/server-sdks/guides/defining-functions + - source: /docs/agents-sdk/swaig-functions/native-functions + destination: /docs/server-sdks/guides/native-functions + - source: /docs/agents-sdk/swaig-functions/parameters + destination: /docs/server-sdks/guides/parameters + - source: /docs/agents-sdk/swaig-functions/result-actions + destination: /docs/server-sdks/guides/result-actions + - source: /docs/agents-sdk/swaig-functions/results-actions + destination: /docs/server-sdks/guides/result-actions - source: /docs/server-sdk destination: /docs/server-sdks - source: /docs/server-sdk/:slug* @@ -312,12 +516,324 @@ redirects: - source: /docs/swml/reference destination: /docs/swml/reference/calling - # Older still: methods lived under /docs/swml/methods/ (#526). Point the - # whole tree at the calling reference, tail preserved. + # Legacy SWML methods (#526): map renamed verbs and merged property pages + # directly to their current reference, avoiding an extra hop or a 404. - source: /docs/swml/methods destination: /docs/swml/reference/calling - - source: /docs/swml/methods/:slug* - destination: /docs/swml/reference/calling/:slug* + - source: /docs/swml/methods/ai + destination: /docs/swml/reference/calling/ai + - source: /docs/swml/methods/ai/hints + destination: /docs/swml/reference/calling/ai + - source: /docs/swml/methods/ai/languages + destination: /docs/swml/reference/calling/ai/languages + - source: /docs/swml/methods/ai/languages/params + destination: /docs/swml/reference/calling/ai/languages + - source: /docs/swml/methods/ai/params + destination: /docs/swml/reference/calling/ai/params + - source: /docs/swml/methods/ai/params/conscience + destination: /docs/swml/reference/calling/ai/params + - source: /docs/swml/methods/ai/params/hold-music + destination: /docs/swml/reference/calling/ai/params + - source: /docs/swml/methods/ai/params/hold_music + destination: /docs/swml/reference/calling/ai/params + - source: /docs/swml/methods/ai/params/interrupt-prompt + destination: /docs/swml/reference/calling/ai/params + - source: /docs/swml/methods/ai/params/interrupt_prompt + destination: /docs/swml/reference/calling/ai/params + - source: /docs/swml/methods/ai/post-prompt + destination: /docs/swml/reference/calling/ai + - source: /docs/swml/methods/ai/post-prompt-url + destination: /docs/swml/reference/calling/ai + - source: /docs/swml/methods/ai/post_prompt + destination: /docs/swml/reference/calling/ai + - source: /docs/swml/methods/ai/post_prompt_url + destination: /docs/swml/reference/calling/ai + - source: /docs/swml/methods/ai/prompt + destination: /docs/swml/reference/calling/ai/prompt + - source: /docs/swml/methods/ai/prompt/contexts + destination: /docs/swml/reference/calling/ai/prompt + - source: /docs/swml/methods/ai/prompt/contexts/steps + destination: /docs/swml/reference/calling/ai/prompt + - source: /docs/swml/methods/ai/prompt/pom + destination: /docs/swml/reference/calling/ai/prompt + - source: /docs/swml/methods/ai/pronounce + destination: /docs/swml/reference/calling/ai + - source: /docs/swml/methods/ai/swaig + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/methods/ai/swaig/defaults + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/methods/ai/swaig/defaults/web-hook-url + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/methods/ai/swaig/defaults/web_hook_url + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/methods/ai/swaig/functions + destination: /docs/swml/reference/calling/ai/swaig/functions + - source: /docs/swml/methods/ai/swaig/functions/data-map + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data-map/expressions + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data-map/output + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data-map/webhooks + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data-map/webhooks/foreach + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data_map + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data_map/expressions + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data_map/output + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data_map/webhooks + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/data_map/webhooks/foreach + destination: /docs/swml/reference/calling/ai/swaig/functions/data-map + - source: /docs/swml/methods/ai/swaig/functions/fillers + destination: /docs/swml/reference/calling/ai/swaig/functions + - source: /docs/swml/methods/ai/swaig/functions/parameters + destination: /docs/swml/reference/calling/ai/swaig/functions/parameters + - source: /docs/swml/methods/ai/swaig/functions/web-hook-url + destination: /docs/swml/reference/calling/ai/swaig/functions + - source: /docs/swml/methods/ai/swaig/functions/web_hook_url + destination: /docs/swml/reference/calling/ai/swaig/functions + - source: /docs/swml/methods/ai/swaig/includes + destination: /docs/swml/reference/calling/ai/swaig/includes + - source: /docs/swml/methods/ai/swaig/internal-fillers + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/methods/ai/swaig/internal_fillers + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/methods/ai/swaig/native-functions + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/methods/ai/swaig/native_functions + destination: /docs/swml/reference/calling/ai/swaig + - source: /docs/swml/methods/amazon-bedrock + destination: /docs/swml/reference/calling/amazon-bedrock + - source: /docs/swml/methods/amazon-bedrock/params + destination: /docs/swml/reference/calling/amazon-bedrock/params + - source: /docs/swml/methods/amazon-bedrock/post-prompt + destination: /docs/swml/reference/calling/amazon-bedrock + - source: /docs/swml/methods/amazon-bedrock/post-prompt-url + destination: /docs/swml/reference/calling/amazon-bedrock + - source: /docs/swml/methods/amazon-bedrock/prompt + destination: /docs/swml/reference/calling/amazon-bedrock/prompt + - source: /docs/swml/methods/amazon-bedrock/prompt/pom + destination: /docs/swml/reference/calling/amazon-bedrock/prompt + - source: /docs/swml/methods/amazon-bedrock/swaig + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon-bedrock/swaig/defaults + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon-bedrock/swaig/defaults/web-hook-url + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon-bedrock/swaig/functions + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions + - source: /docs/swml/methods/amazon-bedrock/swaig/functions/data-map + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon-bedrock/swaig/functions/data-map/expressions + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon-bedrock/swaig/functions/data-map/output + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon-bedrock/swaig/functions/data-map/webhooks + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon-bedrock/swaig/functions/data-map/webhooks/foreach + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon-bedrock/swaig/functions/parameters + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/parameters + - source: /docs/swml/methods/amazon-bedrock/swaig/functions/web-hook-url + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions + - source: /docs/swml/methods/amazon-bedrock/swaig/includes + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon-bedrock/swaig/native-functions + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon_bedrock + destination: /docs/swml/reference/calling/amazon-bedrock + - source: /docs/swml/methods/amazon_bedrock/params + destination: /docs/swml/reference/calling/amazon-bedrock/params + - source: /docs/swml/methods/amazon_bedrock/post_prompt + destination: /docs/swml/reference/calling/amazon-bedrock + - source: /docs/swml/methods/amazon_bedrock/post_prompt_url + destination: /docs/swml/reference/calling/amazon-bedrock + - source: /docs/swml/methods/amazon_bedrock/prompt + destination: /docs/swml/reference/calling/amazon-bedrock/prompt + - source: /docs/swml/methods/amazon_bedrock/prompt/pom + destination: /docs/swml/reference/calling/amazon-bedrock/prompt + - source: /docs/swml/methods/amazon_bedrock/swaig + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon_bedrock/swaig/defaults + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon_bedrock/swaig/defaults/web_hook_url + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon_bedrock/swaig/functions + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions + - source: /docs/swml/methods/amazon_bedrock/swaig/functions/data_map + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon_bedrock/swaig/functions/data_map/expressions + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon_bedrock/swaig/functions/data_map/output + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon_bedrock/swaig/functions/data_map/webhooks + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon_bedrock/swaig/functions/data_map/webhooks/foreach + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/data-map + - source: /docs/swml/methods/amazon_bedrock/swaig/functions/parameters + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions/parameters + - source: /docs/swml/methods/amazon_bedrock/swaig/functions/web_hook_url + destination: /docs/swml/reference/calling/amazon-bedrock/swaig/functions + - source: /docs/swml/methods/amazon_bedrock/swaig/includes + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/amazon_bedrock/swaig/native_functions + destination: /docs/swml/reference/calling/amazon-bedrock/swaig + - source: /docs/swml/methods/answer + destination: /docs/swml/reference/calling/answer + - source: /docs/swml/methods/cond + destination: /docs/swml/reference/calling/cond + - source: /docs/swml/methods/connect + destination: /docs/swml/reference/calling/connect + - source: /docs/swml/methods/connect/headers + destination: /docs/swml/reference/calling/connect + - source: /docs/swml/methods/denoise + destination: /docs/swml/reference/calling/denoise + - source: /docs/swml/methods/detect-machine + destination: /docs/swml/reference/calling/detect-machine + - source: /docs/swml/methods/detect_machine + destination: /docs/swml/reference/calling/detect-machine + - source: /docs/swml/methods/enter-queue + destination: /docs/swml/reference/calling/enter-queue + - source: /docs/swml/methods/enter_queue + destination: /docs/swml/reference/calling/enter-queue + - source: /docs/swml/methods/execute + destination: /docs/swml/reference/calling/execute + - source: /docs/swml/methods/goto + destination: /docs/swml/reference/calling/goto + - source: /docs/swml/methods/hangup + destination: /docs/swml/reference/calling/hangup + - source: /docs/swml/methods/join-conference + destination: /docs/swml/reference/calling/join-conference + - source: /docs/swml/methods/join-room + destination: /docs/swml/reference/calling/join-room + - source: /docs/swml/methods/join_conference + destination: /docs/swml/reference/calling/join-conference + - source: /docs/swml/methods/join_room + destination: /docs/swml/reference/calling/join-room + - source: /docs/swml/methods/label + destination: /docs/swml/reference/calling/label + - source: /docs/swml/methods/live-transcribe + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live-transcribe/action + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live-transcribe/action/start + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live-transcribe/action/stop + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live-transcribe/action/summarize + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live-translate + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live-translate/action + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live-translate/action/inject + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live-translate/action/start + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live-translate/action/stop + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live-translate/action/summarize + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live_transcribe + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live_transcribe/action + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live_transcribe/action/start + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live_transcribe/action/stop + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live_transcribe/action/summarize + destination: /docs/swml/reference/calling/live-transcribe + - source: /docs/swml/methods/live_translate + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live_translate/action + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live_translate/action/inject + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live_translate/action/start + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live_translate/action/stop + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/live_translate/action/summarize + destination: /docs/swml/reference/calling/live-translate + - source: /docs/swml/methods/pay + destination: /docs/swml/reference/calling/pay + - source: /docs/swml/methods/pay/parameters + destination: /docs/swml/reference/calling/pay + - source: /docs/swml/methods/pay/payment-connector-url + destination: /docs/swml/reference/calling/pay + - source: /docs/swml/methods/pay/payment_connector_url + destination: /docs/swml/reference/calling/pay + - source: /docs/swml/methods/pay/prompts + destination: /docs/swml/reference/calling/pay + - source: /docs/swml/methods/pay/prompts/actions + destination: /docs/swml/reference/calling/pay + - source: /docs/swml/methods/play + destination: /docs/swml/reference/calling/play + - source: /docs/swml/methods/prompt + destination: /docs/swml/reference/calling/prompt + - source: /docs/swml/methods/receive-fax + destination: /docs/swml/reference/calling/receive-fax + - source: /docs/swml/methods/receive_fax + destination: /docs/swml/reference/calling/receive-fax + - source: /docs/swml/methods/record + destination: /docs/swml/reference/calling/record + - source: /docs/swml/methods/record-call + destination: /docs/swml/reference/calling/record-call + - source: /docs/swml/methods/record_call + destination: /docs/swml/reference/calling/record-call + - source: /docs/swml/methods/request + destination: /docs/swml/reference/calling/request + - source: /docs/swml/methods/return + destination: /docs/swml/reference/calling/return + - source: /docs/swml/methods/send-digits + destination: /docs/swml/reference/calling/send-digits + - source: /docs/swml/methods/send-fax + destination: /docs/swml/reference/calling/send-fax + - source: /docs/swml/methods/send-sms + destination: /docs/swml/reference/calling/send-sms + - source: /docs/swml/methods/send_digits + destination: /docs/swml/reference/calling/send-digits + - source: /docs/swml/methods/send_fax + destination: /docs/swml/reference/calling/send-fax + - source: /docs/swml/methods/send_sms + destination: /docs/swml/reference/calling/send-sms + - source: /docs/swml/methods/set + destination: /docs/swml/reference/calling/set + - source: /docs/swml/methods/sip-refer + destination: /docs/swml/reference/calling/sip-refer + - source: /docs/swml/methods/sip_refer + destination: /docs/swml/reference/calling/sip-refer + - source: /docs/swml/methods/sleep + destination: /docs/swml/reference/calling/sleep + - source: /docs/swml/methods/stop-denoise + destination: /docs/swml/reference/calling/stop-denoise + - source: /docs/swml/methods/stop-record-call + destination: /docs/swml/reference/calling/stop-record-call + - source: /docs/swml/methods/stop-tap + destination: /docs/swml/reference/calling/stop-tap + - source: /docs/swml/methods/stop_denoise + destination: /docs/swml/reference/calling/stop-denoise + - source: /docs/swml/methods/stop_record_call + destination: /docs/swml/reference/calling/stop-record-call + - source: /docs/swml/methods/stop_tap + destination: /docs/swml/reference/calling/stop-tap + - source: /docs/swml/methods/switch + destination: /docs/swml/reference/calling/switch + - source: /docs/swml/methods/tap + destination: /docs/swml/reference/calling/tap + - source: /docs/swml/methods/transfer + destination: /docs/swml/reference/calling/transfer + - source: /docs/swml/methods/unset + destination: /docs/swml/reference/calling/unset + - source: /docs/swml/methods/user-event + destination: /docs/swml/reference/calling/user-event + - source: /docs/swml/methods/user_event + destination: /docs/swml/reference/calling/user-event # SWAIG.defaults never had its own page; it is documented on the SWAIG page (#526). - source: /docs/swml/reference/ai/swaig/defaults