nginx.conf

map $http_accept $serve_markdown {
    default         0;
    ~*text/plain    1;
    ~*text/markdown 1;
}

map $request_uri $has_no_extension {
    ~^[^.]*$ 1;
    default  0;
}

server {
    listen 0.0.0.0:8080;
    server_name docs.apify.com docs.apify.loc;

    proxy_set_header X-Real-IP       $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    # comment out the resolver and use localhost:3000 for local development
    set $backend "https://apify.github.io/apify-docs";
    resolver 1.1.1.1 8.8.8.8 valid=30s ipv6=off;

    # Stale Docusaurus chunks: return 410 instead of 404 for missing /assets/{js,css}/*
    # so caches/crawlers drop references to hashed bundles removed by a new deploy.
    # Scoped to dedicated locations per backend so the nice Docusaurus 404 page is
    # preserved for everything else.
    location @gone { return 410; }

    location ~ ^/assets/(js/.+\.js|css/.+\.css)$ {
        proxy_intercept_errors on;
        error_page 404 = @gone;
        proxy_pass $backend$request_uri;
    }

    location = / {
        if ($serve_markdown) {
            rewrite ^ /llms.txt last;
        }
        proxy_pass $backend/;
    }

    location ~ ^/(llms|llms-full)\.txt$ {
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass $backend$uri;
    }

    # Block URLs containing backslash (decoded from %5C by nginx).
    # Without this, the trailing-slash rewrite puts \ in the Location header,
    # and browsers normalize \ to /, turning /\evil.com into //evil.com
    # (a protocol-relative URL that redirects to evil.com).
    # Uses \x5c (hex for 0x5C) to avoid nginx config escaping ambiguity.
    # Regex locations are checked in config order, so this fires before the
    # trailing-slash rewrite below.
    location ~ \x5c {
        return 404;
    }

    # remove trailing slashes from all URLs (except root /)
    # exact match locations (e.g., location = /sdk/js/) take priority over this regex
    location ~ ^(.+)/$ {
        rewrite ^(.+)/$ $1$is_args$args? redirect;
    }

    # @signalwire/docusaurus-plugin-llms-txt 1.2.2 repeats the section prefix in the
    # .md files and llms*.txt it generates for sites served under a sub-path, so links
    # such as /sdk/python/sdk/python/docs/... 404. The five sub-sites still pin ^1.2.2.
    # This redirect makes those links resolve in one hop. Keep it after the sub-sites
    # stop generating them: the doubled URLs stay in search indexes and agent caches.
    # It only collapses a repeated same-section prefix. The plugin also prefixes
    # cross-section links (/sdk/js/cli/docs/...), which this cannot detect.
    location ~ "^/(sdk/js|sdk/python|api/client/js|api/client/python|cli)/\1(/.*)?$" {
        return 301 /$1$2$is_args$args;
    }

    location / {
        set $rewrite_condition "$serve_markdown$has_no_extension";
        set $proxy_path $request_uri;

        if ($rewrite_condition = "11") {
            set $proxy_path "${request_uri}.md";
        }
        proxy_pass $backend$proxy_path;
    }

    ### Repository path: "/sdk/js"

    location ~ ^/sdk/js/(assets/js/.+\.js|assets/css/.+\.css)$ {
        proxy_intercept_errors on;
        error_page 404 = @gone;
        proxy_pass https://apify.github.io/apify-sdk-js/$1;
    }

    location = /sdk/js {
        if ($serve_markdown) {
            rewrite ^ /sdk-js-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-sdk-js/;
    }
    location = /sdk/js/ {
        if ($serve_markdown) {
            rewrite ^ /sdk-js-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-sdk-js/;
    }

    location = /sdk-js-llms.txt {
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-sdk-js/llms.txt;
    }

    location ~ ^/sdk/js/(llms|llms-full)\.txt$ {
        rewrite ^/sdk/js(/.*)$ $1 break;
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-sdk-js$uri;
    }

    location ~ ^/sdk/js/(.*)$ {
        set $path_suffix $1;
        set $proxy_path "/$path_suffix";

        set $rewrite_condition "$serve_markdown$has_no_extension";

        if ($rewrite_condition = "11") {
            set $proxy_path "${proxy_path}.md";
        }

        proxy_pass https://apify.github.io/apify-sdk-js$proxy_path;
    }

    ### Repository path: "/sdk/python"

    location ~ ^/sdk/python/(assets/js/.+\.js|assets/css/.+\.css)$ {
        proxy_intercept_errors on;
        error_page 404 = @gone;
        proxy_pass https://apify.github.io/apify-sdk-python/$1;
    }

    location = /sdk/python {
        if ($serve_markdown) {
            rewrite ^ /sdk-python-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-sdk-python/;
    }
    location = /sdk/python/ {
        if ($serve_markdown) {
            rewrite ^ /sdk-python-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-sdk-python/;
    }

    location = /sdk-python-llms.txt {
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-sdk-python/llms.txt;
    }

    location ~ ^/sdk/python/(llms|llms-full)\.txt$ {
        rewrite ^/sdk/python(/.*)$ $1 break;
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-sdk-python$uri;
    }

    location ~ ^/sdk/python/(.*)$ {
        set $path_suffix $1;
        set $proxy_path "/$path_suffix";

        set $rewrite_condition "$serve_markdown$has_no_extension";

        if ($rewrite_condition = "11") {
            set $proxy_path "${proxy_path}.md";
        }

        proxy_pass https://apify.github.io/apify-sdk-python$proxy_path;
    }

    ### Repository path: "/api/client/js"

    location ~ ^/api/client/js/(assets/js/.+\.js|assets/css/.+\.css)$ {
        proxy_intercept_errors on;
        error_page 404 = @gone;
        proxy_pass https://apify.github.io/apify-client-js/$1;
    }

    location = /api/client/js {
        if ($serve_markdown) {
            rewrite ^ /client-js-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-client-js/;
    }
    location = /api/client/js/ {
        if ($serve_markdown) {
            rewrite ^ /client-js-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-client-js/;
    }

    location = /client-js-llms.txt {
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-client-js/llms.txt;
    }

    location ~ ^/api/client/js/(llms|llms-full)\.txt$ {
        rewrite ^/api/client/js(/.*)$ $1 break;
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-client-js$uri;
    }

    location ~ ^/api/client/js/(.*)$ {
        set $path_suffix $1;
        set $proxy_path "/$path_suffix";

        set $rewrite_condition "$serve_markdown$has_no_extension";

        if ($rewrite_condition = "11") {
            set $proxy_path "${proxy_path}.md";
        }

        proxy_pass https://apify.github.io/apify-client-js$proxy_path;
    }

    ### Repository path: "/api/client/python"

    location ~ ^/api/client/python/(assets/js/.+\.js|assets/css/.+\.css)$ {
        proxy_intercept_errors on;
        error_page 404 = @gone;
        proxy_pass https://apify.github.io/apify-client-python/$1;
    }

    location = /api/client/python {
        if ($serve_markdown) {
            rewrite ^ /client-python-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-client-python/;
    }
    location = /api/client/python/ {
        if ($serve_markdown) {
            rewrite ^ /client-python-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-client-python/;
    }

    location = /client-python-llms.txt {
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-client-python/llms.txt;
    }

    location ~ ^/api/client/python/(llms|llms-full)\.txt$ {
        rewrite ^/api/client/python(/.*)$ $1 break;
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-client-python$uri;
    }

    location ~ ^/api/client/python/(.*)$ {
        set $path_suffix $1;
        set $proxy_path "/$path_suffix";

        set $rewrite_condition "$serve_markdown$has_no_extension";

        if ($rewrite_condition = "11") {
            set $proxy_path "${proxy_path}.md";
        }

        proxy_pass https://apify.github.io/apify-client-python$proxy_path;
    }

    ### Repository path: "/cli"

    location ~ ^/cli/(assets/js/.+\.js|assets/css/.+\.css)$ {
        proxy_intercept_errors on;
        error_page 404 = @gone;
        proxy_pass https://apify.github.io/apify-cli/$1;
    }

    location = /cli {
        if ($serve_markdown) {
            rewrite ^ /cli-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-cli/;
    }
    location = /cli/ {
        if ($serve_markdown) {
            rewrite ^ /cli-llms.txt last;
        }
        proxy_pass https://apify.github.io/apify-cli/;
    }

    location = /cli-llms.txt {
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-cli/llms.txt;
    }

    location ~ ^/cli/(llms|llms-full)\.txt$ {
        rewrite ^/cli(/.*)$ $1 break;
        proxy_hide_header Content-Type;
        add_header Content-Type 'text/markdown; charset=utf-8' always;
        proxy_pass https://apify.github.io/apify-cli$uri;
    }

    location ~ ^/cli/(.*)$ {
        set $path_suffix $1;
        set $proxy_path "/$path_suffix";

        set $rewrite_condition "$serve_markdown$has_no_extension";

        if ($rewrite_condition = "11") {
            set $proxy_path "${proxy_path}.md";
        }

        proxy_pass https://apify.github.io/apify-cli$proxy_path;
    }

    location = /health {
        access_log off;
        add_header 'Content-Type' 'application/json';
        return 200 '{"status":"UP"}';
    }

    # generated via `node tools/convert.mjs` inside the docs repository
    rewrite ^/about$ /platform permanent;
    rewrite ^/access-rights$ /platform/collaboration/access-rights permanent;
    rewrite ^/actor$ /platform/actors permanent;
    rewrite ^/tutorials/integrations$ /platform/integrations permanent;
    rewrite ^/monitoring$ /platform/monitoring permanent;
    rewrite ^/robotic-process-automation$ / permanent;
    rewrite ^/scheduler$ /platform/schedules permanent;
    rewrite ^/schedules$ /platform/schedules permanent;
    rewrite ^/scraping$ /platform/actors/running permanent;
    rewrite ^/tutorials$ /platform/actors/running permanent;
    rewrite ^/web-scraping-101$ /academy/scraping-basics-javascript?legacy-js-course=/ permanent;
    rewrite ^/access-rights/list-of-permissions$ /platform/collaboration/list-of-permissions permanent;
    rewrite ^/access-rights/organization-account$ /platform/collaboration/organization-account permanent;
    rewrite ^/actor/development$ /platform/actors/development permanent;
    rewrite ^/actor/examples$ /platform/actors permanent;
    rewrite ^/actors/examples$ /platform/actors permanent;
    rewrite ^/actor/limits$ /platform/limits permanent;
    rewrite ^/actors/limits$ /platform/limits permanent;
    rewrite ^/actors/paid-actors$ /platform/actors/running/actors-in-store#paid-actors permanent;
    rewrite ^/actor/run$ /platform/actors/running permanent;
    rewrite ^/actor/running$ /platform/actors/running permanent;
    rewrite ^/actors/run$ /platform/actors/running permanent;
    rewrite ^/actor/security$ /platform/security permanent;
    rewrite ^/actors/security$ /platform/security permanent;
    rewrite ^/tasks$ /platform/actors/running/tasks permanent;
    rewrite ^/actors/tasks$ /platform/actors/running/tasks permanent;
    rewrite ^/webhooks$ /platform/integrations/webhooks permanent;
    rewrite ^/monitoring/actor-or-task-run-failure$ /platform/monitoring permanent;
    rewrite ^/monitoring/check-data-quality$ /platform/monitoring permanent;
    rewrite ^/monitoring/monitor-multiple-tasks$ /platform/monitoring permanent;
    rewrite ^/monitoring/monitor-shared-datasets$ /platform/monitoring permanent;
    rewrite ^/robotic-process-automation/tips-and-tricks$ /academy/advanced-web-scraping/tips-and-tricks-robustness permanent;
    rewrite ^/proxy/connection-settings$ /platform/proxy/usage permanent;
    rewrite ^/proxy/residential-proxy/nodejs-examples$ /platform/proxy/residential-proxy permanent;
    rewrite ^/proxy/residential-proxy/python-examples$ /platform/proxy/residential-proxy permanent;
    rewrite ^/proxy/residential-proxy/php-examples$ /platform/proxy/residential-proxy permanent;
    rewrite ^/proxy/troubleshooting$ /platform/proxy permanent;
    rewrite ^/web-scraping-101/anti-scraping-techniques$ /academy/anti-scraping/techniques permanent;
    rewrite ^/web-scraping-101/web-scraping-techniques$ / permanent;
    rewrite ^/access-rights/organization-account/how-to-use$ /platform/collaboration/organization-account/how-to-use permanent;
    rewrite ^/access-rights/organization-account/setup$ /platform/collaboration/organization-account/setup permanent;
    rewrite ^/tutorials/analyze-pages-and-fix-errors$ /academy/node-js/analyzing-pages-and-fixing-errors permanent;
    rewrite ^/tutorials/apify-scrapers$ /academy/apify-scrapers permanent;
    rewrite ^/tutorials/building-public-actors$ /platform/actors/publishing permanent;
    rewrite ^/tutorials/improve-performance-by-caching-repeated-page-data$ /academy/expert-scraping-with-apify/saving-useful-stats permanent;
    rewrite ^/tutorials/cache-data-to-improve-performance$ /academy/expert-scraping-with-apify/saving-useful-stats permanent;
    rewrite ^/tutorials/crawl-a-list-of-urls-from-a-google-sheets-document$ /academy/node-js/scraping-urls-list-from-google-sheets permanent;
    rewrite ^/tutorials/crawl-urls-from-google-sheets-document$ /academy/node-js/scraping-urls-list-from-google-sheets permanent;
    rewrite ^/tutorials/crawl-urls-from-a-google-sheet$ /academy/node-js/scraping-urls-list-from-google-sheets permanent;
    rewrite ^/tutorials/log-in-by-transferring-cookies$ /academy permanent;
    rewrite ^/tutorials/log-into-a-website-using-puppeteer$ /academy/puppeteer-playwright/common-use-cases/logging-into-a-website permanent;
    rewrite ^/tutorials/process-data-using-python$ /academy/python/process-data-using-python permanent;
    rewrite ^/actor/quick-start$ /platform/actors/running permanent;
    rewrite ^/actors/quick-start$ /platform/actors/running permanent;
    rewrite ^/tutorials/quick-start$ /platform/actors/running permanent;
    rewrite ^/tutorials/integrations/run-actor-and-retrieve-data-via-api$ /academy/api/run-actor-and-retrieve-data-via-api permanent;
    rewrite ^/tutorials/run-actor-and-retrieve-data-via-api$ /academy/api/run-actor-and-retrieve-data-via-api permanent;
    rewrite ^/tutorials/scrape-data-using-python$ /academy/python/scrape-data-python permanent;
    rewrite ^/tutorials/scrape-websites-with-limited-pagination$ /academy/advanced-web-scraping/crawling/crawling-with-search permanent;
    rewrite ^/tutorials/scrape-paginated-sites$ /academy/advanced-web-scraping/crawling/crawling-with-search permanent;
    rewrite ^/tutorials/scrape-websites-using-the-sitemap$ /academy/advanced-web-scraping/crawling/crawling-sitemaps permanent;
    rewrite ^/tutorials/scraping-dynamic-content$ /academy/puppeteer-playwright/page/waiting permanent;
    rewrite ^/tutorials/use-apify-from-php$ /academy/php/use-apify-from-php permanent;
    rewrite ^/actors/running/compute-units$ /platform/actors/running/usage-and-resources#what-is-a-compute-unit permanent;
    rewrite ^/actor/running/input-and-output$ /platform/actors/running/input-and-output#input permanent;
    rewrite ^/actors/running/input$ /platform/actors/running/input-and-output#input permanent;
    rewrite ^/actors/memory-and-cpu$ /platform/actors/running/usage-and-resources#memory permanent;
    rewrite ^/actors/running/memory-and-cpu$ /platform/actors/running/usage-and-resources#memory permanent;
    rewrite ^/actors/development/actor-config$ /platform/actors/development/actor-definition/actor-json permanent;
    rewrite ^/actor/development/base-docker-images$ /platform/actors/development/actor-definition/dockerfile permanent;
    rewrite ^/actors/development/base-docker-images$ /platform/actors/development/actor-definition/dockerfile permanent;
    rewrite ^/actor/build$ /platform/actors/development/builds-and-runs/builds permanent;
    rewrite ^/actor/development/build$ /platform/actors/development/builds-and-runs/builds permanent;
    rewrite ^/actor/development/builds$ /platform/actors/development/builds-and-runs/builds permanent;
    rewrite ^/actors/build$ /platform/actors/development/builds-and-runs/builds permanent;
    rewrite ^/actors/development/builds$ /platform/actors/development/builds-and-runs/builds permanent;
    rewrite ^/actors/development/continuous-integration$ /platform/actors/development/deployment/continuous-integration permanent;
    rewrite ^/actor/development/environment-variables$ /platform/actors/development/programming-interface/environment-variables permanent;
    rewrite ^/actors/development/environment-variables$ /platform/actors/development/programming-interface/environment-variables permanent;
    rewrite ^/actor/input-schema$ /platform/actors/development/actor-definition/input-schema/specification/v1 permanent;
    rewrite ^/actor/development/input-schema$ /platform/actors/development/actor-definition/input-schema/specification/v1 permanent;
    rewrite ^/actors/input-schema$ /platform/actors/development/actor-definition/input-schema/specification/v1 permanent;
    rewrite ^/actors/development/input-schema$ /platform/actors/development/actor-definition/input-schema/specification/v1 permanent;
    rewrite ^/actors/development/output-schema$ /platform/actors/development/actor-definition/output-schema permanent;
    rewrite ^/actors/development/secret-input$ /platform/actors/development/actor-definition/input-schema/secret-input permanent;
    rewrite ^/actor/source-code$ /platform/actors/development/deployment/source-types permanent;
    rewrite ^/actors/source-code$ /platform/actors/development/deployment/source-types permanent;
    rewrite ^/actor/development/source-code$ /platform/actors/development/deployment/source-types permanent;
    rewrite ^/actors/development/source-code$ /platform/actors/development/deployment/source-types permanent;
    rewrite ^/actor/development/state-persistence$ /platform/actors/development/builds-and-runs/state-persistence permanent;
    rewrite ^/actors/development/state-persistence$ /platform/actors/development/builds-and-runs/state-persistence permanent;
    rewrite ^/actors/development/testing-and-maintenance$ /platform/actors/development/automated-tests permanent;
    rewrite ^/webhooks/actions$ /platform/integrations/webhooks/actions permanent;
    rewrite ^/webhooks/ad-hoc-webhooks$ /platform/integrations/webhooks/ad-hoc-webhooks permanent;
    rewrite ^/webhooks/events$ /platform/integrations/webhooks/events permanent;
    rewrite ^/proxy/datacenter-proxy/nodejs-examples$ /platform/proxy/datacenter-proxy permanent;
    rewrite ^/proxy/datacenter-proxy/python-examples$ /platform/proxy/datacenter-proxy permanent;
    rewrite ^/proxy/datacenter-proxy/php-examples$ /platform/proxy/datacenter-proxy permanent;
    rewrite ^/proxy/datacenter-proxy/examples$ /platform/proxy/datacenter-proxy permanent;
    rewrite ^/proxy/google-serp-proxy/nodejs-examples$ /platform/proxy/google-serp-proxy permanent;
    rewrite ^/proxy/google-serp-proxy/python-examples$ /platform/proxy/google-serp-proxy permanent;
    rewrite ^/proxy/google-serp-proxy/php-examples$ /platform/proxy/google-serp-proxy permanent;
    rewrite ^/proxy/google-serp-proxy/examples$ /platform/proxy/google-serp-proxy permanent;
    rewrite ^/proxy/residential-proxy/tips-and-tricks$ /platform/proxy/residential-proxy permanent;
    rewrite ^/platform/proxy/residential-proxy/tips-and-tricks$ /platform/proxy/residential-proxy permanent;
    rewrite ^/scraping/cheerio-scraper$ /academy/apify-scrapers/cheerio-scraper permanent;
    rewrite ^/tutorials/apify-scrapers/cheerio-scraper$ /academy/apify-scrapers/cheerio-scraper permanent;
    rewrite ^/scraping/getting-started$ /academy/apify-scrapers/getting-started permanent;
    rewrite ^/tutorials/apify-scrapers/getting-started$ /academy/apify-scrapers/getting-started permanent;
    rewrite ^/scraping/puppeteer-scraper$ /academy/apify-scrapers/puppeteer-scraper permanent;
    rewrite ^/tutorials/apify-scrapers/puppeteer-scraper$ /academy/apify-scrapers/puppeteer-scraper permanent;
    rewrite ^/scraping/web-scraper$ /academy/apify-scrapers/web-scraper permanent;
    rewrite ^/tutorials/apify-scrapers/web-scraper$ /academy/apify-scrapers/web-scraper permanent;

    rewrite ^/academy/apify-platform/deploying-your-code$ /academy/deploying-your-code permanent;
    rewrite ^/academy/apify-platform/get-most-of-actors$ /academy/actor-marketing-playbook/promote-your-actor/checklist permanent;
    rewrite ^/academy/apify-platform/getting-started$ /academy/getting-started permanent;
    rewrite ^/academy/apify-platform/running-a-web-server$ /academy/running-a-web-server permanent;
    rewrite ^/academy/apify-platform/deploying-your-code/deploying$ /academy/deploying-your-code/deploying permanent;
    rewrite ^/academy/apify-platform/deploying-your-code/docker-file$ /academy/deploying-your-code/docker-file permanent;
    rewrite ^/academy/apify-platform/deploying-your-code/input-schema$ /academy/deploying-your-code/input-schema permanent;
    rewrite ^/academy/apify-platform/deploying-your-code/inputs-outputs$ /academy/deploying-your-code/inputs-outputs permanent;
    rewrite ^/academy/apify-platform/get-most-of-actors/actor-readme$ /actors/publishing/actor-readme permanent;
    rewrite ^/academy/apify-platform/get-most-of-actors/monetizing-your-actor$ /actors/monetize permanent;
    rewrite ^/academy/apify-platform/get-most-of-actors/naming-your-actor$ /academy/actor-marketing-playbook/actor-basics/name-your-actor permanent;
    rewrite ^/academy/apify-platform/get-most-of-actors/seo-and-promotion$ /academy/actor-marketing-playbook/promote-your-actor/seo permanent;
    rewrite ^/academy/apify-platform/getting-started/actors$ /academy/getting-started/actors permanent;
    rewrite ^/academy/apify-platform/getting-started/apify-api$ /academy/getting-started/apify-api permanent;
    rewrite ^/academy/apify-platform/getting-started/apify-client$ /academy/getting-started/apify-client permanent;
    rewrite ^/academy/apify-platform/getting-started/creating-actors$ /academy/getting-started/creating-actors permanent;
    rewrite ^/academy/apify-platform/getting-started/inputs-outputs$ /academy/getting-started/inputs-outputs permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection$ /academy/scraping-basics-javascript/devtools-inspecting?legacy-js-course=/data-collection permanent;
    rewrite ^/academy/puppeteer-playwright/executing-scripts/extracting-data$ /academy/puppeteer-playwright/executing-scripts/collecting-data permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection/browser-devtools$ /academy/scraping-basics-javascript/devtools-inspecting?legacy-js-course=/data-collection/browser-devtools permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection/computer-preparation$ /academy/scraping-basics-javascript/downloading-html?legacy-js-course=/data-collection/computer-preparation permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection/devtools-continued$ /academy/scraping-basics-javascript/devtools-extracting-data?legacy-js-course=/data-collection/devtools-continued permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection/node-continued$ /academy/scraping-basics-javascript/extracting-data?legacy-js-course=/data-collection/node-continued permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection/node-js-scraper$ /academy/scraping-basics-javascript/downloading-html?legacy-js-course=/data-collection/node-js-scraper permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection/project-setup$ /academy/scraping-basics-javascript/downloading-html?legacy-js-course=/data-collection/project-setup permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection/save-to-csv$ /academy/scraping-basics-javascript/saving-data?legacy-js-course=/data-collection/save-to-csv permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-collection/using-devtools$ /academy/scraping-basics-javascript/devtools-locating-elements?legacy-js-course=/data-collection/using-devtools permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/processing-data$ /academy/scraping-basics-javascript/framework?legacy-js-course=/crawling/processing-data permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/recap-collection-basics$ /academy/scraping-basics-javascript/extracting-data?legacy-js-course=/crawling/recap-collection-basics permanent;
    rewrite ^/academy/php/using-apify-scraper-with-php$ /academy/php/use-apify-from-php permanent;
    rewrite ^/api/client/?$ /api redirect;

    # unified api clients docs pages -> getting started page
    rewrite ^/api/client/python/docs/quick-start$ /api/client/python/docs permanent;
    rewrite ^/api/client/python/docs/features$ /api/client/python/docs permanent;
    rewrite ^/api/client/python/docs/usage-concepts$ /api/client/python/docs permanent;

    rewrite ^/api/client/js/docs/quick-start$ /api/client/js/docs permanent;
    rewrite ^/api/client/js/docs/features$ /api/client/js/docs permanent;
    rewrite ^/api/client/js/docs/usage-concepts$ /api/client/js/docs permanent;

    # sdk/js/api -> sdk/js/reference
    rewrite ^/sdk/js/api/apify(.*)$ /sdk/js/reference$1 permanent;
    rewrite ^/sdk/js/api(.*)$ /sdk/js/reference$1 permanent;
    rewrite ^/sdk/js/reference/apify(.*)$ /sdk/js/reference$1 redirect;
    rewrite ^/sdk/js/reference/next/apify(.*)$ /sdk/js/reference/next$1 redirect;
    rewrite ^/sdk/js/docs$ /sdk/js/docs/overview redirect;
    rewrite ^/sdk/js/docs/next$ /sdk/js/docs/next/overview redirect;
    rewrite ^/sdk/js/docs/guides/getting-started$ /sdk/js/docs/overview redirect;
    rewrite ^/sdk/js/docs/next/guides/getting-started$ /sdk/js/docs/next/overview redirect;
    rewrite ^/sdk/js/docs/guides/apify-platform$ /sdk/js/docs/overview redirect;
    rewrite ^/sdk/js/docs/next/guides/apify-platform$ /sdk/js/docs/next/overview redirect;

    # SDK JS guides -> concepts restructuring (apify-sdk-js#542)
    rewrite ^/sdk/js/docs/guides/actor-lifecycle$ /sdk/js/docs/concepts/actor-lifecycle permanent;
    rewrite ^/sdk/js/docs/next/guides/actor-lifecycle$ /sdk/js/docs/next/concepts/actor-lifecycle permanent;
    rewrite ^/sdk/js/docs/guides/request-storage$ /sdk/js/docs/concepts/request-storage permanent;
    rewrite ^/sdk/js/docs/next/guides/request-storage$ /sdk/js/docs/next/concepts/request-storage permanent;
    rewrite ^/sdk/js/docs/guides/result-storage$ /sdk/js/docs/concepts/result-storage permanent;
    rewrite ^/sdk/js/docs/next/guides/result-storage$ /sdk/js/docs/next/concepts/result-storage permanent;
    rewrite ^/sdk/js/docs/guides/proxy-management$ /sdk/js/docs/concepts/proxy-management permanent;
    rewrite ^/sdk/js/docs/next/guides/proxy-management$ /sdk/js/docs/next/concepts/proxy-management permanent;
    rewrite ^/sdk/js/docs/guides/session-management$ /sdk/js/docs/concepts/session-management permanent;
    rewrite ^/sdk/js/docs/next/guides/session-management$ /sdk/js/docs/next/concepts/session-management permanent;
    rewrite ^/sdk/js/docs/guides/environment-variables$ /sdk/js/docs/concepts/environment-variables permanent;
    rewrite ^/sdk/js/docs/next/guides/environment-variables$ /sdk/js/docs/next/concepts/environment-variables permanent;
    rewrite ^/sdk/js/docs/guides/docker-images$ /sdk/js/docs/concepts/docker-images permanent;
    rewrite ^/sdk/js/docs/next/guides/docker-images$ /sdk/js/docs/next/concepts/docker-images permanent;
    rewrite ^/sdk/js/docs/guides/pay-per-event$ /sdk/js/docs/concepts/pay-per-event permanent;
    rewrite ^/sdk/js/docs/next/guides/pay-per-event$ /sdk/js/docs/next/concepts/pay-per-event permanent;

    # SDK JS examples -> guides restructuring (apify-sdk-js#542)
    rewrite ^/sdk/js/docs/examples/accept-user-input$ /sdk/js/docs/guides/accept-user-input permanent;
    rewrite ^/sdk/js/docs/examples/add-data-to-dataset$ /sdk/js/docs/guides/add-data-to-dataset permanent;
    rewrite ^/sdk/js/docs/examples/basic-crawler$ /sdk/js/docs/guides/basic-crawler permanent;
    rewrite ^/sdk/js/docs/examples/call-actor$ /sdk/js/docs/guides/call-actor permanent;
    rewrite ^/sdk/js/docs/examples/cheerio-crawler$ /sdk/js/docs/guides/cheerio-crawler permanent;
    rewrite ^/sdk/js/docs/examples/crawl-all-links$ /sdk/js/docs/guides/crawl-all-links permanent;
    rewrite ^/sdk/js/docs/examples/crawl-multiple-urls$ /sdk/js/docs/guides/crawl-multiple-urls permanent;
    rewrite ^/sdk/js/docs/examples/crawl-relative-links$ /sdk/js/docs/guides/crawl-relative-links permanent;
    rewrite ^/sdk/js/docs/examples/crawl-single-url$ /sdk/js/docs/guides/crawl-single-url permanent;
    rewrite ^/sdk/js/docs/examples/crawl-sitemap$ /sdk/js/docs/guides/crawl-sitemap permanent;
    rewrite ^/sdk/js/docs/examples/crawl-some-links$ /sdk/js/docs/guides/crawl-some-links permanent;
    rewrite ^/sdk/js/docs/examples/forms$ /sdk/js/docs/guides/forms permanent;
    rewrite ^/sdk/js/docs/examples/map-and-reduce$ /sdk/js/docs/guides/map-and-reduce permanent;
    rewrite ^/sdk/js/docs/examples/playwright-crawler$ /sdk/js/docs/guides/playwright-crawler permanent;
    rewrite ^/sdk/js/docs/examples/puppeteer-capture-screenshot$ /sdk/js/docs/guides/puppeteer-capture-screenshot permanent;
    rewrite ^/sdk/js/docs/examples/puppeteer-crawler$ /sdk/js/docs/guides/puppeteer-crawler permanent;
    rewrite ^/sdk/js/docs/examples/puppeteer-recursive-crawl$ /sdk/js/docs/guides/puppeteer-recursive-crawl permanent;
    rewrite ^/sdk/js/docs/examples/puppeteer-with-proxy$ /sdk/js/docs/guides/puppeteer-with-proxy permanent;

    # SDK JS renamed guide page (apify-sdk-js#542)
    rewrite ^/sdk/js/docs/guides/type-script-actor$ /sdk/js/docs/guides/typescript-setup permanent;
    rewrite ^/sdk/js/docs/next/guides/type-script-actor$ /sdk/js/docs/next/guides/typescript-setup permanent;

    # SDK JS removed category index pages (apify-sdk-js#542)
    rewrite ^/sdk/js/docs/examples/?$ /sdk/js/docs/overview permanent;
    rewrite ^/sdk/js/docs/next/examples/?$ /sdk/js/docs/next/overview permanent;
    rewrite ^/sdk/js/docs/upgrading/?$ /sdk/js/docs/overview permanent;
    rewrite ^/sdk/js/docs/next/upgrading/?$ /sdk/js/docs/next/overview permanent;

    # old sdk version redirects (we keep only latest, and version only major/minor)
    rewrite ^/sdk/js/docs/1\.\d+\.\d+(.*)$ /sdk/js/docs/1.3$1 redirect;
    rewrite ^/sdk/js/docs/2\.\d+\.\d+(.*)$ /sdk/js/docs/2.3$1 redirect;
    rewrite ^/sdk/js/docs/api(.*)$ /sdk/js/docs/2.3/api$1 redirect;
    rewrite ^/sdk/js/docs/typedefs(.*)$ /sdk/js/docs/2.3/typedefs$1 redirect;

    # old integrated docs -> new docs in GH pages
    rewrite ^/apify-client-js/?$ /api/client/js/docs redirect;
    rewrite ^/apify-client-js/latest/?$ /api/client/js/docs redirect;
    rewrite ^/apify-client-python/?$ /api/client/python/docs redirect;

    # Landing page removal redirects - redirect root paths to docs pages
    rewrite ^/api/client/js/?$ /api/client/js/docs permanent;
    rewrite ^/api/client/python/?$ /api/client/python/docs permanent;
    rewrite ^/sdk/js/?$ /sdk/js/docs/overview permanent;
    rewrite ^/sdk/python/?$ /sdk/python/docs/overview permanent;
    rewrite ^/cli/?$ /cli/docs permanent;

    # versions page redirects
    rewrite ^/versions/?$ / permanent; # no docs-wide changelog, redirect to the root
    rewrite ^/cli/versions/?$ /cli/docs/changelog permanent;
    rewrite ^/sdk/js/versions/?$ /sdk/js/docs/changelog permanent;
    rewrite ^/api/client/js/versions/?$ /api/client/js/docs/changelog permanent;

    # legacy links in some Actor READMEs
    rewrite ^/scraping/tutorial/introduction$ /academy/apify-scrapers/getting-started permanent;
    rewrite ^/scraping/tutorial/web-scraper$ /academy/apify-scrapers/web-scraper permanent;

    # apify-client-js restructuring
    rewrite ^/api/client/js/docs/getting-started$ /api/client/js/docs/introduction/quick-start permanent;
    rewrite ^/api/client/js/docs/examples$ /api/client/js/docs/guides/examples permanent;

    # Articles moved from the platform documentation to the Academy
    # Web Scraping 101
    rewrite ^/platform/web-scraping-101$                              /academy/scraping-basics-javascript?legacy-js-course=/ redirect;
    rewrite ^/platform/web-scraping-101/anti-scraping-techniques$     /academy/anti-scraping/techniques redirect;
    rewrite ^/platform/web-scraping-101/web-scraping-techniques$      / redirect;
    # RPA
    rewrite ^/platform/robotic-process-automation$                    / redirect;
    rewrite ^/platform/robotic-process-automation/tips-and-tricks$    /academy/advanced-web-scraping/tips-and-tricks-robustness redirect;
    # Tutorials
    rewrite ^/platform/tutorials/scraping-dynamic-content$            /academy/puppeteer-playwright/page/waiting redirect;
    rewrite ^/platform/tutorials/log-into-a-website-using-puppeteer$  /academy/puppeteer-playwright/common-use-cases/logging-into-a-website redirect;
    rewrite ^/platform/tutorials/cache-data-to-improve-performance$   /academy/expert-scraping-with-apify/saving-useful-stats redirect;
    rewrite ^/platform/tutorials/scrape-websites-using-the-sitemap$   /academy/advanced-web-scraping/crawling/crawling-sitemaps redirect;
    rewrite ^/platform/tutorials/analyze-pages-and-fix-errors$        /academy/node-js/analyzing-pages-and-fixing-errors redirect;
    rewrite ^/platform/tutorials/crawl-urls-from-a-google-sheet$      /academy/node-js/scraping-urls-list-from-google-sheets redirect;
    rewrite ^/platform/tutorials/log-in-by-transferring-cookies$      /academy redirect;
    rewrite ^/platform/tutorials/scrape-data-using-python$            /academy/python/scrape-data-python redirect;
    rewrite ^/platform/tutorials/process-data-using-python$           /academy/python/process-data-using-python redirect;
    rewrite ^/platform/tutorials/use-apify-from-php$                  /academy/php/use-apify-from-php redirect;
    rewrite ^/platform/tutorials/scrape-paginated-sites$              /academy/advanced-web-scraping/crawling/crawling-with-search redirect;
    rewrite ^/platform/tutorials/apify-scrapers$                      /academy/apify-scrapers redirect;
    rewrite ^/platform/tutorials/apify-scrapers/getting-started$      /academy/apify-scrapers/getting-started redirect;
    rewrite ^/platform/tutorials/apify-scrapers/web-scraper$          /academy/apify-scrapers/web-scraper redirect;
    rewrite ^/platform/tutorials/apify-scrapers/cheerio-scraper$      /academy/apify-scrapers/cheerio-scraper redirect;
    rewrite ^/platform/tutorials/apify-scrapers/puppeteer-scraper$    /academy/apify-scrapers/puppeteer-scraper redirect;
    rewrite ^/platform/tutorials/run-actor-and-retrieve-data-via-api$	/academy/api/run-actor-and-retrieve-data-via-api redirect;

    # Reorganization of docs: Basic
    rewrite ^/platform/tutorials/building-public-actors$ /platform/actors/publishing redirect;
    rewrite ^/platform/actors/paid-actors$               /platform/actors/running/actors-in-store#paid-actors redirect;
    rewrite ^/platform/actors/tasks$                     /platform/actors/running/tasks redirect;
    rewrite ^/platform/actors/running/compute-units$     /platform/actors/running/usage-and-resources#what-is-a-compute-unit redirect;
    rewrite ^/platform/actors/running/memory-and-cpu$    /platform/actors/running/usage-and-resources#memory redirect;
    rewrite ^/platform/actors/running/input$             /platform/actors/running/input-and-output#input redirect;
    rewrite ^/platform/actors/security$                  /platform/security redirect;
    rewrite ^/platform/actors/limits$                    /platform/limits redirect;
    # storage/usage page merged into the storage hub
    rewrite ^/platform/storage/usage$                    /platform/storage permanent;
    # proxy/usage page merged into the proxy hub
    rewrite ^/platform/proxy/usage$                      /platform/proxy permanent;

    # Reorganization of docs: Home
    rewrite ^/platform/about$                 /platform redirect;
    rewrite ^/platform/tutorials/quick-start$ /platform/actors/running redirect;
    rewrite ^/platform/tutorials$             /platform/actors/running redirect;

    # Reorganization of docs: Access rights
    rewrite ^/platform/access-rights$                                 /platform/collaboration/access-rights redirect;
    rewrite ^/platform/access-rights/organization-account$            /platform/collaboration/organization-account redirect;
    rewrite ^/platform/access-rights/organization-account/setup$      /platform/collaboration/organization-account/setup redirect;
    rewrite ^/platform/access-rights/organization-account/how-to-use$ /platform/collaboration/organization-account/how-to-use redirect;
    rewrite ^/platform/access-rights/list-of-permissions$             /platform/collaboration/list-of-permissions redirect;

    # Reorganization of development section
    rewrite ^/platform/actors/development/actor-config$            /platform/actors/development/actor-definition/actor-json redirect;
    rewrite ^/platform/actors/development/base-docker-images$      /platform/actors/development/actor-definition/dockerfile redirect;
    rewrite ^/platform/actors/development/secret-input$            /platform/actors/development/actor-definition/input-schema/secret-input redirect;
    rewrite ^/platform/actors/development/input-schema$            /platform/actors/development/actor-definition/input-schema/specification/v1 redirect;
    rewrite ^/platform/actors/development/output-schema$           /platform/actors/development/actor-definition/output-schema redirect;
    rewrite ^/platform/actors/development/container-web-server$    /platform/actors/development/programming-interface/container-web-server redirect;
    rewrite ^/platform/actors/development/environment-variables$   /platform/actors/development/programming-interface/environment-variables redirect;
    rewrite ^/platform/actors/development/builds$                  /platform/actors/development/builds-and-runs/builds redirect;
    rewrite ^/platform/actors/development/state-persistence$       /platform/actors/development/builds-and-runs/state-persistence redirect;
    rewrite ^/platform/actors/development/continuous-integration$  /platform/actors/development/deployment/continuous-integration redirect;
    rewrite ^/platform/actors/development/testing-and-maintenance$ /platform/actors/development/automated-tests redirect;
    rewrite ^/platform/actors/development/source-code$             /platform/actors/development/deployment/source-types redirect;

    # Academy restructuring
    rewrite ^/academy/advanced-web-scraping/scraping-paginated-sites$ /academy/advanced-web-scraping/crawling/crawling-with-search permanent;
    rewrite ^/academy/php$ /academy/php/use-apify-from-php redirect;  # not permanent in case we want to reuse /php in the future

    # Academy: replacing the 'Web Scraping for Beginners' course
    rewrite ^/academy/web-scraping-for-beginners/best-practices$ /academy/scraping-basics-javascript?legacy-js-course=/best-practices permanent;
    rewrite ^/academy/web-scraping-for-beginners/introduction$ /academy/scraping-basics-javascript?legacy-js-course=/introduction permanent;
    rewrite ^/academy/web-scraping-for-beginners/challenge/initializing-and-setting-up$ /academy/scraping-basics-javascript?legacy-js-course=/challenge/initializing-and-setting-up permanent;
    rewrite ^/academy/web-scraping-for-beginners/challenge/modularity$ /academy/scraping-basics-javascript?legacy-js-course=/challenge/modularity permanent;
    rewrite ^/academy/web-scraping-for-beginners/challenge/scraping-amazon$ /academy/scraping-basics-javascript?legacy-js-course=/challenge/scraping-amazon permanent;
    rewrite ^/academy/web-scraping-for-beginners/challenge$ /academy/scraping-basics-javascript?legacy-js-course=/challenge permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/exporting-data$ /academy/scraping-basics-javascript/framework?legacy-js-course=/crawling/exporting-data permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/filtering-links$ /academy/scraping-basics-javascript/getting-links?legacy-js-course=/crawling/filtering-links permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/finding-links$ /academy/scraping-basics-javascript/getting-links?legacy-js-course=/crawling/finding-links permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/first-crawl$ /academy/scraping-basics-javascript/crawling?legacy-js-course=/crawling/first-crawl permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/headless-browser$ /academy/scraping-basics-javascript?legacy-js-course=/crawling/headless-browser permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/pro-scraping$ /academy/scraping-basics-javascript/framework?legacy-js-course=/crawling/pro-scraping permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/recap-extraction-basics$ /academy/scraping-basics-javascript/extracting-data?legacy-js-course=/crawling/recap-extraction-basics permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/relative-urls$ /academy/scraping-basics-javascript/getting-links?legacy-js-course=/crawling/relative-urls permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling/scraping-the-data$ /academy/scraping-basics-javascript/scraping-variants?legacy-js-course=/crawling/scraping-the-data permanent;
    rewrite ^/academy/web-scraping-for-beginners/crawling$ /academy/scraping-basics-javascript/crawling?legacy-js-course=/crawling permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction/browser-devtools$ /academy/scraping-basics-javascript/devtools-inspecting?legacy-js-course=/data-extraction/browser-devtools permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction/computer-preparation$ /academy/scraping-basics-javascript/downloading-html?legacy-js-course=/data-extraction/computer-preparation permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction/devtools-continued$ /academy/scraping-basics-javascript/devtools-extracting-data?legacy-js-course=/data-extraction/devtools-continued permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction/node-continued$ /academy/scraping-basics-javascript/extracting-data?legacy-js-course=/data-extraction/node-continued permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction/node-js-scraper$ /academy/scraping-basics-javascript/downloading-html?legacy-js-course=/data-extraction/node-js-scraper permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction/project-setup$ /academy/scraping-basics-javascript/downloading-html?legacy-js-course=/data-extraction/project-setup permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction/save-to-csv$ /academy/scraping-basics-javascript/saving-data?legacy-js-course=/data-extraction/save-to-csv permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction/using-devtools$ /academy/scraping-basics-javascript/devtools-locating-elements?legacy-js-course=/data-extraction/using-devtools permanent;
    rewrite ^/academy/web-scraping-for-beginners/data-extraction$ /academy/scraping-basics-javascript/devtools-inspecting?legacy-js-course=/data-extraction permanent;
    rewrite ^/academy/web-scraping-for-beginners$ /academy/scraping-basics-javascript?legacy-js-course=/ permanent;

    # Removed pages
    # GPT plugins were discontinued April 9th, 2024 - https://help.openai.com/en/articles/8988022-winding-down-the-chatgpt-plugins-beta
    rewrite ^/platform/integrations/chatgpt-plugin$            https://blog.apify.com/add-custom-actions-to-your-gpts/ redirect;
    # TypeScript course was removed from the Academy - https://github.com/apify/apify-docs/pull/1552
    rewrite ^/academy/switching-to-typescript(/.*)?$           https://apify.com/templates/categories/typescript permanent;
    # Airtable console integration was removed
    rewrite ^/platform/integrations/airtable/console$         /platform/integrations/airtable permanent;

    # Glossary has been removed
    rewrite ^/academy/glossary(/.*)?$ / permanent;
    rewrite ^/academy/concepts(/.*)?$ / permanent;
    rewrite ^/academy/tools(/.*)?$ / permanent;

    # Python docs

    # apify-client-python restructuring

    rewrite ^/api/client/python/docs/overview$ /api/client/python/docs permanent;
    rewrite ^/api/client/python/docs/examples/passing-input-to-actor$ /api/client/python/docs/guides/passing-input-to-actor permanent;
    rewrite ^/api/client/python/docs/examples/manage-tasks-for-reusable-input$ /api/client/python/docs/guides/manage-tasks-for-reusable-input permanent;
    rewrite ^/api/client/python/docs/examples/retrieve-actor-data$ /api/client/python/docs/guides/retrieve-actor-data permanent;
    rewrite ^/api/client/python/docs/examples/integration-with-data-libraries$ /api/client/python/docs/guides/integration-with-data-libraries permanent;

    # API docs reorganization

    # Actor Collection & Object to Actors
    rewrite ^/api/v2/actors-actor-collection$ /api/v2/actors permanent;
    rewrite ^/api/v2/actors-actor-object$ /api/v2/actors permanent;

    # Actor Version Collection & Object to Actors Actor Versions
    rewrite ^/api/v2/actors-version-collection$ /api/v2/actors-actor-versions permanent;
    rewrite ^/api/v2/actors-version-object$ /api/v2/actors-actor-versions permanent;

    # Actor Environment Variable Collection & Object to Actors Actor Versions
    rewrite ^/api/v2/actors-environment-variable-collection$ /api/v2/actors-actor-versions permanent;
    rewrite ^/api/v2/actors-environment-variable-object$ /api/v2/actors-actor-versions permanent;

    # Actor Build Collection, Object, Default Build, and Abort Build to Actors Actor Builds
    rewrite ^/api/v2/actors-build-collection$ /api/v2/actors-actor-builds permanent;
    rewrite ^/api/v2/actors-build-object$ /api/v2/actors-actor-builds permanent;
    rewrite ^/api/v2/actors-default-build-object$ /api/v2/actors-actor-builds permanent;
    rewrite ^/api/v2/actors-abort-build$ /api/v2/actors-actor-builds permanent;

    # Actor Run Collection, Object, Synchronous Runs, and Related Actions to Actors Actor Runs
    rewrite ^/api/v2/actors-run-collection$ /api/v2/actors-actor-runs permanent;
    rewrite ^/api/v2/actors-run-object$ /api/v2/actors-actor-runs permanent;
    rewrite ^/api/v2/actors-run-actor-synchronously$ /api/v2/actors-actor-runs permanent;
    rewrite ^/api/v2/actors-run-actor-synchronously-and-get-dataset-items$ /api/v2/actors-actor-runs permanent;
    rewrite ^/api/v2/actors-abort-run$ /api/v2/actors-actor-runs permanent;
    rewrite ^/api/v2/actors-metamorph-run$ /api/v2/actors-actor-runs permanent;
    rewrite ^/api/v2/actors-resurrect-run$ /api/v2/actors-actor-runs permanent;
    rewrite ^/api/v2/actors-last-run-object-and-its-storages$ /api/v2/actors-actor-runs permanent;

    # Actor Tasks Task Collection, Object, Input Object, Webhook, Run Collection, and Synchronous Actions to Actor Tasks
    rewrite ^/api/v2/actor-tasks-task-collection$ /api/v2/actor-tasks permanent;
    rewrite ^/api/v2/actor-tasks-task-object$ /api/v2/actor-tasks permanent;
    rewrite ^/api/v2/actor-tasks-task-input-object$ /api/v2/actor-tasks permanent;
    rewrite ^/api/v2/actor-tasks-webhook-collection$ /api/v2/actor-tasks permanent;
    rewrite ^/api/v2/actor-tasks-run-collection$ /api/v2/actor-tasks permanent;
    rewrite ^/api/v2/actor-tasks-run-task-synchronously$ /api/v2/actor-tasks permanent;
    rewrite ^/api/v2/actor-tasks-run-task-synchronously-and-get-dataset-items$ /api/v2/actor-tasks permanent;

    # Datasets Dataset Collection, Dataset, Item Collection, and Statistics to Storage Datasets
    rewrite ^/api/v2/datasets-dataset-collection$ /api/v2/storage-datasets permanent;
    rewrite ^/api/v2/datasets-dataset$ /api/v2/storage-datasets permanent;
    rewrite ^/api/v2/datasets-item-collection$ /api/v2/storage-datasets permanent;
    rewrite ^/api/v2/datasets-statistics$ /api/v2/storage-datasets permanent;

    # Key-Value Stores Store Collection, Store Object, Key Collection, and Record to Storage Key-Value Stores
    rewrite ^/api/v2/key-value-stores-store-collection$ /api/v2/storage-key-value-stores permanent;
    rewrite ^/api/v2/key-value-stores-store-object$ /api/v2/storage-key-value-stores permanent;
    rewrite ^/api/v2/key-value-stores-key-collection$ /api/v2/storage-key-value-stores permanent;
    rewrite ^/api/v2/key-value-stores-record$ /api/v2/storage-key-value-stores permanent;

    # Request Queues Queue Collection, Queue, and Batch Request Operations to Storage Request Queues
    rewrite ^/api/v2/request-queues-queue-collection$ /api/v2/storage-request-queues permanent;
    rewrite ^/api/v2/request-queues-queue$ /api/v2/storage-request-queues permanent;
    rewrite ^/api/v2/request-queues-batch-request-operations$ /api/v2/storage-request-queues permanent;

    # Request Queues Request Collection to Storage Request Queues Requests
    rewrite ^/api/v2/request-queues-request-collection$ /api/v2/storage-request-queues-requests permanent;

    # Request Queues Queue Head, Queue Head With Locks, and Request Lock to Storage Request Queues Requests Locks
    rewrite ^/api/v2/request-queues-queue-head$ /api/v2/storage-request-queues-requests-locks permanent;
    rewrite ^/api/v2/request-queues-queue-head-with-locks$ /api/v2/storage-request-queues-requests-locks permanent;
    rewrite ^/api/v2/request-queues-request-lock$ /api/v2/storage-request-queues-requests-locks permanent;

    # Webhooks Webhook Collection, Webhook Object, Webhook Test, and Dispatches Collection to Webhooks Webhooks
    rewrite ^/api/v2/webhooks-webhook-collection$ /api/v2/webhooks-webhooks permanent;
    rewrite ^/api/v2/webhooks-webhook-object$ /api/v2/webhooks-webhooks permanent;
    rewrite ^/api/v2/webhooks-webhook-test$ /api/v2/webhooks-webhooks permanent;
    rewrite ^/api/v2/webhooks-dispatches-collection$ /api/v2/webhooks-webhooks permanent;

    # Webhook Dispatches Collection and Dispatch Object to Webhooks Webhook Dispatches
    rewrite ^/api/v2/webhook-dispatches-webhook-dispatches-collection$ /api/v2/webhooks-webhook-dispatches permanent;
    rewrite ^/api/v2/webhook-dispatches-webhook-dispatch-object$ /api/v2/webhooks-webhook-dispatches permanent;

    # Schedules Collection, Schedule Object, and Schedule Log to Schedules
    rewrite ^/api/v2/schedules-schedules-collection$ /api/v2/schedules permanent;
    rewrite ^/api/v2/schedules-schedule-object$ /api/v2/schedules permanent;
    rewrite ^/api/v2/schedules-schedule-log$ /api/v2/schedules permanent;

    # Store Store Actors Collection to Store
    rewrite ^/api/v2/store-store-actors-collection$ /api/v2/store permanent;

    # Logs Log to Logs
    rewrite ^/api/v2/logs-log$ /api/v2/logs permanent;

    # Users Public Data, Private Data, Monthly Usage, and Account and Usage Limits to Users
    rewrite ^/api/v2/users-public-data$ /api/v2/users permanent;
    rewrite ^/api/v2/users-private-data$ /api/v2/users permanent;
    rewrite ^/api/v2/users-monthly-usage$ /api/v2/users permanent;
    rewrite ^/api/v2/users-account-and-usage-limits$ /api/v2/users permanent;

    # Actor API reference operation pages: legacy `act-*`/`acts-*` slugs were renamed. Slug rule:
    # operations on an Actor's own /runs and /builds collections use `actors-*` (mirroring
    # /v2/actors/{actorId}/...), because the account-wide /v2/actor-runs and /v2/actor-builds
    # families already own the `actor-runs-*`/`actor-builds-*` slugs; deeper scoped sub-resources
    # (runs/last, run-sync, builds/default, versions, webhooks) use the `actor-*` member prefix.
    # The first rule must stay above the act- catch-all; anchored alternation keeps prefix-sharing
    # slugs (act-runs-last-*, act-run-sync-*, act-build-default-get) on the catch-all.
    rewrite ^/api/v2/act-(runs-get|runs-post|run-get|run-abort-post|run-metamorph-post|builds-get|builds-post|build-get|build-abort-post)$ /api/v2/actors-$1 permanent;
    rewrite ^/api/v2/acts-(.*)$ /api/v2/actors-$1 permanent;
    rewrite ^/api/v2/act-(.*)$ /api/v2/actor-$1 permanent;

    # api/v2-new to api/v2
    rewrite ^/api/v2-new(.*)$ /api/v2$1 permanent;
    rewrite ^/api/v2-old(.*)$ /api/v2$1 permanent;
    rewrite ^/api/v2-redoc(.*)$ /api/v2$1 permanent;

    # Actor marketing playbook redirects (index page removed)
    rewrite ^/academy/get-most-of-actors$ /academy/actor-marketing-playbook/promote-your-actor/checklist permanent;
    rewrite ^/academy/actor-marketing-playbook$ /academy/actor-marketing-playbook/promote-your-actor/checklist permanent;
    rewrite ^/academy/get-most-of-actors/monetizing-your-actor$ /actors/monetize permanent;

    # Actor README guide moved from the Academy to Publishing section
    rewrite ^/academy/actor-marketing-playbook/actor-basics/how-to-create-an-actor-readme$ /actors/publishing/actor-readme permanent;

    # Monetization overview moved from the Academy to Monetize section
    rewrite ^/academy/actor-marketing-playbook/store-basics/how-actor-monetization-works$ /actors/monetize permanent;

    # Monetization section moved out of Publishing: /actors/publishing/monetize/* -> /actors/monetize/*
    # Covers the /platform-prefixed URLs too, so they redirect in one hop, including .md twins.
    rewrite ^/(platform/)?actors/publishing/monetize(\.md|/.*)?$ /actors/monetize$2 permanent;

    # Misc
    rewrite ^/platform/integrations/llama$ /platform/integrations/llama-index permanent;
    # HubSpot marketplace publishing requires the capitalized path; redirect to canonical lowercase page
    rewrite ^/integrations/HubSpot$ /integrations/hubspot permanent;

    # === IA v3 flip: drop the /platform prefix ===
    # Structural moves first (these MUST precede the blanket catch-all, because a
    # naive /platform/X -> /X strip would 404 for sections that relocated).
    # console/store is KEPT at /console/store on the v3 branch (open decision D12),
    # so it gets a clean strip, not a "page removed" soft-land.
    rewrite ^/platform/console/store$                             /console/store                       permanent;
    rewrite ^/platform/console$                                   /account/console                     permanent;
    rewrite ^/platform/console/(.*)$                              /account/$1                          permanent;
    rewrite ^/platform/collaboration/organization-account(/.*)?$  /account/collaboration/organization$1 permanent;
    rewrite ^/platform/collaboration(/.*)?$                       /account/collaboration$1             permanent;
    rewrite ^/platform/actors/development/quick-start(/.*)?$      /actors/development/quick-start$1     permanent;
    # Quick start pages moved out of Get Started back under Actor development
    rewrite ^/get-started/build$                                  /actors/development/quick-start       permanent;
    rewrite ^/get-started/build-with-ai$                          /actors/development/quick-start/build-with-ai permanent;
    rewrite ^/get-started/develop-ai-agents$                      /actors/development/quick-start/develop-ai-agents permanent;
    rewrite ^/get-started/locally$                                /actors/development/quick-start/locally permanent;
    rewrite ^/get-started/web-ide$                                /actors/development/quick-start/web-ide permanent;
    rewrite ^/platform/schedules$                                 /actors/running/schedules            permanent;
    rewrite ^/platform/monitoring$                                /actors/running/monitoring           permanent;
    # "Apify for AI agents" moved from Integrations into Get Started
    rewrite ^/platform/integrations/agent-onboarding$             /get-started/agent-onboarding         permanent;
    # (storage/usage and proxy/usage already redirect to /platform/storage and
    # /platform/proxy via the reorg rules above; the catch-all below carries them
    # the rest of the way to /storage and /proxy. The post-flip cleanup PR collapses
    # that double-hop.)

    # IA v3 follow-ups (#2746): storage schema pages moved from Actor development to Storage.
    # 302 while the IA settles; promote to permanent once stable.
    rewrite ^/actors/development/actor-definition/dataset-schema(/.*)?$   /storage/dataset-schema$1         redirect;
    rewrite ^/actors/development/actor-definition/key-value-store-schema$ /storage/key-value-store-schema   redirect;
    # Limits moved from top-nav (/limits) into Account.
    rewrite ^/limits$                                                    /account/limits                   redirect;
    rewrite ^/proxy/unblocker-proxy$                                     /proxy/unblocker                  redirect;

    # Qoder surfaces consolidated onto one page (#2934).
    rewrite ^/integrations/qoder-cli$                                    /integrations/qoder               permanent;
    rewrite ^/integrations/qoder-ide$                                    /integrations/qoder               permanent;
    rewrite ^/integrations/qoder-work$                                   /integrations/qoder               permanent;

    # MCP server page promoted to a top-level /mcp URL (listed under For AI agents).
    # Both legacy paths redirect in one hop, including their .md twins.
    rewrite ^/integrations/mcp(\.md)?$                                   /mcp$1                            permanent;
    rewrite ^/platform/integrations/mcp(\.md)?$                          /mcp$1                            permanent;

    # Soft-landings for deleted URLs (better UX than a 404)
    rewrite ^/platform/integrations/airtable/console-integration$ /integrations/airtable               permanent;
    rewrite ^/platform/?$                                         /                                    permanent;

    # Catch-all: blanket /platform/X -> /X. MUST be the last /platform rule.
    rewrite ^/platform/(.*)$                                      /$1                                  permanent;
}

# Note: crawlee.dev server block has been moved to crawlee repository:
# https://github.com/apify/crawlee/blob/master/website/nginx.conf

server {
    listen 0.0.0.0:8080;
    resolver 172.20.0.10;
    server_name ~^(?<subdomain>[^.]+)\.preview\.docs\.apify\.com$;

    # Block search indexing on every response from preview hostnames, including the
    # apify.github.io proxy_passes (SDK/Client/CLI) that have no preview bucket and
    # would otherwise serve production content under the preview hostname.
    # `always` keeps the header on 4xx/5xx so error pages aren't indexed either.
    add_header X-Robots-Tag "noindex, nofollow, noarchive" always;

    # add trailing slashes to the root of GH pages docs
    rewrite ^/api/client/js$ /api/client/js/ redirect;
    rewrite ^/api/client/python$ /api/client/python/ redirect;
    rewrite ^/sdk/js$ /sdk/js/ redirect;
    rewrite ^/sdk/python$ /sdk/python/ redirect;
    rewrite ^/cli$ /cli/ redirect;

    location ~ ^/api/client/js/(.*)$ {
        proxy_pass https://apify.github.io/apify-client-js/$1;
    }
    location ~ ^/api/client/python/(.*)$ {
        proxy_pass https://apify.github.io/apify-client-python/$1;
    }
    location ~ ^/sdk/js/(.*)$ {
        proxy_pass https://apify.github.io/apify-sdk-js/$1;
    }
    location ~ ^/sdk/python/(.*)$ {
        proxy_pass https://apify.github.io/apify-sdk-python/$1;
    }
    location ~ ^/cli/(.*)$ {
        proxy_pass https://apify.github.io/apify-cli/$1;
    }

    location = / {
        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/index.html;
    }
    location ~ ^/(.*)/$ {
        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/$1/index.html;
    }
    location ~ ^/([^.]+)$ {
        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/$1.html;
    }
    location ~ ^/(.*)$ {
        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain/$1;
    }
    location / {
        proxy_pass https://s3.amazonaws.com/apify-docs-preview/$subdomain$uri;
    }
}