From 7c9c292d4953925e2fc7d8aadcbf31127398b2f4 Mon Sep 17 00:00:00 2001 From: Orion Edwards Date: Tue, 1 Sep 2026 10:28:01 +1200 Subject: [PATCH 1/8] Checkpoint: Move pages --- src/components/TopNav.astro | 2 +- .../api/authentication/create-an-api-key.md | 143 ++++++++++ .../openid-connect/github-actions.md | 0 .../authentication}/openid-connect/index.md | 0 .../openid-connect/other-issuers.md | 0 .../examples/accounts/create-aws-account.mdx | 0 .../create-azure-service-principal.mdx | 0 .../examples/accounts/create-gcp-account.mdx | 0 .../examples/accounts/index.md | 0 .../examples/add-a-space-with-environments.md | 0 .../examples/add-azure-web-app.md | 0 .../examples/add-environment-to-step.md | 0 .../artifacts/create-and-upload-artifacts.mdx | 0 .../download-deployment-artifacts.mdx | 0 .../artifacts/download-runbook-artifacts.mdx | 0 .../examples/artifacts/index.md | 0 .../bulk-add-projects-to-tenants.mdx | 0 .../examples/bulk-operations/index.md | 0 ...ments-and-runbooks-after-node-shutdown.mdx | 0 .../examples/cancel-queued-deployments.md | 0 .../certificates/create-certificate.mdx | 0 .../examples/certificates/index.md | 0 .../certificates/replace-certificate.mdx | 0 .../examples/change-machine-machinepolicy.md | 0 .../examples/channels/create-channel.mdx | 0 .../examples/channels/index.md | 0 .../examples/create-and-deploy-a-release.md | 0 .../create-azure-service-principal.md | 0 .../examples/create-certificate.md | 0 .../examples/create-project.md | 0 .../examples/create-runbook.md | 0 .../examples/create-script-step.md | 0 .../examples/delete-a-space.md | 0 .../examples/delete-machines-by-role.md | 0 .../examples/delete-project-releases.md | 0 .../add-environment-to-step.mdx | 0 .../deployment-process/create-script-step.mdx | 0 .../get-steps-using-package.mdx | 0 .../get-steps-using-role.mdx | 0 .../examples/deployment-process/index.md | 0 .../deployment-targets/add-azure-web-app.mdx | 0 .../deployment-targets/add-target-role.mdx | 0 .../add-tenant-to-target.mdx | 0 .../change-target-machinepolicy.mdx | 0 .../check-for-tentacle-upgrades.mdx | 0 .../delete-machines-by-name.mdx | 0 .../delete-machines-by-role.mdx | 0 .../enable-disable-machine.mdx | 0 .../deployment-targets/find-target-usage.mdx | 0 .../find-unused-targets.mdx | 0 .../examples/deployment-targets/index.md | 0 .../register-listening-tentacle.mdx | 0 .../register-polling-tentacle.mdx | 0 .../register-ssh-target.mdx | 0 .../deployment-targets/upgrade-machines.mdx | 0 .../deployments/cancel-queued-deployments.mdx | 0 .../create-and-deploy-a-release.mdx | 0 ...deploy-release-with-prompted-variables.mdx | 0 .../examples/deployments/deploy-release.mdx | 0 .../examples/deployments/index.md | 0 .../list-deployments-to-environment.mdx | 0 .../environments/add-environments.mdx | 0 .../examples/environments/index.md | 0 .../examples/events/find-events-by-date.mdx | 0 .../examples/events/index.md | 0 .../examples/feeds/change-feed.mdx | 0 .../examples/feeds/create-feed.mdx | 0 .../examples/feeds/delete-feed.mdx | 0 .../download-package-from-builtin-feed.mdx | 0 .../examples/feeds/get-feeds.md | 0 .../examples/feeds/index.md | 0 .../feeds/push-package-to-builtin-feed.mdx | 0 .../examples/feeds/retrieve-feeds.mdx | 0 .../examples/feeds/synchronize-packages.mdx | 0 .../examples/get-steps-using-role.md | 0 src/pages/docs/api/examples/index.md | 93 +++++++ .../examples/lifecycles/create-lifecycle.mdx | 0 .../examples/lifecycles/index.md | 0 .../examples/list-users-with-role.md | 0 .../project-groups/create-projectgroup.mdx | 0 .../examples/project-groups/index.md | 0 .../coordinating-multiple-projects.mdx | 0 .../examples/projects/create-project.mdx | 0 .../examples/projects/delete-project.mdx | 0 .../delete-projects-with-empty-processes.mdx | 0 .../projects/disable-project-triggers.mdx | 0 .../projects/enable-disable-project.mdx | 0 .../examples/projects/export-projects.mdx | 0 .../projects/find-unused-projects.mdx | 0 .../examples/projects/import-projects.mdx | 0 .../examples/projects/index.md | 0 .../examples/publish-runbook.md | 0 .../examples/register-listening-tentacle.md | 0 .../examples/register-polling-tentacle.md | 0 .../create-release-with-specific-version.mdx | 0 .../releases/delete-project-releases.mdx | 0 .../examples/releases/index.md | 0 .../promote-release-not-in-destination.mdx | 0 .../update-release-variable-snapshot.mdx | 0 .../examples/replace-certificate.md | 0 .../deployments-per-target-role-report.mdx | 0 .../environment-permissions-report.mdx | 0 .../examples/reports/index.md | 0 .../reports/project-permissions-report.mdx | 0 ...ject-release-deployment-targets-report.mdx | 0 .../examples/run-runbook.md | 0 .../runbooks/add-script-step-to-runbook.mdx | 0 .../runbooks/create-and-publish-runbook.mdx | 0 .../examples/runbooks/create-runbook.mdx | 0 .../create-scheduled-runbook-trigger.mdx | 0 .../examples/runbooks/index.md | 0 .../examples/runbooks/publish-runbook.mdx | 0 .../run-runbook-with-prompted-variables.mdx | 0 .../examples/runbooks/run-runbook.mdx | 0 .../spaces/add-a-space-with-environments.mdx | 0 .../examples/spaces/delete-a-space.mdx | 0 .../examples/spaces/index.md | 0 .../step-templates/export-step-templates.mdx | 0 .../examples/step-templates/index.md | 0 .../examples/tagsets/create-tagset.mdx | 0 .../examples/tagsets/index.md | 0 .../examples/tasks/index.md | 0 .../examples/tasks/reprioritize-tasks.mdx | 0 .../examples/tasks/run-healthcheck.mdx | 0 .../tenants/bulk-add-projects-to-tenants.md | 0 .../examples/tenants/create-tenant.mdx | 0 .../examples/tenants/deactivate-tenant.mdx | 0 .../examples/tenants/index.md | 0 .../tenants/update-tenant-variable.mdx | 0 .../users-and-teams/add-azure-ad-to-users.mdx | 0 .../users-and-teams/add-domain-teams.mdx | 0 .../add-environment-to-team.mdx | 0 .../users-and-teams/change-users-domain.mdx | 0 .../users-and-teams/create-api-key.mdx | 0 .../users-and-teams/find-teams-with-role.mdx | 0 .../examples/users-and-teams/index.md | 0 .../list-users-with-editing-roles.mdx | 0 .../users-and-teams/list-users-with-role.mdx | 0 .../examples/users-and-teams/list-users.mdx | 0 .../remove-project-from-team.mdx | 0 .../swap-ad-domain-group-with-ldap-group.mdx | 0 .../swap-users-ad-domain-to-ldap.mdx | 0 .../examples/users/index.md | 0 .../examples/users/list-users-with-role.md | 0 .../variables/add-library-set-to-project.mdx | 0 .../variables/add-update-project-variable.mdx | 0 .../variables/clear-sensitive-variables.mdx | 0 .../find-projects-using-library-set.mdx | 0 .../variables/find-variable-usage.mdx | 0 .../variables/find-variable-value-usage.mdx | 0 .../variables/find-variable-vaule-usage.md | 0 .../find-variableset-variables-usage.mdx | 0 .../examples/variables/index.md | 0 .../update-variable-set-variable-value.mdx | 0 .../octopus.client/getting-started.mdx | 0 .../octopus.client/index.md | 0 .../octopus.client/using-client-directly.md | 0 .../using-client-in-octopus.mdx | 0 .../octopus.client/using-resources.md | 0 .../octopus.client/working-with-spaces.md | 0 .../docs/octopus-rest-api/examples/index.md | 97 +------ .../docs/octopus-rest-api/getting-started.mdx | 151 +---------- .../how-to-create-an-api-key.md | 147 +---------- src/pages/docs/octopus-rest-api/index.mdx | 41 +-- .../docs/octopus-rest-api/migration-api.md | 10 + .../octopus-rest-api/migration-api/index.md | 249 ------------------ .../docs/octopus-rest-api/octopus.client.md | 10 + .../docs/octopus-rest-api/openid-connect.md | 10 + 168 files changed, 295 insertions(+), 658 deletions(-) create mode 100644 src/pages/docs/api/authentication/create-an-api-key.md rename src/pages/docs/{octopus-rest-api => api/authentication}/openid-connect/github-actions.md (100%) rename src/pages/docs/{octopus-rest-api => api/authentication}/openid-connect/index.md (100%) rename src/pages/docs/{octopus-rest-api => api/authentication}/openid-connect/other-issuers.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/accounts/create-aws-account.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/accounts/create-azure-service-principal.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/accounts/create-gcp-account.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/accounts/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/add-a-space-with-environments.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/add-azure-web-app.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/add-environment-to-step.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/artifacts/create-and-upload-artifacts.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/artifacts/download-deployment-artifacts.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/artifacts/download-runbook-artifacts.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/artifacts/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/bulk-operations/bulk-add-projects-to-tenants.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/bulk-operations/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/cancel-queued-deployments.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/certificates/create-certificate.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/certificates/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/certificates/replace-certificate.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/change-machine-machinepolicy.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/channels/create-channel.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/channels/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/create-and-deploy-a-release.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/create-azure-service-principal.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/create-certificate.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/create-project.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/create-runbook.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/create-script-step.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/delete-a-space.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/delete-machines-by-role.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/delete-project-releases.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-process/add-environment-to-step.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-process/create-script-step.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-process/get-steps-using-package.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-process/get-steps-using-role.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-process/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/add-azure-web-app.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/add-target-role.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/add-tenant-to-target.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/change-target-machinepolicy.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/check-for-tentacle-upgrades.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/delete-machines-by-name.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/delete-machines-by-role.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/enable-disable-machine.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/find-target-usage.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/find-unused-targets.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/register-listening-tentacle.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/register-polling-tentacle.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/register-ssh-target.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployment-targets/upgrade-machines.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployments/cancel-queued-deployments.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployments/create-and-deploy-a-release.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployments/deploy-release-with-prompted-variables.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployments/deploy-release.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployments/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/deployments/list-deployments-to-environment.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/environments/add-environments.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/environments/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/events/find-events-by-date.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/events/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/change-feed.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/create-feed.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/delete-feed.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/download-package-from-builtin-feed.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/get-feeds.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/push-package-to-builtin-feed.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/retrieve-feeds.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/feeds/synchronize-packages.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/get-steps-using-role.md (100%) create mode 100644 src/pages/docs/api/examples/index.md rename src/pages/docs/{octopus-rest-api => api}/examples/lifecycles/create-lifecycle.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/lifecycles/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/list-users-with-role.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/project-groups/create-projectgroup.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/project-groups/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/coordinating-multiple-projects.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/create-project.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/delete-project.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/delete-projects-with-empty-processes.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/disable-project-triggers.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/enable-disable-project.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/export-projects.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/find-unused-projects.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/import-projects.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/projects/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/publish-runbook.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/register-listening-tentacle.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/register-polling-tentacle.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/releases/create-release-with-specific-version.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/releases/delete-project-releases.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/releases/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/releases/promote-release-not-in-destination.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/releases/update-release-variable-snapshot.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/replace-certificate.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/reports/deployments-per-target-role-report.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/reports/environment-permissions-report.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/reports/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/reports/project-permissions-report.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/reports/project-release-deployment-targets-report.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/run-runbook.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/runbooks/add-script-step-to-runbook.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/runbooks/create-and-publish-runbook.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/runbooks/create-runbook.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/runbooks/create-scheduled-runbook-trigger.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/runbooks/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/runbooks/publish-runbook.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/runbooks/run-runbook-with-prompted-variables.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/runbooks/run-runbook.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/spaces/add-a-space-with-environments.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/spaces/delete-a-space.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/spaces/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/step-templates/export-step-templates.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/step-templates/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tagsets/create-tagset.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tagsets/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tasks/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tasks/reprioritize-tasks.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tasks/run-healthcheck.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tenants/bulk-add-projects-to-tenants.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tenants/create-tenant.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tenants/deactivate-tenant.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tenants/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/tenants/update-tenant-variable.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/add-azure-ad-to-users.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/add-domain-teams.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/add-environment-to-team.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/change-users-domain.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/create-api-key.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/find-teams-with-role.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/list-users-with-editing-roles.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/list-users-with-role.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/list-users.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/remove-project-from-team.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/users/list-users-with-role.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/add-library-set-to-project.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/add-update-project-variable.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/clear-sensitive-variables.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/find-projects-using-library-set.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/find-variable-usage.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/find-variable-value-usage.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/find-variable-vaule-usage.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/find-variableset-variables-usage.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/examples/variables/update-variable-set-variable-value.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/octopus.client/getting-started.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/octopus.client/index.md (100%) rename src/pages/docs/{octopus-rest-api => api}/octopus.client/using-client-directly.md (100%) rename src/pages/docs/{octopus-rest-api => api}/octopus.client/using-client-in-octopus.mdx (100%) rename src/pages/docs/{octopus-rest-api => api}/octopus.client/using-resources.md (100%) rename src/pages/docs/{octopus-rest-api => api}/octopus.client/working-with-spaces.md (100%) create mode 100644 src/pages/docs/octopus-rest-api/migration-api.md delete mode 100644 src/pages/docs/octopus-rest-api/migration-api/index.md create mode 100644 src/pages/docs/octopus-rest-api/octopus.client.md create mode 100644 src/pages/docs/octopus-rest-api/openid-connect.md diff --git a/src/components/TopNav.astro b/src/components/TopNav.astro index cba455ca14..52b9ec1880 100644 --- a/src/components/TopNav.astro +++ b/src/components/TopNav.astro @@ -18,7 +18,7 @@ const { links = [ { label: 'Docs', href: '/docs' }, // TODO: { label: 'Learn', href: '/docs/?' }, - { label: 'API', href: '/docs/octopus-rest-api' }, + { label: 'API', href: '/docs/api' }, { label: 'CLI', href: '/docs/cli' }, ], } = Astro.props satisfies Props; diff --git a/src/pages/docs/api/authentication/create-an-api-key.md b/src/pages/docs/api/authentication/create-an-api-key.md new file mode 100644 index 0000000000..e6f1cb5a12 --- /dev/null +++ b/src/pages/docs/api/authentication/create-an-api-key.md @@ -0,0 +1,143 @@ +--- +layout: src/layouts/Default.astro +pubDate: 2023-01-01 +modDate: 2026-06-19 +title: Create an API Key +description: How to create an API key to interact with Octopus without the need for a username and password. +navOrder: 10 +--- + +API keys allow you to access the Octopus Deploy [REST API](/docs/octopus-rest-api) and perform tasks such as creating and deploying releases. API keys can be saved in scripts or external tools, without having to use your username and password. Each user and service account can have multiple API keys. + +See the [Service Accounts docs](/docs/security/users-and-teams/service-accounts) for information about creating service accounts. + +## Creating an API Key + +[Getting Started - API Keys](https://www.youtube.com/watch?v=f3-vRjpB0cE) + +You can create API keys by performing the following steps: + +1. Log into the Octopus Web Portal, click your profile image and select **Profile**. +1. Click **My API Keys**. +1. Click **New API key**, state the purpose of the API key. +1. Choose the level of **Access** to grant (see below). +1. Click **Generate new**. +1. Copy the new API key to your clipboard. + +:::div{.warning} +**Write Your Key Down** +After you generate an API key, it cannot be retrieved from the Octopus Web Portal again, we store only a one-way hash of the API key. If you want to use the API key again, you need to store it in a secure place such as a password manager. Read about [why we hash API keys](https://octopus.com/blog/hashing-api-keys). +::: + +## Creating an agent API key {#creating-an-agent-api-key} + +If you're connecting an AI agent to Octopus—such as the [Octopus MCP server](/docs/octopus-ai/mcp)—create a dedicated agent API key rather than a regular one. Agent keys are tagged throughout Octopus so you can filter for and audit agent activity separately from human activity. + +You can also create an agent API key directly from the **API Keys** page: + +1. Click **New API key for AI Agent** and state the purpose of the key. +1. Choose the level of **Access** to grant. +1. Click **Generate new**. +1. Copy the new API key to your clipboard. + +## Choosing an access level + +:::div{.hint} + +This feature is currently being rolled out to Octopus Cloud customers and will become available to self-hosted installations in Octopus Server 2026.3. + +If you don't see the access option when creating an API key, the API key will be created with full access and have the same permissions as your user account. + +::: + +Recent versions of Octopus Server add the ability to limit the scope of an API key, to allow only read-only access. Alternatively, you can grant the API key full access to give it the same permissions as your user account. Use the **Preview Permissions** link to see the exact list of permissions that apply to the chosen access level. + +Read-only scopes are useful for tooling that doesn't need to be able to make changes, perform actions or trigger deployments, such as AI agents (like Claude Code) or for external monitoring systems (like release progression dashboards). + +Note that it is not possible to create an API key with more permissions than your user account. For these scenarios, you should look at creating an API key under a dedicated [Service Account](/docs/security/users-and-teams/service-accounts) instead. Use this approach for tooling that is not acting on behalf of a particular user. + +## Setting an expiry date + +:::div{.hint} +The ability to set an expiry date on new API keys was added in Octopus Deploy **2020.6**. +::: +By default, new API keys are valid for 180 days from the point they are created. + +When creating an API key in the Octopus Web Portal, you can choose from a preset list of offsets from the current date, or select a custom date. Keys will expire at the end of the selected day. When using the Octopus REST API to create a key, you can set the expiry date to your preferred date and time, including time zone offset. + +There are three restrictions on the expiry date: + +- It cannot be in the past. +- It cannot be after the expiry date of the key being used to create it (when using the REST API). +- **Octopus Deploy 2025.4 and newer:** It cannot exceed the server's configured maximum expiry period (defaults to 366 days, configurable) + +## Configure API keys for expiry notifications + +[Octopus Subscriptions](/docs/administration/managing-infrastructure/subscriptions) can be used to configure notifications when API keys are close to expiry or have expired. + +There is an "API key expiry events" event-group and three events: + +- API key expiry 20-day warning. +- API key expiry 10-day warning. +- API key expired. + +:::div{.info} + +The background task which raises the api-key-expiry events runs: + +- 10 minutes after the Octopus Server service starts +- Every 4 hours + +::: + +## Configuring API Key default and maximum expiry durations + +:::div{.hint} +The ability to control the default and maximum API key expiry was added in Octopus Deploy **2025.4**. The ability to create keys that never expire was removed in this version. + +Versions 2025.3 and below will use a default expiry of 180 days and have no maximum. +::: + +Octopus administrators can change the maximum API key expiry from 366 days to a value of their choice, up to 1096 days. + +Octopus administrators can change the default API key expiry from 180 days to a value of their choice. The default period must be less than or equal to the maximum. + +To change these values in the Octopus Web Portal: + +1. Navigate to **Configuration ➜ Settings** and click **Authentication**. +1. Expand the sections for **API Key default expiry (days)** and **API Key maximum expiry (days)** and alter the values. +1. Click Save. + +## Managing API keys + +Octopus administrators can view all API keys across the instance from the **API Keys** page. + +### Identifying key types + +Each key's row shows an **API key type** column with a type tag—**User**, or **AI Agent**—so you can tell at a glance which kind of identity each key belongs to. + +### Filtering by agent + +Check **AI Agents** to filter the list to agent keys only. This is useful when you want to review the credentials your agents are using without wading through keys belonging to human users. + +### Last used + +The list shows when each key was last used. Use this to spot dormant credentials that may need rotating. + +### Viewing permissions + +Each row has an overflow menu. Select **View permissions** to open the Test Permissions page for that identity, so you can see exactly what the key can do. + +## Disabling API key creation for user accounts + +:::div{.hint} +The ability to disable API key creation for user accounts was added in Octopus Deploy **2023.2**. +::: + +Octopus administrators can disable the creation of API keys for regular user accounts. Existing API keys will continue to function, and new API keys can still be created for [Service Accounts](/docs/security/users-and-teams/service-accounts). + +To change the value in the Octopus Web Portal: + +1. Navigate to **Configuration ➜ Settings** and click **Authentication**. +1. Expand the section for **User API Keys** and alter the value. +1. Click Save. diff --git a/src/pages/docs/octopus-rest-api/openid-connect/github-actions.md b/src/pages/docs/api/authentication/openid-connect/github-actions.md similarity index 100% rename from src/pages/docs/octopus-rest-api/openid-connect/github-actions.md rename to src/pages/docs/api/authentication/openid-connect/github-actions.md diff --git a/src/pages/docs/octopus-rest-api/openid-connect/index.md b/src/pages/docs/api/authentication/openid-connect/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/openid-connect/index.md rename to src/pages/docs/api/authentication/openid-connect/index.md diff --git a/src/pages/docs/octopus-rest-api/openid-connect/other-issuers.md b/src/pages/docs/api/authentication/openid-connect/other-issuers.md similarity index 100% rename from src/pages/docs/octopus-rest-api/openid-connect/other-issuers.md rename to src/pages/docs/api/authentication/openid-connect/other-issuers.md diff --git a/src/pages/docs/octopus-rest-api/examples/accounts/create-aws-account.mdx b/src/pages/docs/api/examples/accounts/create-aws-account.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/accounts/create-aws-account.mdx rename to src/pages/docs/api/examples/accounts/create-aws-account.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/accounts/create-azure-service-principal.mdx b/src/pages/docs/api/examples/accounts/create-azure-service-principal.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/accounts/create-azure-service-principal.mdx rename to src/pages/docs/api/examples/accounts/create-azure-service-principal.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/accounts/create-gcp-account.mdx b/src/pages/docs/api/examples/accounts/create-gcp-account.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/accounts/create-gcp-account.mdx rename to src/pages/docs/api/examples/accounts/create-gcp-account.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/accounts/index.md b/src/pages/docs/api/examples/accounts/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/accounts/index.md rename to src/pages/docs/api/examples/accounts/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md b/src/pages/docs/api/examples/add-a-space-with-environments.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md rename to src/pages/docs/api/examples/add-a-space-with-environments.md diff --git a/src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md b/src/pages/docs/api/examples/add-azure-web-app.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md rename to src/pages/docs/api/examples/add-azure-web-app.md diff --git a/src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md b/src/pages/docs/api/examples/add-environment-to-step.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md rename to src/pages/docs/api/examples/add-environment-to-step.md diff --git a/src/pages/docs/octopus-rest-api/examples/artifacts/create-and-upload-artifacts.mdx b/src/pages/docs/api/examples/artifacts/create-and-upload-artifacts.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/artifacts/create-and-upload-artifacts.mdx rename to src/pages/docs/api/examples/artifacts/create-and-upload-artifacts.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/artifacts/download-deployment-artifacts.mdx b/src/pages/docs/api/examples/artifacts/download-deployment-artifacts.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/artifacts/download-deployment-artifacts.mdx rename to src/pages/docs/api/examples/artifacts/download-deployment-artifacts.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/artifacts/download-runbook-artifacts.mdx b/src/pages/docs/api/examples/artifacts/download-runbook-artifacts.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/artifacts/download-runbook-artifacts.mdx rename to src/pages/docs/api/examples/artifacts/download-runbook-artifacts.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/artifacts/index.md b/src/pages/docs/api/examples/artifacts/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/artifacts/index.md rename to src/pages/docs/api/examples/artifacts/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/bulk-operations/bulk-add-projects-to-tenants.mdx b/src/pages/docs/api/examples/bulk-operations/bulk-add-projects-to-tenants.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/bulk-operations/bulk-add-projects-to-tenants.mdx rename to src/pages/docs/api/examples/bulk-operations/bulk-add-projects-to-tenants.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/bulk-operations/index.md b/src/pages/docs/api/examples/bulk-operations/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/bulk-operations/index.md rename to src/pages/docs/api/examples/bulk-operations/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx b/src/pages/docs/api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx rename to src/pages/docs/api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md b/src/pages/docs/api/examples/cancel-queued-deployments.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md rename to src/pages/docs/api/examples/cancel-queued-deployments.md diff --git a/src/pages/docs/octopus-rest-api/examples/certificates/create-certificate.mdx b/src/pages/docs/api/examples/certificates/create-certificate.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/certificates/create-certificate.mdx rename to src/pages/docs/api/examples/certificates/create-certificate.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/certificates/index.md b/src/pages/docs/api/examples/certificates/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/certificates/index.md rename to src/pages/docs/api/examples/certificates/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/certificates/replace-certificate.mdx b/src/pages/docs/api/examples/certificates/replace-certificate.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/certificates/replace-certificate.mdx rename to src/pages/docs/api/examples/certificates/replace-certificate.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md b/src/pages/docs/api/examples/change-machine-machinepolicy.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md rename to src/pages/docs/api/examples/change-machine-machinepolicy.md diff --git a/src/pages/docs/octopus-rest-api/examples/channels/create-channel.mdx b/src/pages/docs/api/examples/channels/create-channel.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/channels/create-channel.mdx rename to src/pages/docs/api/examples/channels/create-channel.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/channels/index.md b/src/pages/docs/api/examples/channels/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/channels/index.md rename to src/pages/docs/api/examples/channels/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md b/src/pages/docs/api/examples/create-and-deploy-a-release.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md rename to src/pages/docs/api/examples/create-and-deploy-a-release.md diff --git a/src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md b/src/pages/docs/api/examples/create-azure-service-principal.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md rename to src/pages/docs/api/examples/create-azure-service-principal.md diff --git a/src/pages/docs/octopus-rest-api/examples/create-certificate.md b/src/pages/docs/api/examples/create-certificate.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/create-certificate.md rename to src/pages/docs/api/examples/create-certificate.md diff --git a/src/pages/docs/octopus-rest-api/examples/create-project.md b/src/pages/docs/api/examples/create-project.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/create-project.md rename to src/pages/docs/api/examples/create-project.md diff --git a/src/pages/docs/octopus-rest-api/examples/create-runbook.md b/src/pages/docs/api/examples/create-runbook.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/create-runbook.md rename to src/pages/docs/api/examples/create-runbook.md diff --git a/src/pages/docs/octopus-rest-api/examples/create-script-step.md b/src/pages/docs/api/examples/create-script-step.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/create-script-step.md rename to src/pages/docs/api/examples/create-script-step.md diff --git a/src/pages/docs/octopus-rest-api/examples/delete-a-space.md b/src/pages/docs/api/examples/delete-a-space.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/delete-a-space.md rename to src/pages/docs/api/examples/delete-a-space.md diff --git a/src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md b/src/pages/docs/api/examples/delete-machines-by-role.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md rename to src/pages/docs/api/examples/delete-machines-by-role.md diff --git a/src/pages/docs/octopus-rest-api/examples/delete-project-releases.md b/src/pages/docs/api/examples/delete-project-releases.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/delete-project-releases.md rename to src/pages/docs/api/examples/delete-project-releases.md diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/add-environment-to-step.mdx b/src/pages/docs/api/examples/deployment-process/add-environment-to-step.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-process/add-environment-to-step.mdx rename to src/pages/docs/api/examples/deployment-process/add-environment-to-step.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/create-script-step.mdx b/src/pages/docs/api/examples/deployment-process/create-script-step.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-process/create-script-step.mdx rename to src/pages/docs/api/examples/deployment-process/create-script-step.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-package.mdx b/src/pages/docs/api/examples/deployment-process/get-steps-using-package.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-package.mdx rename to src/pages/docs/api/examples/deployment-process/get-steps-using-package.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-role.mdx b/src/pages/docs/api/examples/deployment-process/get-steps-using-role.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-role.mdx rename to src/pages/docs/api/examples/deployment-process/get-steps-using-role.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/index.md b/src/pages/docs/api/examples/deployment-process/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-process/index.md rename to src/pages/docs/api/examples/deployment-process/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-azure-web-app.mdx b/src/pages/docs/api/examples/deployment-targets/add-azure-web-app.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/add-azure-web-app.mdx rename to src/pages/docs/api/examples/deployment-targets/add-azure-web-app.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-target-role.mdx b/src/pages/docs/api/examples/deployment-targets/add-target-role.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/add-target-role.mdx rename to src/pages/docs/api/examples/deployment-targets/add-target-role.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-tenant-to-target.mdx b/src/pages/docs/api/examples/deployment-targets/add-tenant-to-target.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/add-tenant-to-target.mdx rename to src/pages/docs/api/examples/deployment-targets/add-tenant-to-target.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/change-target-machinepolicy.mdx b/src/pages/docs/api/examples/deployment-targets/change-target-machinepolicy.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/change-target-machinepolicy.mdx rename to src/pages/docs/api/examples/deployment-targets/change-target-machinepolicy.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/check-for-tentacle-upgrades.mdx b/src/pages/docs/api/examples/deployment-targets/check-for-tentacle-upgrades.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/check-for-tentacle-upgrades.mdx rename to src/pages/docs/api/examples/deployment-targets/check-for-tentacle-upgrades.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-name.mdx b/src/pages/docs/api/examples/deployment-targets/delete-machines-by-name.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-name.mdx rename to src/pages/docs/api/examples/deployment-targets/delete-machines-by-name.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-role.mdx b/src/pages/docs/api/examples/deployment-targets/delete-machines-by-role.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-role.mdx rename to src/pages/docs/api/examples/deployment-targets/delete-machines-by-role.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/enable-disable-machine.mdx b/src/pages/docs/api/examples/deployment-targets/enable-disable-machine.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/enable-disable-machine.mdx rename to src/pages/docs/api/examples/deployment-targets/enable-disable-machine.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/find-target-usage.mdx b/src/pages/docs/api/examples/deployment-targets/find-target-usage.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/find-target-usage.mdx rename to src/pages/docs/api/examples/deployment-targets/find-target-usage.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/find-unused-targets.mdx b/src/pages/docs/api/examples/deployment-targets/find-unused-targets.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/find-unused-targets.mdx rename to src/pages/docs/api/examples/deployment-targets/find-unused-targets.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/index.md b/src/pages/docs/api/examples/deployment-targets/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/index.md rename to src/pages/docs/api/examples/deployment-targets/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-listening-tentacle.mdx b/src/pages/docs/api/examples/deployment-targets/register-listening-tentacle.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/register-listening-tentacle.mdx rename to src/pages/docs/api/examples/deployment-targets/register-listening-tentacle.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-polling-tentacle.mdx b/src/pages/docs/api/examples/deployment-targets/register-polling-tentacle.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/register-polling-tentacle.mdx rename to src/pages/docs/api/examples/deployment-targets/register-polling-tentacle.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-ssh-target.mdx b/src/pages/docs/api/examples/deployment-targets/register-ssh-target.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/register-ssh-target.mdx rename to src/pages/docs/api/examples/deployment-targets/register-ssh-target.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/upgrade-machines.mdx b/src/pages/docs/api/examples/deployment-targets/upgrade-machines.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployment-targets/upgrade-machines.mdx rename to src/pages/docs/api/examples/deployment-targets/upgrade-machines.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/cancel-queued-deployments.mdx b/src/pages/docs/api/examples/deployments/cancel-queued-deployments.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployments/cancel-queued-deployments.mdx rename to src/pages/docs/api/examples/deployments/cancel-queued-deployments.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/create-and-deploy-a-release.mdx b/src/pages/docs/api/examples/deployments/create-and-deploy-a-release.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployments/create-and-deploy-a-release.mdx rename to src/pages/docs/api/examples/deployments/create-and-deploy-a-release.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/deploy-release-with-prompted-variables.mdx b/src/pages/docs/api/examples/deployments/deploy-release-with-prompted-variables.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployments/deploy-release-with-prompted-variables.mdx rename to src/pages/docs/api/examples/deployments/deploy-release-with-prompted-variables.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/deploy-release.mdx b/src/pages/docs/api/examples/deployments/deploy-release.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployments/deploy-release.mdx rename to src/pages/docs/api/examples/deployments/deploy-release.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/index.md b/src/pages/docs/api/examples/deployments/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployments/index.md rename to src/pages/docs/api/examples/deployments/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/list-deployments-to-environment.mdx b/src/pages/docs/api/examples/deployments/list-deployments-to-environment.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/deployments/list-deployments-to-environment.mdx rename to src/pages/docs/api/examples/deployments/list-deployments-to-environment.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/environments/add-environments.mdx b/src/pages/docs/api/examples/environments/add-environments.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/environments/add-environments.mdx rename to src/pages/docs/api/examples/environments/add-environments.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/environments/index.md b/src/pages/docs/api/examples/environments/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/environments/index.md rename to src/pages/docs/api/examples/environments/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/events/find-events-by-date.mdx b/src/pages/docs/api/examples/events/find-events-by-date.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/events/find-events-by-date.mdx rename to src/pages/docs/api/examples/events/find-events-by-date.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/events/index.md b/src/pages/docs/api/examples/events/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/events/index.md rename to src/pages/docs/api/examples/events/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/change-feed.mdx b/src/pages/docs/api/examples/feeds/change-feed.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/change-feed.mdx rename to src/pages/docs/api/examples/feeds/change-feed.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/create-feed.mdx b/src/pages/docs/api/examples/feeds/create-feed.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/create-feed.mdx rename to src/pages/docs/api/examples/feeds/create-feed.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/delete-feed.mdx b/src/pages/docs/api/examples/feeds/delete-feed.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/delete-feed.mdx rename to src/pages/docs/api/examples/feeds/delete-feed.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/download-package-from-builtin-feed.mdx b/src/pages/docs/api/examples/feeds/download-package-from-builtin-feed.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/download-package-from-builtin-feed.mdx rename to src/pages/docs/api/examples/feeds/download-package-from-builtin-feed.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md b/src/pages/docs/api/examples/feeds/get-feeds.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md rename to src/pages/docs/api/examples/feeds/get-feeds.md diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/index.md b/src/pages/docs/api/examples/feeds/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/index.md rename to src/pages/docs/api/examples/feeds/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/push-package-to-builtin-feed.mdx b/src/pages/docs/api/examples/feeds/push-package-to-builtin-feed.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/push-package-to-builtin-feed.mdx rename to src/pages/docs/api/examples/feeds/push-package-to-builtin-feed.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/retrieve-feeds.mdx b/src/pages/docs/api/examples/feeds/retrieve-feeds.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/retrieve-feeds.mdx rename to src/pages/docs/api/examples/feeds/retrieve-feeds.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/synchronize-packages.mdx b/src/pages/docs/api/examples/feeds/synchronize-packages.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/feeds/synchronize-packages.mdx rename to src/pages/docs/api/examples/feeds/synchronize-packages.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md b/src/pages/docs/api/examples/get-steps-using-role.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md rename to src/pages/docs/api/examples/get-steps-using-role.md diff --git a/src/pages/docs/api/examples/index.md b/src/pages/docs/api/examples/index.md new file mode 100644 index 0000000000..e40845e137 --- /dev/null +++ b/src/pages/docs/api/examples/index.md @@ -0,0 +1,93 @@ +--- +layout: src/layouts/Default.astro +pubDate: 2023-01-01 +modDate: 2023-01-01 +title: API examples +description: A set of examples using the Octopus REST API to accomplish tasks. +navOrder: 40 +hideInThisSectionHeader: true +--- + +As you work with the Octopus API, you may need some guidance on how to perform certain actions or what parameters to provide. The [OctopusDeploy-API GitHub repository](https://github.com/OctopusDeploy/OctopusDeploy-Api) contains many examples using the API, with solutions covering: + +- PowerShell using the REST API. +- PowerShell using Octopus.Client. +- C# using Octopus.Client. +- Python using the REST API. +- Go using the [Go API Client for Octopus Deploy](https://github.com/OctopusDeploy/go-octopusdeploy). +- TypeScript using the [TypeScript API Client for Octopus Deploy](https://github.com/OctopusDeploy/api-client.ts). + +In addition, we also have a wide range of some of the more common examples here as well. + +## Using the scripts + +To use the example scripts, you'll need to provide your Octopus Server URL and an [API Key](/docs/octopus-rest-api/how-to-create-an-api-key). There may be other values that need to be updated to fit your scenario such as Space, Project, and Environment names. + +:::div{.hint} +**The examples provided are for reference and should be modified and tested prior to using in a production Octopus instance.** +::: + +### C# examples + +The C# examples are written using [dotnet script](https://github.com/filipw/dotnet-script). The same logic can be used in a standard C# application. + +### Octopus.Client examples + +Examples using [Octopus.Client](/docs/octopus-rest-api/octopus.client) require the library to be installed and a path to the library to be provided. + +### Python examples + +The Python examples are written using **Python 3** and use the [Requests](https://requests.readthedocs.io/en/master/) library. Some examples also use the [urllib](https://docs.python.org/3/library/urllib.html) module. + +### Go examples + +The Go examples are written using the [Go API Client for Octopus Deploy](https://github.com/OctopusDeploy/go-octopusdeploy). + +### Java examples + +The Java examples are written using the [java-octopus-deploy](https://github.com/OctopusDeployLabs/java-octopus-deploy) Client. + +The Java Client library requires **Java 1.8** or above. + +### TypeScript examples + +The TypeScript examples are written using the [TypeScript API Client for Octopus Deploy](https://github.com/OctopusDeploy/api-client.ts). + +## Bulk operations + +Sometimes you want to perform an action on a resource in Octopus multiple times. For example, connecting a tenant to all of your projects. Having to run a script that performs an operation once, repeatedly, can become tedious. + +To help with this, we've included examples of [bulk operations](/docs/octopus-rest-api/examples/bulk-operations) using the Octopus REST API. + +## Explore examples + +Explore the REST API examples further in this section: + +- [Accounts](/docs/octopus-rest-api/examples/accounts) +- [Artifacts](/docs/octopus-rest-api/examples/artifacts) +- [Certificates](/docs/octopus-rest-api/examples/certificates) +- [Channels](/docs/octopus-rest-api/examples/channels) +- [Deployment process](/docs/octopus-rest-api/examples/deployment-process) +- [Deployment targets](/docs/octopus-rest-api/examples/deployment-targets) +- [Deployments](/docs/octopus-rest-api/examples/deployments) +- [Environments](/docs/octopus-rest-api/examples/environments) +- [Events](/docs/octopus-rest-api/examples/events) +- [Feeds](/docs/octopus-rest-api/examples/feeds) +- [Lifecycles](/docs/octopus-rest-api/examples/lifecycles) +- [Project Groups](/docs/octopus-rest-api/examples/project-groups) +- [Projects](/docs/octopus-rest-api/examples/projects) +- [Releases](/docs/octopus-rest-api/examples/releases) +- [Reports](/docs/octopus-rest-api/examples/reports) +- [Runbooks](/docs/octopus-rest-api/examples/runbooks) +- [Spaces](/docs/octopus-rest-api/examples/spaces) +- [Step Templates](/docs/octopus-rest-api/examples/step-templates) +- [Tag sets](/docs/octopus-rest-api/examples/tagsets) +- [Tasks](/docs/octopus-rest-api/examples/tasks) +- [Tenants](/docs/octopus-rest-api/examples/tenants) +- [Users and Teams](/docs/octopus-rest-api/examples/users-and-teams) +- [Variables](/docs/octopus-rest-api/examples/variables) +- [Bulk Operations](/docs/octopus-rest-api/examples/bulk-operations) + +## Get help from the community + +If you're looking for help with API scripts or want to share your own, join the [Octopus Community Slack channel](https://octopus.com/slack). It's a great place to get inspiration, ask questions, and connect with other Octopus users and employees. diff --git a/src/pages/docs/octopus-rest-api/examples/lifecycles/create-lifecycle.mdx b/src/pages/docs/api/examples/lifecycles/create-lifecycle.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/lifecycles/create-lifecycle.mdx rename to src/pages/docs/api/examples/lifecycles/create-lifecycle.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/lifecycles/index.md b/src/pages/docs/api/examples/lifecycles/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/lifecycles/index.md rename to src/pages/docs/api/examples/lifecycles/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/list-users-with-role.md b/src/pages/docs/api/examples/list-users-with-role.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/list-users-with-role.md rename to src/pages/docs/api/examples/list-users-with-role.md diff --git a/src/pages/docs/octopus-rest-api/examples/project-groups/create-projectgroup.mdx b/src/pages/docs/api/examples/project-groups/create-projectgroup.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/project-groups/create-projectgroup.mdx rename to src/pages/docs/api/examples/project-groups/create-projectgroup.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/project-groups/index.md b/src/pages/docs/api/examples/project-groups/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/project-groups/index.md rename to src/pages/docs/api/examples/project-groups/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/projects/coordinating-multiple-projects.mdx b/src/pages/docs/api/examples/projects/coordinating-multiple-projects.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/coordinating-multiple-projects.mdx rename to src/pages/docs/api/examples/projects/coordinating-multiple-projects.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/create-project.mdx b/src/pages/docs/api/examples/projects/create-project.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/create-project.mdx rename to src/pages/docs/api/examples/projects/create-project.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/delete-project.mdx b/src/pages/docs/api/examples/projects/delete-project.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/delete-project.mdx rename to src/pages/docs/api/examples/projects/delete-project.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/delete-projects-with-empty-processes.mdx b/src/pages/docs/api/examples/projects/delete-projects-with-empty-processes.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/delete-projects-with-empty-processes.mdx rename to src/pages/docs/api/examples/projects/delete-projects-with-empty-processes.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/disable-project-triggers.mdx b/src/pages/docs/api/examples/projects/disable-project-triggers.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/disable-project-triggers.mdx rename to src/pages/docs/api/examples/projects/disable-project-triggers.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/enable-disable-project.mdx b/src/pages/docs/api/examples/projects/enable-disable-project.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/enable-disable-project.mdx rename to src/pages/docs/api/examples/projects/enable-disable-project.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/export-projects.mdx b/src/pages/docs/api/examples/projects/export-projects.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/export-projects.mdx rename to src/pages/docs/api/examples/projects/export-projects.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/find-unused-projects.mdx b/src/pages/docs/api/examples/projects/find-unused-projects.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/find-unused-projects.mdx rename to src/pages/docs/api/examples/projects/find-unused-projects.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/import-projects.mdx b/src/pages/docs/api/examples/projects/import-projects.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/import-projects.mdx rename to src/pages/docs/api/examples/projects/import-projects.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/projects/index.md b/src/pages/docs/api/examples/projects/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/projects/index.md rename to src/pages/docs/api/examples/projects/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/publish-runbook.md b/src/pages/docs/api/examples/publish-runbook.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/publish-runbook.md rename to src/pages/docs/api/examples/publish-runbook.md diff --git a/src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md b/src/pages/docs/api/examples/register-listening-tentacle.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md rename to src/pages/docs/api/examples/register-listening-tentacle.md diff --git a/src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md b/src/pages/docs/api/examples/register-polling-tentacle.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md rename to src/pages/docs/api/examples/register-polling-tentacle.md diff --git a/src/pages/docs/octopus-rest-api/examples/releases/create-release-with-specific-version.mdx b/src/pages/docs/api/examples/releases/create-release-with-specific-version.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/releases/create-release-with-specific-version.mdx rename to src/pages/docs/api/examples/releases/create-release-with-specific-version.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/releases/delete-project-releases.mdx b/src/pages/docs/api/examples/releases/delete-project-releases.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/releases/delete-project-releases.mdx rename to src/pages/docs/api/examples/releases/delete-project-releases.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/releases/index.md b/src/pages/docs/api/examples/releases/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/releases/index.md rename to src/pages/docs/api/examples/releases/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/releases/promote-release-not-in-destination.mdx b/src/pages/docs/api/examples/releases/promote-release-not-in-destination.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/releases/promote-release-not-in-destination.mdx rename to src/pages/docs/api/examples/releases/promote-release-not-in-destination.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/releases/update-release-variable-snapshot.mdx b/src/pages/docs/api/examples/releases/update-release-variable-snapshot.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/releases/update-release-variable-snapshot.mdx rename to src/pages/docs/api/examples/releases/update-release-variable-snapshot.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/replace-certificate.md b/src/pages/docs/api/examples/replace-certificate.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/replace-certificate.md rename to src/pages/docs/api/examples/replace-certificate.md diff --git a/src/pages/docs/octopus-rest-api/examples/reports/deployments-per-target-role-report.mdx b/src/pages/docs/api/examples/reports/deployments-per-target-role-report.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/reports/deployments-per-target-role-report.mdx rename to src/pages/docs/api/examples/reports/deployments-per-target-role-report.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/reports/environment-permissions-report.mdx b/src/pages/docs/api/examples/reports/environment-permissions-report.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/reports/environment-permissions-report.mdx rename to src/pages/docs/api/examples/reports/environment-permissions-report.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/reports/index.md b/src/pages/docs/api/examples/reports/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/reports/index.md rename to src/pages/docs/api/examples/reports/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/reports/project-permissions-report.mdx b/src/pages/docs/api/examples/reports/project-permissions-report.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/reports/project-permissions-report.mdx rename to src/pages/docs/api/examples/reports/project-permissions-report.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/reports/project-release-deployment-targets-report.mdx b/src/pages/docs/api/examples/reports/project-release-deployment-targets-report.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/reports/project-release-deployment-targets-report.mdx rename to src/pages/docs/api/examples/reports/project-release-deployment-targets-report.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/run-runbook.md b/src/pages/docs/api/examples/run-runbook.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/run-runbook.md rename to src/pages/docs/api/examples/run-runbook.md diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/add-script-step-to-runbook.mdx b/src/pages/docs/api/examples/runbooks/add-script-step-to-runbook.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/runbooks/add-script-step-to-runbook.mdx rename to src/pages/docs/api/examples/runbooks/add-script-step-to-runbook.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/create-and-publish-runbook.mdx b/src/pages/docs/api/examples/runbooks/create-and-publish-runbook.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/runbooks/create-and-publish-runbook.mdx rename to src/pages/docs/api/examples/runbooks/create-and-publish-runbook.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/create-runbook.mdx b/src/pages/docs/api/examples/runbooks/create-runbook.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/runbooks/create-runbook.mdx rename to src/pages/docs/api/examples/runbooks/create-runbook.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/create-scheduled-runbook-trigger.mdx b/src/pages/docs/api/examples/runbooks/create-scheduled-runbook-trigger.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/runbooks/create-scheduled-runbook-trigger.mdx rename to src/pages/docs/api/examples/runbooks/create-scheduled-runbook-trigger.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/index.md b/src/pages/docs/api/examples/runbooks/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/runbooks/index.md rename to src/pages/docs/api/examples/runbooks/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/publish-runbook.mdx b/src/pages/docs/api/examples/runbooks/publish-runbook.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/runbooks/publish-runbook.mdx rename to src/pages/docs/api/examples/runbooks/publish-runbook.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook-with-prompted-variables.mdx b/src/pages/docs/api/examples/runbooks/run-runbook-with-prompted-variables.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook-with-prompted-variables.mdx rename to src/pages/docs/api/examples/runbooks/run-runbook-with-prompted-variables.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook.mdx b/src/pages/docs/api/examples/runbooks/run-runbook.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook.mdx rename to src/pages/docs/api/examples/runbooks/run-runbook.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments.mdx b/src/pages/docs/api/examples/spaces/add-a-space-with-environments.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments.mdx rename to src/pages/docs/api/examples/spaces/add-a-space-with-environments.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/spaces/delete-a-space.mdx b/src/pages/docs/api/examples/spaces/delete-a-space.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/spaces/delete-a-space.mdx rename to src/pages/docs/api/examples/spaces/delete-a-space.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/spaces/index.md b/src/pages/docs/api/examples/spaces/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/spaces/index.md rename to src/pages/docs/api/examples/spaces/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/step-templates/export-step-templates.mdx b/src/pages/docs/api/examples/step-templates/export-step-templates.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/step-templates/export-step-templates.mdx rename to src/pages/docs/api/examples/step-templates/export-step-templates.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/step-templates/index.md b/src/pages/docs/api/examples/step-templates/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/step-templates/index.md rename to src/pages/docs/api/examples/step-templates/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/tagsets/create-tagset.mdx b/src/pages/docs/api/examples/tagsets/create-tagset.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tagsets/create-tagset.mdx rename to src/pages/docs/api/examples/tagsets/create-tagset.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/tagsets/index.md b/src/pages/docs/api/examples/tagsets/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tagsets/index.md rename to src/pages/docs/api/examples/tagsets/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/tasks/index.md b/src/pages/docs/api/examples/tasks/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tasks/index.md rename to src/pages/docs/api/examples/tasks/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/tasks/reprioritize-tasks.mdx b/src/pages/docs/api/examples/tasks/reprioritize-tasks.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tasks/reprioritize-tasks.mdx rename to src/pages/docs/api/examples/tasks/reprioritize-tasks.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/tasks/run-healthcheck.mdx b/src/pages/docs/api/examples/tasks/run-healthcheck.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tasks/run-healthcheck.mdx rename to src/pages/docs/api/examples/tasks/run-healthcheck.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md b/src/pages/docs/api/examples/tenants/bulk-add-projects-to-tenants.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md rename to src/pages/docs/api/examples/tenants/bulk-add-projects-to-tenants.md diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/create-tenant.mdx b/src/pages/docs/api/examples/tenants/create-tenant.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tenants/create-tenant.mdx rename to src/pages/docs/api/examples/tenants/create-tenant.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/deactivate-tenant.mdx b/src/pages/docs/api/examples/tenants/deactivate-tenant.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tenants/deactivate-tenant.mdx rename to src/pages/docs/api/examples/tenants/deactivate-tenant.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/index.md b/src/pages/docs/api/examples/tenants/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tenants/index.md rename to src/pages/docs/api/examples/tenants/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/update-tenant-variable.mdx b/src/pages/docs/api/examples/tenants/update-tenant-variable.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/tenants/update-tenant-variable.mdx rename to src/pages/docs/api/examples/tenants/update-tenant-variable.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-azure-ad-to-users.mdx b/src/pages/docs/api/examples/users-and-teams/add-azure-ad-to-users.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/add-azure-ad-to-users.mdx rename to src/pages/docs/api/examples/users-and-teams/add-azure-ad-to-users.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-domain-teams.mdx b/src/pages/docs/api/examples/users-and-teams/add-domain-teams.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/add-domain-teams.mdx rename to src/pages/docs/api/examples/users-and-teams/add-domain-teams.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-environment-to-team.mdx b/src/pages/docs/api/examples/users-and-teams/add-environment-to-team.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/add-environment-to-team.mdx rename to src/pages/docs/api/examples/users-and-teams/add-environment-to-team.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/change-users-domain.mdx b/src/pages/docs/api/examples/users-and-teams/change-users-domain.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/change-users-domain.mdx rename to src/pages/docs/api/examples/users-and-teams/change-users-domain.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/create-api-key.mdx b/src/pages/docs/api/examples/users-and-teams/create-api-key.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/create-api-key.mdx rename to src/pages/docs/api/examples/users-and-teams/create-api-key.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/find-teams-with-role.mdx b/src/pages/docs/api/examples/users-and-teams/find-teams-with-role.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/find-teams-with-role.mdx rename to src/pages/docs/api/examples/users-and-teams/find-teams-with-role.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/index.md b/src/pages/docs/api/examples/users-and-teams/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/index.md rename to src/pages/docs/api/examples/users-and-teams/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-editing-roles.mdx b/src/pages/docs/api/examples/users-and-teams/list-users-with-editing-roles.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-editing-roles.mdx rename to src/pages/docs/api/examples/users-and-teams/list-users-with-editing-roles.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role.mdx b/src/pages/docs/api/examples/users-and-teams/list-users-with-role.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role.mdx rename to src/pages/docs/api/examples/users-and-teams/list-users-with-role.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users.mdx b/src/pages/docs/api/examples/users-and-teams/list-users.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users.mdx rename to src/pages/docs/api/examples/users-and-teams/list-users.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/remove-project-from-team.mdx b/src/pages/docs/api/examples/users-and-teams/remove-project-from-team.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/remove-project-from-team.mdx rename to src/pages/docs/api/examples/users-and-teams/remove-project-from-team.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx b/src/pages/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx rename to src/pages/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx b/src/pages/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx rename to src/pages/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/users/index.md b/src/pages/docs/api/examples/users/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users/index.md rename to src/pages/docs/api/examples/users/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md b/src/pages/docs/api/examples/users/list-users-with-role.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md rename to src/pages/docs/api/examples/users/list-users-with-role.md diff --git a/src/pages/docs/octopus-rest-api/examples/variables/add-library-set-to-project.mdx b/src/pages/docs/api/examples/variables/add-library-set-to-project.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/add-library-set-to-project.mdx rename to src/pages/docs/api/examples/variables/add-library-set-to-project.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/variables/add-update-project-variable.mdx b/src/pages/docs/api/examples/variables/add-update-project-variable.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/add-update-project-variable.mdx rename to src/pages/docs/api/examples/variables/add-update-project-variable.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/variables/clear-sensitive-variables.mdx b/src/pages/docs/api/examples/variables/clear-sensitive-variables.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/clear-sensitive-variables.mdx rename to src/pages/docs/api/examples/variables/clear-sensitive-variables.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-projects-using-library-set.mdx b/src/pages/docs/api/examples/variables/find-projects-using-library-set.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/find-projects-using-library-set.mdx rename to src/pages/docs/api/examples/variables/find-projects-using-library-set.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variable-usage.mdx b/src/pages/docs/api/examples/variables/find-variable-usage.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/find-variable-usage.mdx rename to src/pages/docs/api/examples/variables/find-variable-usage.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variable-value-usage.mdx b/src/pages/docs/api/examples/variables/find-variable-value-usage.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/find-variable-value-usage.mdx rename to src/pages/docs/api/examples/variables/find-variable-value-usage.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md b/src/pages/docs/api/examples/variables/find-variable-vaule-usage.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md rename to src/pages/docs/api/examples/variables/find-variable-vaule-usage.md diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variableset-variables-usage.mdx b/src/pages/docs/api/examples/variables/find-variableset-variables-usage.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/find-variableset-variables-usage.mdx rename to src/pages/docs/api/examples/variables/find-variableset-variables-usage.mdx diff --git a/src/pages/docs/octopus-rest-api/examples/variables/index.md b/src/pages/docs/api/examples/variables/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/index.md rename to src/pages/docs/api/examples/variables/index.md diff --git a/src/pages/docs/octopus-rest-api/examples/variables/update-variable-set-variable-value.mdx b/src/pages/docs/api/examples/variables/update-variable-set-variable-value.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/examples/variables/update-variable-set-variable-value.mdx rename to src/pages/docs/api/examples/variables/update-variable-set-variable-value.mdx diff --git a/src/pages/docs/octopus-rest-api/octopus.client/getting-started.mdx b/src/pages/docs/api/octopus.client/getting-started.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/octopus.client/getting-started.mdx rename to src/pages/docs/api/octopus.client/getting-started.mdx diff --git a/src/pages/docs/octopus-rest-api/octopus.client/index.md b/src/pages/docs/api/octopus.client/index.md similarity index 100% rename from src/pages/docs/octopus-rest-api/octopus.client/index.md rename to src/pages/docs/api/octopus.client/index.md diff --git a/src/pages/docs/octopus-rest-api/octopus.client/using-client-directly.md b/src/pages/docs/api/octopus.client/using-client-directly.md similarity index 100% rename from src/pages/docs/octopus-rest-api/octopus.client/using-client-directly.md rename to src/pages/docs/api/octopus.client/using-client-directly.md diff --git a/src/pages/docs/octopus-rest-api/octopus.client/using-client-in-octopus.mdx b/src/pages/docs/api/octopus.client/using-client-in-octopus.mdx similarity index 100% rename from src/pages/docs/octopus-rest-api/octopus.client/using-client-in-octopus.mdx rename to src/pages/docs/api/octopus.client/using-client-in-octopus.mdx diff --git a/src/pages/docs/octopus-rest-api/octopus.client/using-resources.md b/src/pages/docs/api/octopus.client/using-resources.md similarity index 100% rename from src/pages/docs/octopus-rest-api/octopus.client/using-resources.md rename to src/pages/docs/api/octopus.client/using-resources.md diff --git a/src/pages/docs/octopus-rest-api/octopus.client/working-with-spaces.md b/src/pages/docs/api/octopus.client/working-with-spaces.md similarity index 100% rename from src/pages/docs/octopus-rest-api/octopus.client/working-with-spaces.md rename to src/pages/docs/api/octopus.client/working-with-spaces.md diff --git a/src/pages/docs/octopus-rest-api/examples/index.md b/src/pages/docs/octopus-rest-api/examples/index.md index e40845e137..606bfdeb20 100644 --- a/src/pages/docs/octopus-rest-api/examples/index.md +++ b/src/pages/docs/octopus-rest-api/examples/index.md @@ -1,93 +1,10 @@ --- -layout: src/layouts/Default.astro +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples pubDate: 2023-01-01 -modDate: 2023-01-01 -title: API examples -description: A set of examples using the Octopus REST API to accomplish tasks. -navOrder: 40 -hideInThisSectionHeader: true +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false --- - -As you work with the Octopus API, you may need some guidance on how to perform certain actions or what parameters to provide. The [OctopusDeploy-API GitHub repository](https://github.com/OctopusDeploy/OctopusDeploy-Api) contains many examples using the API, with solutions covering: - -- PowerShell using the REST API. -- PowerShell using Octopus.Client. -- C# using Octopus.Client. -- Python using the REST API. -- Go using the [Go API Client for Octopus Deploy](https://github.com/OctopusDeploy/go-octopusdeploy). -- TypeScript using the [TypeScript API Client for Octopus Deploy](https://github.com/OctopusDeploy/api-client.ts). - -In addition, we also have a wide range of some of the more common examples here as well. - -## Using the scripts - -To use the example scripts, you'll need to provide your Octopus Server URL and an [API Key](/docs/octopus-rest-api/how-to-create-an-api-key). There may be other values that need to be updated to fit your scenario such as Space, Project, and Environment names. - -:::div{.hint} -**The examples provided are for reference and should be modified and tested prior to using in a production Octopus instance.** -::: - -### C# examples - -The C# examples are written using [dotnet script](https://github.com/filipw/dotnet-script). The same logic can be used in a standard C# application. - -### Octopus.Client examples - -Examples using [Octopus.Client](/docs/octopus-rest-api/octopus.client) require the library to be installed and a path to the library to be provided. - -### Python examples - -The Python examples are written using **Python 3** and use the [Requests](https://requests.readthedocs.io/en/master/) library. Some examples also use the [urllib](https://docs.python.org/3/library/urllib.html) module. - -### Go examples - -The Go examples are written using the [Go API Client for Octopus Deploy](https://github.com/OctopusDeploy/go-octopusdeploy). - -### Java examples - -The Java examples are written using the [java-octopus-deploy](https://github.com/OctopusDeployLabs/java-octopus-deploy) Client. - -The Java Client library requires **Java 1.8** or above. - -### TypeScript examples - -The TypeScript examples are written using the [TypeScript API Client for Octopus Deploy](https://github.com/OctopusDeploy/api-client.ts). - -## Bulk operations - -Sometimes you want to perform an action on a resource in Octopus multiple times. For example, connecting a tenant to all of your projects. Having to run a script that performs an operation once, repeatedly, can become tedious. - -To help with this, we've included examples of [bulk operations](/docs/octopus-rest-api/examples/bulk-operations) using the Octopus REST API. - -## Explore examples - -Explore the REST API examples further in this section: - -- [Accounts](/docs/octopus-rest-api/examples/accounts) -- [Artifacts](/docs/octopus-rest-api/examples/artifacts) -- [Certificates](/docs/octopus-rest-api/examples/certificates) -- [Channels](/docs/octopus-rest-api/examples/channels) -- [Deployment process](/docs/octopus-rest-api/examples/deployment-process) -- [Deployment targets](/docs/octopus-rest-api/examples/deployment-targets) -- [Deployments](/docs/octopus-rest-api/examples/deployments) -- [Environments](/docs/octopus-rest-api/examples/environments) -- [Events](/docs/octopus-rest-api/examples/events) -- [Feeds](/docs/octopus-rest-api/examples/feeds) -- [Lifecycles](/docs/octopus-rest-api/examples/lifecycles) -- [Project Groups](/docs/octopus-rest-api/examples/project-groups) -- [Projects](/docs/octopus-rest-api/examples/projects) -- [Releases](/docs/octopus-rest-api/examples/releases) -- [Reports](/docs/octopus-rest-api/examples/reports) -- [Runbooks](/docs/octopus-rest-api/examples/runbooks) -- [Spaces](/docs/octopus-rest-api/examples/spaces) -- [Step Templates](/docs/octopus-rest-api/examples/step-templates) -- [Tag sets](/docs/octopus-rest-api/examples/tagsets) -- [Tasks](/docs/octopus-rest-api/examples/tasks) -- [Tenants](/docs/octopus-rest-api/examples/tenants) -- [Users and Teams](/docs/octopus-rest-api/examples/users-and-teams) -- [Variables](/docs/octopus-rest-api/examples/variables) -- [Bulk Operations](/docs/octopus-rest-api/examples/bulk-operations) - -## Get help from the community - -If you're looking for help with API scripts or want to share your own, join the [Octopus Community Slack channel](https://octopus.com/slack). It's a great place to get inspiration, ask questions, and connect with other Octopus users and employees. diff --git a/src/pages/docs/octopus-rest-api/getting-started.mdx b/src/pages/docs/octopus-rest-api/getting-started.mdx index c06363ba4e..1e3001a215 100644 --- a/src/pages/docs/octopus-rest-api/getting-started.mdx +++ b/src/pages/docs/octopus-rest-api/getting-started.mdx @@ -1,147 +1,10 @@ --- -layout: src/layouts/Default.astro +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/ pubDate: 2024-04-10 -modDate: 2024-04-10 -title: Getting started with the Octopus REST API -navTitle: Getting started with the Octopus REST API -description: Getting started with the Octopus REST API -navOrder: 10 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false --- - -## API clients - -Octopus provides API clients for popular programming languages and runtime environments. You can access the source code for these clients on GitHub: - -- [Go API Client for Octopus Deploy](https://github.com/OctopusDeploy/go-octopusdeploy) -- [.NET C# API Client for Octopus Deploy](https://github.com/OctopusDeploy/OctopusClients) -- [TypeScript API Client for Octopus Deploy](https://github.com/OctopusDeploy/api-client.ts) - -Code snippets using these clients for operations in the Octopus REST API are available in our [API examples](/docs/octopus-rest-api/examples) documentation. - -## REST API authentication \{#authentication} - -The Octopus Deploy API is available at: - -```text -https:///api -``` - -Replace `` with the URL that you host your Octopus instance on. - -The API supports 2 methods of authentication. - -### Creating an API Key - -You can get your API key from your profile page on the Octopus Web Portal. - -After you have a key, you can provide it to the API in the following ways: - -1. Through the `X-Octopus-ApiKey` HTTP header with all requests. This is the preferred approach. -1. As an `apikey` query string parameter with all requests. You should only be used for simple requests. - -:::div{.hint} -Learn more about [how to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key). -::: - -### OpenID Connect - -OpenID Connect is a set of identity specifications that build on OAuth 2.0 to let software systems connect in a way that promotes security best practices. - -When using OIDC, Octopus validates an identity token from a trusted external system using [public key cryptography](https://en.wikipedia.org/wiki/Public-key_cryptography). Octopus then issues a short-lived access token that you can use to interact with the Octopus API. - -Some of the benefits of using OIDC in Octopus include: - -- You don't need to provision API keys and store them in external systems. This reduces the risk of unauthorized access to the Octopus API from exposed keys. -- Administrators don't need to rotate API keys manually. This reduces the risk of disruption when updating to newer keys in external systems. -- Access tokens issued by Octopus are short-lived. This reduces the risk of unauthorized access to the Octopus API. -- Access tokens are only issued for requests from trusted external systems. This allows for controlled access to service accounts and promotes the principle of least access. - -We support any issuer that can generate signed OIDC tokens that can be validated anonymously. However, we provide built-in support for GitHub Actions with the [OctopusDeploy/login](https://github.com/OctopusDeploy/login) action. - -For more information see [Using OpenId Connect with the Octopus API](https://octopus.com/docs/octopus-rest-api/openid-connect). - -## REST API Swagger documentation \{#api-swagger-docs} - -Octopus includes the default Swagger UI for displaying the API documentation in a nice, human, readable way. To browse that UI just open your browser and go to `https:///swaggerui/`. The original Non-Swagger API page is still available and you can access it via `https:///api/`. - -:::figure -![Server API](/docs/img/octopus-rest-api/images/server-api.png) -::: - -You can view the API through the Octopus Demo server at [demo.octopus.app/swaggerui/index.html](https://demo.octopus.app/swaggerui/index.html). - -## REST API links \{#api-links} - -All resources returned by the REST API contain links to other resources. The idea is that instead of memorizing or hard-coding URLs when using the API, you should start with the root API resource and use links to navigate. - -For example, a `GET` request to `/api` returns a resource that looks like: - -```json -{ - "Application": "Octopus Deploy", - "Version": "2022.1.2386", - "ApiVersion": "3.0.0", - "InstallationId": "9f155416-5d9e-4e19-ba58-b710d4edf336", - "Links": { - "Self": "/api", - "Accounts": "/api/Spaces-1/accounts{/id}{?skip,take,ids,partialName,accountType}", - "Environments": "/api/Spaces-1/environments{/id}{?name,skip,ids,take,partialName}", - "Machines": "/api/Spaces-1/machines{/id}{?skip,take,name,ids,partialName,roles,isDisabled,healthStatuses,commStyles,tenantIds,tenantTags,environmentIds,thumbprint,deploymentId,shellNames,deploymentTargetTypes}", - "Projects": "/api/Spaces-1/projects{/id}{?name,skip,ids,clone,take,partialName,clonedFromProjectId}", - "RunbookProcesses": "/api/Spaces-1/runbookProcesses{/id}{?skip,take,ids}", - "RunbookRuns": "/api/Spaces-1/runbookRuns{/id}{?skip,take,ids,projects,environments,tenants,runbooks,taskState,partialName}", - "Runbooks": "/api/Spaces-1/runbooks{/id}{?skip,take,ids,partialName,clone,projectIds}", - "RunbookSnapshots": "/api/Spaces-1/runbookSnapshots{/id}{?skip,take,ids,publish}", - "Feeds": "/api/feeds{/id}{?skip,take,ids,partialName,feedType,name}", - "Tasks": "/api/tasks{/id}{?skip,active,environment,tenant,runbook,project,name,node,running,states,hasPendingInterruptions,hasWarningsOrErrors,take,ids,partialName,spaces,includeSystem,description,fromCompletedDate,toCompletedDate,fromQueueDate,toQueueDate,fromStartDate,toStartDate}", - "Variables": "/api/Spaces-1/variables{/id}{?ids}", - "Web": "/app" - } -} -``` - -:::div{.hint} -Note: the `Links` collection example above has been significantly reduced in size for demonstration purposes. -::: - -You can follow the links in the result to navigate around the API. For example, by following the `Projects` link, you'll find a list of the projects on your Octopus server. - -Since the format and structure of links may change, it's essential that clients avoid hardcoding URL's to resources, and instead rely on starting at `/api` and navigating from there. - -### URI templates - -Some links (mainly to collections) use URI templates as defined in [RFC 6570](http://tools.ietf.org/html/rfc6570). If in doubt, a client should assume that any link is a URI template. - -### Collections - -Collections of resources also include links. For example, following the `Environments` link above will give you a list of environments. - -```json -{ - "ItemType": "Environment", - "TotalResults": 20, - "ItemsPerPage": 10, - "NumberOfPages": 2, - "LastPageNumber": 1, - "Items": [ - // ... a list of environments ... - ], - "Links": { - "Self": "/api/Spaces-1/environments?skip=0&take=10", - "Template": "/api/Spaces-1/environments{?skip,ids,take,partialName}", - "Page.All": "/api/Spaces-1/environments?skip=0&take=2147483647", - "Page.Next": "/api/Spaces-1/environments?skip=10&take=10", - "Page.Current": "/api/Spaces-1/environments?skip=0&take=10" - } -} -``` - -The links at the bottom of the resource allow you to traverse the pages of results. Again, instead of hard-coding query string parameters, you can look for a `Page.Next` link and follow that instead. - -## REST API and Spaces \{#api-and-spaces} - -If you are using spaces, you need to include the `SpaceID` in your API calls. If you do not include the `SpaceID`, your API calls will automatically use the default space. - -## REST API code samples \{#api-samples} - -Code snippet samples for various operations in the Octopus REST API are available both in our [API examples](/docs/octopus-rest-api/examples) and on the [OctopusDeploy-API GitHub repository](https://github.com/OctopusDeploy/OctopusDeploy-Api) diff --git a/src/pages/docs/octopus-rest-api/how-to-create-an-api-key.md b/src/pages/docs/octopus-rest-api/how-to-create-an-api-key.md index 30683c23c3..b803b85796 100644 --- a/src/pages/docs/octopus-rest-api/how-to-create-an-api-key.md +++ b/src/pages/docs/octopus-rest-api/how-to-create-an-api-key.md @@ -1,143 +1,10 @@ --- -layout: src/layouts/Default.astro +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/authentication/create-an-api-key pubDate: 2023-01-01 -modDate: 2026-06-19 -title: How to Create an API Key -description: How to create an API key to interact with Octopus without the need for a username and password. -navOrder: 10 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false --- - -API keys allow you to access the Octopus Deploy [REST API](/docs/octopus-rest-api) and perform tasks such as creating and deploying releases. API keys can be saved in scripts or external tools, without having to use your username and password. Each user and service account can have multiple API keys. - -See the [Service Accounts docs](/docs/security/users-and-teams/service-accounts) for information about creating service accounts. - -## Creating an API Key - -[Getting Started - API Keys](https://www.youtube.com/watch?v=f3-vRjpB0cE) - -You can create API keys by performing the following steps: - -1. Log into the Octopus Web Portal, click your profile image and select **Profile**. -1. Click **My API Keys**. -1. Click **New API key**, state the purpose of the API key. -1. Choose the level of **Access** to grant (see below). -1. Click **Generate new**. -1. Copy the new API key to your clipboard. - -:::div{.warning} -**Write Your Key Down** -After you generate an API key, it cannot be retrieved from the Octopus Web Portal again, we store only a one-way hash of the API key. If you want to use the API key again, you need to store it in a secure place such as a password manager. Read about [why we hash API keys](https://octopus.com/blog/hashing-api-keys). -::: - -## Creating an agent API key {#creating-an-agent-api-key} - -If you're connecting an AI agent to Octopus—such as the [Octopus MCP server](/docs/octopus-ai/mcp)—create a dedicated agent API key rather than a regular one. Agent keys are tagged throughout Octopus so you can filter for and audit agent activity separately from human activity. - -You can also create an agent API key directly from the **API Keys** page: - -1. Click **New API key for AI Agent** and state the purpose of the key. -1. Choose the level of **Access** to grant. -1. Click **Generate new**. -1. Copy the new API key to your clipboard. - -## Choosing an access level - -:::div{.hint} - -This feature is currently being rolled out to Octopus Cloud customers and will become available to self-hosted installations in Octopus Server 2026.3. - -If you don't see the access option when creating an API key, the API key will be created with full access and have the same permissions as your user account. - -::: - -Recent versions of Octopus Server add the ability to limit the scope of an API key, to allow only read-only access. Alternatively, you can grant the API key full access to give it the same permissions as your user account. Use the **Preview Permissions** link to see the exact list of permissions that apply to the chosen access level. - -Read-only scopes are useful for tooling that doesn't need to be able to make changes, perform actions or trigger deployments, such as AI agents (like Claude Code) or for external monitoring systems (like release progression dashboards). - -Note that it is not possible to create an API key with more permissions than your user account. For these scenarios, you should look at creating an API key under a dedicated [Service Account](/docs/security/users-and-teams/service-accounts) instead. Use this approach for tooling that is not acting on behalf of a particular user. - -## Setting an expiry date - -:::div{.hint} -The ability to set an expiry date on new API keys was added in Octopus Deploy **2020.6**. -::: -By default, new API keys are valid for 180 days from the point they are created. - -When creating an API key in the Octopus Web Portal, you can choose from a preset list of offsets from the current date, or select a custom date. Keys will expire at the end of the selected day. When using the Octopus REST API to create a key, you can set the expiry date to your preferred date and time, including time zone offset. - -There are three restrictions on the expiry date: - -- It cannot be in the past. -- It cannot be after the expiry date of the key being used to create it (when using the REST API). -- **Octopus Deploy 2025.4 and newer:** It cannot exceed the server's configured maximum expiry period (defaults to 366 days, configurable) - -## Configure API keys for expiry notifications - -[Octopus Subscriptions](/docs/administration/managing-infrastructure/subscriptions) can be used to configure notifications when API keys are close to expiry or have expired. - -There is an "API key expiry events" event-group and three events: - -- API key expiry 20-day warning. -- API key expiry 10-day warning. -- API key expired. - -:::div{.info} - -The background task which raises the api-key-expiry events runs: - -- 10 minutes after the Octopus Server service starts -- Every 4 hours - -::: - -## Configuring API Key default and maximum expiry durations - -:::div{.hint} -The ability to control the default and maximum API key expiry was added in Octopus Deploy **2025.4**. The ability to create keys that never expire was removed in this version. - -Versions 2025.3 and below will use a default expiry of 180 days and have no maximum. -::: - -Octopus administrators can change the maximum API key expiry from 366 days to a value of their choice, up to 1096 days. - -Octopus administrators can change the default API key expiry from 180 days to a value of their choice. The default period must be less than or equal to the maximum. - -To change these values in the Octopus Web Portal: - -1. Navigate to **Configuration ➜ Settings** and click **Authentication**. -1. Expand the sections for **API Key default expiry (days)** and **API Key maximum expiry (days)** and alter the values. -1. Click Save. - -## Managing API keys - -Octopus administrators can view all API keys across the instance from the **API Keys** page. - -### Identifying key types - -Each key's row shows an **API key type** column with a type tag—**User**, or **AI Agent**—so you can tell at a glance which kind of identity each key belongs to. - -### Filtering by agent - -Check **AI Agents** to filter the list to agent keys only. This is useful when you want to review the credentials your agents are using without wading through keys belonging to human users. - -### Last used - -The list shows when each key was last used. Use this to spot dormant credentials that may need rotating. - -### Viewing permissions - -Each row has an overflow menu. Select **View permissions** to open the Test Permissions page for that identity, so you can see exactly what the key can do. - -## Disabling API key creation for user accounts - -:::div{.hint} -The ability to disable API key creation for user accounts was added in Octopus Deploy **2023.2**. -::: - -Octopus administrators can disable the creation of API keys for regular user accounts. Existing API keys will continue to function, and new API keys can still be created for [Service Accounts](/docs/security/users-and-teams/service-accounts). - -To change the value in the Octopus Web Portal: - -1. Navigate to **Configuration ➜ Settings** and click **Authentication**. -1. Expand the section for **User API Keys** and alter the value. -1. Click Save. diff --git a/src/pages/docs/octopus-rest-api/index.mdx b/src/pages/docs/octopus-rest-api/index.mdx index ad1b3be062..5eb9d0fda9 100644 --- a/src/pages/docs/octopus-rest-api/index.mdx +++ b/src/pages/docs/octopus-rest-api/index.mdx @@ -1,37 +1,10 @@ --- -layout: src/layouts/Default.astro +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api pubDate: 2023-01-01 -modDate: 2024-05-24 -title: Octopus REST API -subtitle: Octopus is built API-first -icon: fa-solid fa-circle-nodes -navTitle: Overview -navSection: Octopus REST API -description: Octopus integrates with build servers, scripts, external applications and anything else with its REST API. -navOrder: 130 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false --- - -import RestApi from "src/shared-content/concepts/rest-api.include.md"; - -The opinions and functionality in Octopus are designed to make you productive, but they might not work for everyone. So we've built plenty of escape hatches. You can change the default behaviors, run custom scripts in your deployment process, or use a comprehensive API that does everything the UI can do. - - - -We designed the Octopus REST API to: - -1. Be friendly and easy to figure out. -2. Be [hypermedia driven](http://en.wikipedia.org/wiki/HATEOAS), using links and the occasional [URI template](http://tools.ietf.org/html/rfc6570). -3. Be comprehensive - 100% of the actions you perform via the Octopus UI, you can perform via the API. -4. Provide a great developer experience through [API clients](/docs/octopus-rest-api/octopus.client) and [detailed examples](/docs/octopus-rest-api/examples). - -## Octopus Command Line (CLI) - -The Octopus CLI is a command line tool that builds on top of the [Octopus Deploy REST API](/docs/octopus-rest-api). With the Octopus CLI, you can push your application packages for deployment as either zip or NuGet packages, and manage your environments, deployments, projects, and workers. - -The Octopus CLI can be used on Windows, Mac, Linux, and Docker. For installation options and direct downloads, visit the [CLI Readme](https://github.com/OctopusDeploy/cli/blob/main/README.md). - -For more information see [Octopus Command Line (CLI)](/docs/cli). - -## Next steps - -Follow our [getting started with the Octopus REST API](/docs/octopus-rest-api/getting-started) guide or learn [how to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key). diff --git a/src/pages/docs/octopus-rest-api/migration-api.md b/src/pages/docs/octopus-rest-api/migration-api.md new file mode 100644 index 0000000000..f449fd01b1 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/migration-api.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/migrations +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/migration-api/index.md b/src/pages/docs/octopus-rest-api/migration-api/index.md deleted file mode 100644 index 4ef3e178aa..0000000000 --- a/src/pages/docs/octopus-rest-api/migration-api/index.md +++ /dev/null @@ -1,249 +0,0 @@ ---- -layout: src/layouts/Default.astro -pubDate: 2023-01-01 -modDate: 2024-06-25 -title: Migration API in Octopus -navTitle: Migration API -description: Octopus includes a migration API that provides the ability to back-up and restore parts of an Octopus Deploy instance remotely. -navOrder: 90 ---- - -Octopus includes a migration API that provides the ability to back-up and restore parts of an Octopus Deploy instance remotely. - -The API currently includes support for both the [partial-export](/docs/octopus-rest-api/octopus.migrator.exe-command-line/partial-export/) and [import](/docs/octopus-rest-api/octopus.migrator.exe-command-line/import/) commands. The API uses the same [Migrator.exe command line tool](/docs/octopus-rest-api/octopus.migrator.exe-command-line) that you'd typically use to migrate data manually, but the API gives you some additional parameters to orchestrate the process between remote servers. - -:::div{.warning} -**Note:** the migration API is **not supported** for migrations from self-hosted Octopus Server to Octopus Cloud currently - please see [migrating from self-hosted to Octopus Cloud](/docs/octopus-cloud/migrations) for information on how to migrate to Octopus Cloud. -::: - -## How it works - -When you trigger a migration via the API, your Octopus Server will queue up a migration task that you can view from your **Tasks** screen. During execution of this task, your Octopus Server will go into [maintenance mode](/docs/administration/managing-infrastructure/maintenance-mode) to try and minimize any data mutations during the migration. When the task is completed, it will be taken out of maintenance mode. - -:::div{.warning} -We advise that you only use the migration API under the same conditions that you'd typically do a manual migration, i.e., during a maintenance period when you know that: - - 1. You're not going to interrupt your daily deployment operations. - 1. You'll minimize the chance of data mutations during the migration itself. - 1. The versions of your source and destination servers are the same (don't try and export/import between different versions of Octopus). - -::: - -The typical process for migrating projects between a source and destination server is as follows: - -1. Create an API key for your source server (the server you're exporting from). -1. Create an API key for your destination server (the server you're importing to). -1. Get a list of project names that you wish to export from your source server. -1. Call the `partial-export` migration API against your source server, telling it the destination server URL, API key, password for your migration package, and the list of project names you want to export *(You'll receive a 200 response from the API telling you the TaskId that has been queued to do the actual work)*. -1. At this point, your source server's task queue will then execute the `partial-export` command using `Migrator.exe`, package up the contents of your export and push it to your destination server's package feed. -1. Watch your source server's migration task in the Octopus UI to know when this operation is complete ... *Or if you're really keen, you could write a script that queries the task API and it will let you know when the migration task is complete (as seen in the [Octopus.Clients example](#octopusclients-example) below)*. -1. Call the `import` migration API against your destination server, telling it the package and password to import from *(You'll receive a 200 response from the API telling you the TaskId that has been queued to do the actual work)*. -1. Your destination server's task queue will then execute an `import` command using `Migrator.exe`. -1. *At this point, your destination server's task queue will then execute the `import` command using `Migrator.exe`.* - -## Partial export API - -Using the partial-export API, we can export one or more of our projects and choose to send the package to the destination Octopus Server's package feed. - -Partial Export API parameters: - -| Parameter | Description | -| -------------------------------- | ------------- | -| Password=VALUE | Password to encrypt both the migration package and any sensitive values (This is the shared key between partial-export and import migrations) | -| Projects=VALUE | Projects to include in the migration | -| PackageId=VALUE | [Optional] Package Name/ID for your export *(Defaults to `Octopus.Space.Migration` if not provided)* | -| PackageVersion=VALUE | [Optional] SemVer package version for your export *(Defaults to `1.0.0-{RandomStringGenerator.Generate(8)}` if not provided)* | -| IgnoreCertificates | [Optional] Excludes certificates from partial export | -| IgnoreMachines | [Optional] Excludes machines from partial export | -| IgnoreDeployments | [Optional] Excludes deployments from partial export | -| IgnoreTenants | [Optional] Excludes tenants from partial export | -| IncludeTaskLogs | [Optional] Include the task log folder as part of the export | -| EncryptPackage | [Optional] Encrypt the contents of your migration package *(Uses the `Password` as a shared key so this can be decrypted by your destination server)* | -| DestinationApiKey=VALUE | [Optional] The API key of your destination server *(Where you'll be importing this exported package)* | -| DestinationPackageFeed=VALUE | [Optional] The destination Octopus Server base URL *(e.g. )* | -| SuccessCallbackUri=VALUE | [Optional] A webhook URL you can add if you wish to be notified on successful completion of the migration task *(Your Octopus Server will call this URL using a GET request, appending the `packageId` and `packageVersion` to the URL as querystring parameters)* | -| FailureCallbackUri=VALUE | [Optional] A webhook URL you can add if you wish to be notified on failure of the migration task *(Your Octopus Server will call this URL using a GET request)* | -| TaskId | [Response only] This will be populated with the TaskId that gets queued for this migration | - -## Import API - -The import API lets you import a migration package from your Octopus Server's built-in package feed (which is where packages are pushed to when using the partial-export API). - -Import API parameters: - -| Parameter | Description | -| -------------------------------- | ------------- | -| Password=VALUE | Password that was used during the export migration *(This is the shared key between partial-export and import migrations)* | -| PackageId=VALUE | Package Name/ID that we are importing | -| PackageVersion=VALUE | SemVer package version that we are importing | -| DestinationPackageFeedSpaceId=VALUE | [Optional] If using the Spaces feature, the ID of the Space where the package containing the data to migrate will be uploaded. This is only for the package; the data in the package specifies its own destination Space. | -| IsEncryptedPackage | [Optional] Tells us whether the package was encrypted *(E.g. if you set `EncryptPackage` on export, you need to set this to `True`)* | -| IsDryRun | [Optional] Do not commit changes, just print what would have happened *(This allows you to test an import without actually committing the transaction)* | -| OverwriteExisting | [Optional] If a document with the same name already exists, it will be skipped by default | -| DeletePackageOnCompletion | [Optional] Removes the migration package that you're importing from on successful completion of the import | -| SuccessCallbackUri=VALUE | [Optional] A webhook URL you can add if you wish to be notified on successful completion of the migration task *(Your Octopus Server will call this URL using a GET request, appending the `packageId` and `packageVersion` to the URL)* | -| FailureCallbackUri=VALUE | [Optional] A webhook URL you can add if you wish to be notified on failure of the migration task *(Your Octopus Server will call this URL using a GET request)* | -| TaskId | [Response only] This will be populated with the TaskId that gets queued for this migration | - -## Examples - -### Raw request - -You can trigger a request however you prefer, using curl, Fiddler, or your tool of choice... - -#### Partial export - -```text -Request Method: POST -Request URL: https://YOUR_SOURCE_OCTOPUS_SERVER/api/migrations/partialexport -Request Headers: -- Content-Type: application/json -- X-Octopus-ApiKey: API-YOUR-SOURCE-KEY -Request Body: -{ - "PackageId": "MyAwesomeOctopusMigration", - "PackageVersion": "1.0.0", - "Password": "Demo1234", - "Projects": ["First Project", "Second Project"], - "EncryptPackage": true, - "IncludeTaskLogs": true, - "DestinationApiKey": "API-YOUR-DESTINATION-KEY", - "DestinationPackageFeed": "https://YOUR_DESTINATION_OCTOPUS_SERVER" -} -``` - -#### Import - -```text -Request Method: POST -Request URL: https://YOUR_DESTINATION_OCTOPUS_SERVER/api/migrations/import -Request Headers: -- Content-Type: application/json -- X-Octopus-ApiKey: API-YOUR-DESTINATION-KEY -Request Body: -{ - "PackageId": "MyAwesomeOctopusMigration", - "PackageVersion": "1.0.0", - "Password": "Demo1234", - "IsDryRun": "true", // Only set this to false when you've reviewed the dry run and are happy to proceed with the migration for real. - "IsEncryptedPackage": true, -} -``` - -### Spaces - -If you are using the Spaces feature of Octopus Deploy on the source server, you should supply the appropriate SpaceID values in the example below. The destination Space cannot be specified; it will match the Source. There are two values to supply: - - 1. The location to look for the Projects in the source Space. - 2. The Space that has the feed we'll be pushing the exported package to. - - If you are not using the Spaces feature, you do not need to supply the SpaceID values. - -### Octopus.Clients example - -The [Octopus.Clients library](/docs/octopus-rest-api/octopus.client) can also help you run a migration. - -Here's an example showing you how that might look, performing a `partial-export` from a *source server* and sending it to a *destination server*, then automatically running the associated `import` on the *destination server*: - -```powershell -Add-Type -Path 'YOUR_LOCAL_PATH\Octopus.Client.dll' - -$sourceOctopusURI = 'https://SOURCE_OCTOPUS_SERVER' -$sourceApikey = 'API-YOUR-SOURCE-KEY' -$destinationOctopusURI = 'https://DESTINATION_OCTOPUS_SERVER' -$destinationApikey = 'API-YOUR-DESTINATION-KEY' - -# Spaces related -$sourceSpaceId = 'Spaces-1' -$destinationPackageFeedSpaceId = 'Spaces-1' - -$migrationPackageId = 'MyAwesomeOctopusMigration' -$migrationPackageVersion = '1.0.0' -$migrationPassword = 'Demo1234' -$isDryRun = $true # Only set this to false when you've reviewed the dry run and are happy to proceed with the migration for real. - -$sourceEndpoint = New-Object Octopus.Client.OctopusServerEndpoint $sourceOctopusURI,$sourceApikey -$sourceRepository = New-Object Octopus.Client.OctopusRepository $sourceEndpoint - -$migrationExportResource = new-object Octopus.Client.Model.Migrations.MigrationPartialExportResource -$migrationExportResource.PackageId = $migrationPackageId -$migrationExportResource.PackageVersion = $migrationPackageVersion -$migrationExportResource.Password = $migrationPassword -$migrationExportResource.Projects = @('First Project', 'Second Project') -$migrationExportResource.IgnoreCertificates = $false -$migrationExportResource.IgnoreMachines = $false -$migrationExportResource.IgnoreDeployments = $false -$migrationExportResource.IgnoreTenants = $false -$migrationExportResource.IncludeTaskLogs = $true -$migrationExportResource.EncryptPackage = $true -$migrationExportResource.DestinationPackageFeed = $destinationOctopusURI -$migrationExportResource.DestinationApiKey = $destinationApikey - -$migrationExportResource.SpaceId = $sourceSpaceId -$migrationExportResource.DestinationPackageFeedSpaceId = $destinationPackageFeedSpaceId - - -$migrationExportResource = $sourceRepository.Migrations.PartialExport($migrationExportResource) - -Write-Host("Export task queued: $($migrationExportResource.TaskId)") -$migrationExportTask = $sourceRepository.Tasks.Get($migrationExportResource.TaskId); -if ($migrationExportTask -eq $null) { - Write-Host ("Export failed. You'll need to investigate.") - Exit -} - -# Now we can poll this migration task to know when our export is complete #ScriptingFTW -Write-Host("Export task: $($migrationExportTask.Id)") -while($migrationExportTask -and ($migrationExportTask.State -eq 'Queued' -or $migrationExportTask.State -eq 'Executing' -or $migrationExportTask.State -eq 'Cancelling')){ - Write-Host("Export task status: $($migrationExportTask.State). Re-checking in 5 seconds...") - start-sleep -s 5 - $migrationExportTask = $sourceRepository.Tasks.Get($migrationExportTask.Id); -} -Write-Host("Export task completed: $($migrationExportTask.State)") - -if ($migrationExportTask.State -ne 'Success' -or $migrationExportTask.HasWarningsOrErrors -eq $true) { - Write-Host ("Export failed or has warnings/errors. You'll need to investigate.") - Exit -} - -# From here, we can proceed with an import on our destination server. -$destinationEndpoint = New-Object Octopus.Client.OctopusServerEndpoint $destinationOctopusURI,$destinationApikey -$destinationRepository = New-Object Octopus.Client.OctopusRepository $destinationEndpoint - -$migrationImportResource = new-object Octopus.Client.Model.Migrations.MigrationImportResource -$migrationImportResource.PackageId = $migrationPackageId -$migrationImportResource.PackageVersion = $migrationPackageVersion -$migrationImportResource.Password = $migrationPassword -$migrationImportResource.IsDryRun = $isDryRun -$migrationImportResource.IsEncryptedPackage = $true -$migrationImportResource.DeletePackageOnCompletion = $true # May as well clean up after ourselves. - -$migrationImportResource = $destinationRepository.Migrations.Import($migrationImportResource) - -Write-Host("Import task queued: $($migrationExportResource.TaskId)") -$migrationImportTask = $destinationRepository.Tasks.Get($migrationImportResource.TaskId); -if ($migrationImportTask -eq $null) { - Write-Host ("Import failed. You'll need to investigate.") - Exit -} - -# Now we can poll this migration task to know when our import is complete. -Write-Host("Import task: $($migrationImportTask.Id)") -while($migrationImportTask -and ($migrationImportTask.State -eq 'Queued' -or $migrationImportTask.State -eq 'Executing' -or $migrationImportTask.State -eq 'Cancelling')){ - Write-Host("Import task status: $($migrationImportTask.State). Re-checking in 5 seconds...") - start-sleep -s 5 - $migrationImportTask = $destinationRepository.Tasks.Get($migrationImportTask.Id); -} -Write-Host("Import task completed: $($migrationImportTask.State)") - -if ($migrationImportTask.State -ne 'Success' -or $migrationImportTask.HasWarningsOrErrors -eq $true) { - Write-Host ("Import failed or has warnings/errors. You'll need to investigate.") - Exit -} - -Write-Host ("Migration complete, #GreatSuccess") -``` - -## Troubleshooting - -We do our best to log information and warnings to your task logs during a migration. An API migration follows the same path as a manual migration using [Migrator.exe command line tools](/docs/octopus-rest-api/octopus.migrator.exe-command-line/) behind the scenes, so if you are having difficulty running migrations, be sure to check your [task logs](/docs/support/get-the-raw-output-from-a-task) for information that might help. diff --git a/src/pages/docs/octopus-rest-api/octopus.client.md b/src/pages/docs/octopus-rest-api/octopus.client.md new file mode 100644 index 0000000000..c5eb42c68c --- /dev/null +++ b/src/pages/docs/octopus-rest-api/octopus.client.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/octopus.client +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/openid-connect.md b/src/pages/docs/octopus-rest-api/openid-connect.md new file mode 100644 index 0000000000..427d7ce7e1 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/openid-connect.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/authentication/openid-connect +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- From e85089bec7feb1af21e47479c2b36f9bdff07c4f Mon Sep 17 00:00:00 2001 From: Orion Edwards Date: Tue, 1 Sep 2026 23:56:53 +1200 Subject: [PATCH 2/8] Remove underConstruction so API shows up in search results --- src/lib/searchIndexing.ts | 3 +-- src/lib/underConstruction.ts | 26 -------------------------- src/pages/docs/sitemap.xml.ts | 6 ------ tests/api-page.spec.ts | 32 -------------------------------- 4 files changed, 1 insertion(+), 66 deletions(-) delete mode 100644 src/lib/underConstruction.ts diff --git a/src/lib/searchIndexing.ts b/src/lib/searchIndexing.ts index b21aa20b17..0660907dac 100644 --- a/src/lib/searchIndexing.ts +++ b/src/lib/searchIndexing.ts @@ -5,7 +5,6 @@ import type { Frontmatter } from 'astro-accelerator-utils/types/Frontmatter'; import { classify } from '../scripts/search-engine'; -import { isUnderConstructionUrl } from './underConstruction'; type ArticleAttributes = { 'data-pagefind-ignore'?: string; @@ -49,7 +48,7 @@ export function searchIndexAttributes( frontmatter: Frontmatter ): IndexAttributes { const indexable = - frontmatter.navSearch !== false && !isUnderConstructionUrl(pathname); + frontmatter.navSearch !== false; // `all` rather than the default `index`: a bare ignore still lets Pagefind // read a title or metadata out of the block. diff --git a/src/lib/underConstruction.ts b/src/lib/underConstruction.ts deleted file mode 100644 index e5e1b80301..0000000000 --- a/src/lib/underConstruction.ts +++ /dev/null @@ -1,26 +0,0 @@ -// TEMPORARY - delete this file when the API reference goes live. -// -// The generated API reference under src/pages/docs/api is published, but the -// section is still under construction: there is no landing page, the existing -// /docs/octopus-rest-api content has not been folded in, and nothing links to -// it. Until that work lands we keep it out of the site search index and out of -// sitemap.xml, so neither readers nor Google arrive at it ahead of the pages -// that explain it. -// -// Two call sites, which is why there are two entry points. sitemap.xml.ts takes -// its page list from an `import.meta.glob` rooted at src/pages/docs, so the paths -// it passes in look like './api/feeds.md'; `searchIndexAttributes` has the -// rendered URL. - -const UNDER_CONSTRUCTION = [/^api(\/|$)/]; - -/** True for a page that is built and published, but deliberately not indexed. */ -export function isUnderConstruction(globPath: string): boolean { - const path = globPath.replace(/^\.?\//, ''); - return UNDER_CONSTRUCTION.some((pattern) => pattern.test(path)); -} - -/** The same test against a rendered page's URL. */ -export function isUnderConstructionUrl(pathname: string): boolean { - return isUnderConstruction(pathname.replace(/^\/docs\//, '')); -} diff --git a/src/pages/docs/sitemap.xml.ts b/src/pages/docs/sitemap.xml.ts index a35166336c..a80c3e75cc 100644 --- a/src/pages/docs/sitemap.xml.ts +++ b/src/pages/docs/sitemap.xml.ts @@ -4,7 +4,6 @@ import { accelerator } from '@lib/accelerator'; import { SITE } from '@config'; import { PostFiltering } from 'astro-accelerator-utils'; -import { isUnderConstruction } from '@lib/underConstruction'; import { flattenGeneratedPath } from '@lib/generatedPaths'; async function getData() { @@ -14,11 +13,6 @@ async function getData() { let pages = []; for (const path in allPages) { - // Temporary - see src/lib/underConstruction.ts. - if (isUnderConstruction(path)) { - continue; - } - const article: any = await allPages[path](); const addToSitemap = PostFiltering.showInSitemap(article); diff --git a/tests/api-page.spec.ts b/tests/api-page.spec.ts index 88afbd4cfa..e7cff2137b 100644 --- a/tests/api-page.spec.ts +++ b/tests/api-page.spec.ts @@ -61,38 +61,6 @@ test.describe('api page chrome', () => { await expect(overlay).toBeVisible(); }); - test('the section is kept out of the search index and the sitemap', async ({ - page, - request, - }) => { - // Temporary, alongside src/lib/underConstruction.ts - delete with it when - // the API reference goes live. - // - // Asked through the overlay rather than of an index file, because the index - // is now a directory of compressed chunks. What has to hold: a reader - // searching a word the API reference is full of must not be sent into it. - await page.goto('/docs/'); - await page - .locator('input[data-docs-search-trigger]:visible') - .first() - .click(); - await page.locator('[data-docs-search-input]').fill('accounts'); - - // The href assertion below passes on an empty list, so the visibility check - // is what makes this test mean anything. `accounts` names pages in the API - // reference *and* pages outside it, which is what keeps the list non-empty. - const results = page.locator('[data-docs-search-results] [role="option"]'); - await expect(results.first()).toBeVisible({ timeout: 30_000 }); - - const hrefs = await results.evaluateAll((rows) => - rows.map((row) => row.getAttribute('href') ?? '') - ); - expect(hrefs.filter((href) => href.includes('/docs/api/'))).toEqual([]); - - const sitemap = await (await request.get('/docs/sitemap.xml')).text(); - expect(sitemap).not.toContain('/docs/api/'); - }); - test('the pages Astro does not route are not published', async ({ request, }) => { From 31d80540a465c10da1ca433ff48f8325faece22b Mon Sep 17 00:00:00 2001 From: Orion Edwards Date: Wed, 2 Sep 2026 00:05:57 +1200 Subject: [PATCH 3/8] Fix links to things under /api, and install redirects under the old /octopus-rest-api/examples --- .../how-high-availability-works.md | 2 +- src/pages/docs/api/examples/accounts/index.md | 6 +-- .../docs/api/examples/artifacts/index.md | 6 +-- .../api/examples/bulk-operations/index.md | 4 +- .../docs/api/examples/certificates/index.md | 4 +- src/pages/docs/api/examples/channels/index.md | 2 +- src/pages/docs/api/examples/events/index.md | 2 +- src/pages/docs/api/examples/feeds/index.md | 14 +++--- src/pages/docs/api/examples/index.md | 50 +++++++++---------- .../docs/api/examples/lifecycles/index.md | 2 +- .../docs/api/examples/project-groups/index.md | 2 +- src/pages/docs/api/examples/projects/index.md | 18 +++---- src/pages/docs/api/examples/releases/index.md | 8 +-- src/pages/docs/api/examples/runbooks/index.md | 14 +++--- .../api/examples/runbooks/publish-runbook.mdx | 2 +- src/pages/docs/api/examples/spaces/index.md | 4 +- .../docs/api/examples/step-templates/index.md | 2 +- src/pages/docs/api/examples/tasks/index.md | 4 +- src/pages/docs/api/examples/tenants/index.md | 6 +-- .../api/examples/users-and-teams/index.md | 24 ++++----- .../swap-ad-domain-group-with-ldap-group.mdx | 2 +- .../swap-users-ad-domain-to-ldap.mdx | 2 +- .../docs/api/examples/variables/index.md | 16 +++--- src/pages/docs/api/octopus.client/index.md | 2 +- .../dynamic-infrastructure/index.mdx | 12 ++--- .../automating-tentacle-installation.mdx | 4 +- .../examples/accounts/create-aws-account.mdx | 10 ++++ .../create-azure-service-principal.mdx | 10 ++++ .../examples/accounts/create-gcp-account.mdx | 10 ++++ .../examples/accounts/index.md | 10 ++++ .../examples/add-a-space-with-environments.md | 10 ++++ .../examples/add-azure-web-app.md | 10 ++++ .../examples/add-environment-to-step.md | 10 ++++ .../artifacts/create-and-upload-artifacts.mdx | 10 ++++ .../download-deployment-artifacts.mdx | 10 ++++ .../artifacts/download-runbook-artifacts.mdx | 10 ++++ .../examples/artifacts/index.md | 10 ++++ .../bulk-add-projects-to-tenants.mdx | 10 ++++ .../examples/bulk-operations/index.md | 10 ++++ ...ments-and-runbooks-after-node-shutdown.mdx | 10 ++++ .../examples/cancel-queued-deployments.md | 10 ++++ .../certificates/create-certificate.mdx | 10 ++++ .../examples/certificates/index.md | 10 ++++ .../certificates/replace-certificate.mdx | 10 ++++ .../examples/change-machine-machinepolicy.md | 10 ++++ .../examples/channels/create-channel.mdx | 10 ++++ .../examples/channels/index.md | 10 ++++ .../examples/create-and-deploy-a-release.md | 10 ++++ .../create-azure-service-principal.md | 10 ++++ .../examples/create-certificate.md | 10 ++++ .../examples/create-project.md | 10 ++++ .../examples/create-runbook.md | 10 ++++ .../examples/create-script-step.md | 10 ++++ .../examples/delete-a-space.md | 10 ++++ .../examples/delete-machines-by-role.md | 10 ++++ .../examples/delete-project-releases.md | 10 ++++ .../add-environment-to-step.mdx | 10 ++++ .../deployment-process/create-script-step.mdx | 10 ++++ .../get-steps-using-package.mdx | 10 ++++ .../get-steps-using-role.mdx | 10 ++++ .../examples/deployment-process/index.md | 10 ++++ .../deployment-targets/add-azure-web-app.mdx | 10 ++++ .../deployment-targets/add-target-role.mdx | 10 ++++ .../add-tenant-to-target.mdx | 10 ++++ .../change-target-machinepolicy.mdx | 10 ++++ .../check-for-tentacle-upgrades.mdx | 10 ++++ .../delete-machines-by-name.mdx | 10 ++++ .../delete-machines-by-role.mdx | 10 ++++ .../enable-disable-machine.mdx | 10 ++++ .../deployment-targets/find-target-usage.mdx | 10 ++++ .../find-unused-targets.mdx | 10 ++++ .../examples/deployment-targets/index.md | 10 ++++ .../register-listening-tentacle.mdx | 10 ++++ .../register-polling-tentacle.mdx | 10 ++++ .../register-ssh-target.mdx | 10 ++++ .../deployment-targets/upgrade-machines.mdx | 10 ++++ .../deployments/cancel-queued-deployments.mdx | 10 ++++ .../create-and-deploy-a-release.mdx | 10 ++++ ...deploy-release-with-prompted-variables.mdx | 10 ++++ .../examples/deployments/deploy-release.mdx | 10 ++++ .../examples/deployments/index.md | 10 ++++ .../list-deployments-to-environment.mdx | 10 ++++ .../environments/add-environments.mdx | 10 ++++ .../examples/environments/index.md | 10 ++++ .../examples/events/find-events-by-date.mdx | 10 ++++ .../octopus-rest-api/examples/events/index.md | 10 ++++ .../examples/feeds/change-feed.mdx | 10 ++++ .../examples/feeds/create-feed.mdx | 10 ++++ .../examples/feeds/delete-feed.mdx | 10 ++++ .../download-package-from-builtin-feed.mdx | 10 ++++ .../examples/feeds/get-feeds.md | 10 ++++ .../octopus-rest-api/examples/feeds/index.md | 10 ++++ .../feeds/push-package-to-builtin-feed.mdx | 10 ++++ .../examples/feeds/retrieve-feeds.mdx | 10 ++++ .../examples/feeds/synchronize-packages.mdx | 10 ++++ .../examples/get-steps-using-role.md | 10 ++++ .../examples/lifecycles/create-lifecycle.mdx | 10 ++++ .../examples/lifecycles/index.md | 10 ++++ .../examples/list-users-with-role.md | 10 ++++ .../project-groups/create-projectgroup.mdx | 10 ++++ .../examples/project-groups/index.md | 10 ++++ .../coordinating-multiple-projects.mdx | 10 ++++ .../examples/projects/create-project.mdx | 10 ++++ .../examples/projects/delete-project.mdx | 10 ++++ .../delete-projects-with-empty-processes.mdx | 10 ++++ .../projects/disable-project-triggers.mdx | 10 ++++ .../projects/enable-disable-project.mdx | 10 ++++ .../examples/projects/export-projects.mdx | 10 ++++ .../projects/find-unused-projects.mdx | 10 ++++ .../examples/projects/import-projects.mdx | 10 ++++ .../examples/projects/index.md | 10 ++++ .../examples/publish-runbook.md | 10 ++++ .../examples/register-listening-tentacle.md | 10 ++++ .../examples/register-polling-tentacle.md | 10 ++++ .../create-release-with-specific-version.mdx | 10 ++++ .../releases/delete-project-releases.mdx | 10 ++++ .../examples/releases/index.md | 10 ++++ .../promote-release-not-in-destination.mdx | 10 ++++ .../update-release-variable-snapshot.mdx | 10 ++++ .../examples/replace-certificate.md | 10 ++++ .../deployments-per-target-role-report.mdx | 10 ++++ .../environment-permissions-report.mdx | 10 ++++ .../examples/reports/index.md | 10 ++++ .../reports/project-permissions-report.mdx | 10 ++++ ...ject-release-deployment-targets-report.mdx | 10 ++++ .../octopus-rest-api/examples/run-runbook.md | 10 ++++ .../runbooks/add-script-step-to-runbook.mdx | 10 ++++ .../runbooks/create-and-publish-runbook.mdx | 10 ++++ .../examples/runbooks/create-runbook.mdx | 10 ++++ .../create-scheduled-runbook-trigger.mdx | 10 ++++ .../examples/runbooks/index.md | 10 ++++ .../examples/runbooks/publish-runbook.mdx | 10 ++++ .../run-runbook-with-prompted-variables.mdx | 10 ++++ .../examples/runbooks/run-runbook.mdx | 10 ++++ .../spaces/add-a-space-with-environments.mdx | 10 ++++ .../examples/spaces/delete-a-space.mdx | 10 ++++ .../octopus-rest-api/examples/spaces/index.md | 10 ++++ .../step-templates/export-step-templates.mdx | 10 ++++ .../examples/step-templates/index.md | 10 ++++ .../examples/tagsets/create-tagset.mdx | 10 ++++ .../examples/tagsets/index.md | 10 ++++ .../octopus-rest-api/examples/tasks/index.md | 10 ++++ .../examples/tasks/reprioritize-tasks.mdx | 10 ++++ .../examples/tasks/run-healthcheck.mdx | 10 ++++ .../tenants/bulk-add-projects-to-tenants.md | 10 ++++ .../examples/tenants/create-tenant.mdx | 10 ++++ .../examples/tenants/deactivate-tenant.mdx | 10 ++++ .../examples/tenants/index.md | 10 ++++ .../tenants/update-tenant-variable.mdx | 10 ++++ .../users-and-teams/add-azure-ad-to-users.mdx | 10 ++++ .../users-and-teams/add-domain-teams.mdx | 10 ++++ .../add-environment-to-team.mdx | 10 ++++ .../users-and-teams/change-users-domain.mdx | 10 ++++ .../users-and-teams/create-api-key.mdx | 10 ++++ .../users-and-teams/find-teams-with-role.mdx | 10 ++++ .../examples/users-and-teams/index.md | 10 ++++ .../list-users-with-editing-roles.mdx | 10 ++++ .../users-and-teams/list-users-with-role.mdx | 10 ++++ .../examples/users-and-teams/list-users.mdx | 10 ++++ .../remove-project-from-team.mdx | 10 ++++ .../swap-ad-domain-group-with-ldap-group.mdx | 10 ++++ .../swap-users-ad-domain-to-ldap.mdx | 10 ++++ .../octopus-rest-api/examples/users/index.md | 10 ++++ .../examples/users/list-users-with-role.md | 10 ++++ .../variables/add-library-set-to-project.mdx | 10 ++++ .../variables/add-update-project-variable.mdx | 10 ++++ .../variables/clear-sensitive-variables.mdx | 10 ++++ .../find-projects-using-library-set.mdx | 10 ++++ .../variables/find-variable-usage.mdx | 10 ++++ .../variables/find-variable-value-usage.mdx | 10 ++++ .../variables/find-variable-vaule-usage.md | 10 ++++ .../find-variableset-variables-usage.mdx | 10 ++++ .../examples/variables/index.md | 10 ++++ .../update-variable-set-variable-value.mdx | 10 ++++ .../docs/projects/export-import/index.mdx | 4 +- src/pages/docs/tenants/tag-sets.md | 2 +- .../docs/tenants/tenant-creation/index.mdx | 2 +- ...from-windows-to-linux-container.include.md | 4 +- .../scripts/sync-packages-scripts.include.md | 2 +- 179 files changed, 1594 insertions(+), 114 deletions(-) create mode 100644 src/pages/docs/octopus-rest-api/examples/accounts/create-aws-account.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/accounts/create-azure-service-principal.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/accounts/create-gcp-account.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/accounts/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md create mode 100644 src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md create mode 100644 src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md create mode 100644 src/pages/docs/octopus-rest-api/examples/artifacts/create-and-upload-artifacts.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/artifacts/download-deployment-artifacts.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/artifacts/download-runbook-artifacts.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/artifacts/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/bulk-operations/bulk-add-projects-to-tenants.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/bulk-operations/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md create mode 100644 src/pages/docs/octopus-rest-api/examples/certificates/create-certificate.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/certificates/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/certificates/replace-certificate.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md create mode 100644 src/pages/docs/octopus-rest-api/examples/channels/create-channel.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/channels/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md create mode 100644 src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md create mode 100644 src/pages/docs/octopus-rest-api/examples/create-certificate.md create mode 100644 src/pages/docs/octopus-rest-api/examples/create-project.md create mode 100644 src/pages/docs/octopus-rest-api/examples/create-runbook.md create mode 100644 src/pages/docs/octopus-rest-api/examples/create-script-step.md create mode 100644 src/pages/docs/octopus-rest-api/examples/delete-a-space.md create mode 100644 src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md create mode 100644 src/pages/docs/octopus-rest-api/examples/delete-project-releases.md create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-process/add-environment-to-step.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-process/create-script-step.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-package.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-role.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-process/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/add-azure-web-app.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/add-target-role.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/add-tenant-to-target.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/change-target-machinepolicy.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/check-for-tentacle-upgrades.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-name.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-role.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/enable-disable-machine.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/find-target-usage.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/find-unused-targets.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/register-listening-tentacle.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/register-polling-tentacle.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/register-ssh-target.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployment-targets/upgrade-machines.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployments/cancel-queued-deployments.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployments/create-and-deploy-a-release.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployments/deploy-release-with-prompted-variables.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployments/deploy-release.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/deployments/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/deployments/list-deployments-to-environment.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/environments/add-environments.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/environments/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/events/find-events-by-date.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/events/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/change-feed.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/create-feed.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/delete-feed.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/download-package-from-builtin-feed.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/push-package-to-builtin-feed.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/retrieve-feeds.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/feeds/synchronize-packages.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md create mode 100644 src/pages/docs/octopus-rest-api/examples/lifecycles/create-lifecycle.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/lifecycles/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/list-users-with-role.md create mode 100644 src/pages/docs/octopus-rest-api/examples/project-groups/create-projectgroup.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/project-groups/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/coordinating-multiple-projects.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/create-project.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/delete-project.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/delete-projects-with-empty-processes.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/disable-project-triggers.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/enable-disable-project.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/export-projects.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/find-unused-projects.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/import-projects.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/projects/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/publish-runbook.md create mode 100644 src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md create mode 100644 src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md create mode 100644 src/pages/docs/octopus-rest-api/examples/releases/create-release-with-specific-version.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/releases/delete-project-releases.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/releases/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/releases/promote-release-not-in-destination.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/releases/update-release-variable-snapshot.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/replace-certificate.md create mode 100644 src/pages/docs/octopus-rest-api/examples/reports/deployments-per-target-role-report.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/reports/environment-permissions-report.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/reports/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/reports/project-permissions-report.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/reports/project-release-deployment-targets-report.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/run-runbook.md create mode 100644 src/pages/docs/octopus-rest-api/examples/runbooks/add-script-step-to-runbook.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/runbooks/create-and-publish-runbook.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/runbooks/create-runbook.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/runbooks/create-scheduled-runbook-trigger.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/runbooks/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/runbooks/publish-runbook.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook-with-prompted-variables.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/spaces/delete-a-space.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/spaces/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/step-templates/export-step-templates.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/step-templates/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/tagsets/create-tagset.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/tagsets/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/tasks/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/tasks/reprioritize-tasks.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/tasks/run-healthcheck.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md create mode 100644 src/pages/docs/octopus-rest-api/examples/tenants/create-tenant.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/tenants/deactivate-tenant.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/tenants/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/tenants/update-tenant-variable.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/add-azure-ad-to-users.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/add-domain-teams.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/add-environment-to-team.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/change-users-domain.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/create-api-key.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/find-teams-with-role.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-editing-roles.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/remove-project-from-team.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/users/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/add-library-set-to-project.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/add-update-project-variable.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/clear-sensitive-variables.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/find-projects-using-library-set.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/find-variable-usage.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/find-variable-value-usage.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/find-variableset-variables-usage.mdx create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/index.md create mode 100644 src/pages/docs/octopus-rest-api/examples/variables/update-variable-set-variable-value.mdx diff --git a/src/pages/docs/administration/high-availability/how-high-availability-works.md b/src/pages/docs/administration/high-availability/how-high-availability-works.md index 5f894152d2..73448ab4bc 100644 --- a/src/pages/docs/administration/high-availability/how-high-availability-works.md +++ b/src/pages/docs/administration/high-availability/how-high-availability-works.md @@ -81,7 +81,7 @@ For planned outages, the recommendation is to enable drain mode. That will tell Once the outage is finished, repeat the same steps, but select **Disable Drain Node** instead. -Not all outages can be planned. The underlying hypervisor hosting VM the node is running on could crash. A data center could go offline. When that happens you can use this [API Script](/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown) to re-run those canceled deployments and runbook runs. +Not all outages can be planned. The underlying hypervisor hosting VM the node is running on could crash. A data center could go offline. When that happens you can use this [API Script](/docs/api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown) to re-run those canceled deployments and runbook runs. ### Number of nodes diff --git a/src/pages/docs/api/examples/accounts/index.md b/src/pages/docs/api/examples/accounts/index.md index ffd6cdd65d..9cea2a7b8e 100644 --- a/src/pages/docs/api/examples/accounts/index.md +++ b/src/pages/docs/api/examples/accounts/index.md @@ -21,6 +21,6 @@ Out-of-the-box, Octopus provides different types of accounts to help manage your You can use the REST API to create and manage accounts in Octopus. Typical tasks can include: -- [Create an AWS account](/docs/octopus-rest-api/examples/accounts/create-aws-account) -- [Create an Azure service principal](/docs/octopus-rest-api/examples/accounts/create-azure-service-principal) -- [Create a Google Cloud account](/docs/octopus-rest-api/examples/accounts/create-gcp-account) +- [Create an AWS account](/docs/api/examples/accounts/create-aws-account) +- [Create an Azure service principal](/docs/api/examples/accounts/create-azure-service-principal) +- [Create a Google Cloud account](/docs/api/examples/accounts/create-gcp-account) diff --git a/src/pages/docs/api/examples/artifacts/index.md b/src/pages/docs/api/examples/artifacts/index.md index aa68c57b6d..f64c32d52e 100644 --- a/src/pages/docs/api/examples/artifacts/index.md +++ b/src/pages/docs/api/examples/artifacts/index.md @@ -10,6 +10,6 @@ hideInThisSectionHeader: true You can use the REST API to create and download [artifacts](/docs/projects/deployment-process/artifacts) in Octopus. Typical tasks can include: -- [Upload Artifact to Existing Deployment](/docs/octopus-rest-api/examples/artifacts/create-and-upload-artifacts) -- [Download Deployment Artifact](/docs/octopus-rest-api/examples/artifacts/download-deployment-artifacts) -- [Download Runbook Artifact](/docs/octopus-rest-api/examples/artifacts/download-runbook-artifacts) +- [Upload Artifact to Existing Deployment](/docs/api/examples/artifacts/create-and-upload-artifacts) +- [Download Deployment Artifact](/docs/api/examples/artifacts/download-deployment-artifacts) +- [Download Runbook Artifact](/docs/api/examples/artifacts/download-runbook-artifacts) diff --git a/src/pages/docs/api/examples/bulk-operations/index.md b/src/pages/docs/api/examples/bulk-operations/index.md index 8f5046509d..7823aa8262 100644 --- a/src/pages/docs/api/examples/bulk-operations/index.md +++ b/src/pages/docs/api/examples/bulk-operations/index.md @@ -18,5 +18,5 @@ All the scripts in this section will include: Provided sample bulk operations are: -- [Bulk add a project to a list of tenants](/docs/octopus-rest-api/examples/bulk-operations/bulk-add-projects-to-tenants) -- [Rerun all canceled deployments and runbook runs after node shutdown](/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown) +- [Bulk add a project to a list of tenants](/docs/api/examples/bulk-operations/bulk-add-projects-to-tenants) +- [Rerun all canceled deployments and runbook runs after node shutdown](/docs/api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown) diff --git a/src/pages/docs/api/examples/certificates/index.md b/src/pages/docs/api/examples/certificates/index.md index 99d12bcda3..ee77021630 100644 --- a/src/pages/docs/api/examples/certificates/index.md +++ b/src/pages/docs/api/examples/certificates/index.md @@ -10,5 +10,5 @@ hideInThisSectionHeader: true You can use the REST API to create and manage your [certificates](/docs/deployments/certificates) in Octopus. Typical tasks can include: -- [Create a certificate](/docs/octopus-rest-api/examples/certificates/create-certificate) -- [Replace existing certificate](/docs/octopus-rest-api/examples/certificates/replace-certificate) +- [Create a certificate](/docs/api/examples/certificates/create-certificate) +- [Replace existing certificate](/docs/api/examples/certificates/replace-certificate) diff --git a/src/pages/docs/api/examples/channels/index.md b/src/pages/docs/api/examples/channels/index.md index 4dd7c5dbd8..15a1298053 100644 --- a/src/pages/docs/api/examples/channels/index.md +++ b/src/pages/docs/api/examples/channels/index.md @@ -10,4 +10,4 @@ hideInThisSectionHeader: true You can use the REST API to create and manage your [channels](/docs/releases/channels) in Octopus. Typical tasks can include: -- [Create a channel](/docs/octopus-rest-api/examples/channels/create-channel) +- [Create a channel](/docs/api/examples/channels/create-channel) diff --git a/src/pages/docs/api/examples/events/index.md b/src/pages/docs/api/examples/events/index.md index 0eb816cc87..e5b5708669 100644 --- a/src/pages/docs/api/examples/events/index.md +++ b/src/pages/docs/api/examples/events/index.md @@ -10,4 +10,4 @@ hideInThisSectionHeader: true You can use the REST API to review events on Octopus Deploy. Typical tasks might include: -- [Find events by date](/docs/octopus-rest-api/examples/events/find-events-by-date) +- [Find events by date](/docs/api/examples/events/find-events-by-date) diff --git a/src/pages/docs/api/examples/feeds/index.md b/src/pages/docs/api/examples/feeds/index.md index eda3c772a1..4726492242 100644 --- a/src/pages/docs/api/examples/feeds/index.md +++ b/src/pages/docs/api/examples/feeds/index.md @@ -10,10 +10,10 @@ hideInThisSectionHeader: true You can use the REST API to create and manage your [package repositories](/docs/packaging-applications/package-repositories) in Octopus. Typical tasks might include: -- [Change feed](/docs/octopus-rest-api/examples/feeds/change-feed) -- [Create a feed](/docs/octopus-rest-api/examples/feeds/create-feed) -- [Delete a feed](/docs/octopus-rest-api/examples/feeds/delete-feed) -- [Download package from built-in feed](/docs/octopus-rest-api/examples/feeds/download-package-from-builtin-feed) -- [Push package to built-in feed](/docs/octopus-rest-api/examples/feeds/push-package-to-builtin-feed) -- [Retrieve all feeds](/docs/octopus-rest-api/examples/feeds/retrieve-feeds) -- [Synchronize packages](/docs/octopus-rest-api/examples/feeds/synchronize-packages) +- [Change feed](/docs/api/examples/feeds/change-feed) +- [Create a feed](/docs/api/examples/feeds/create-feed) +- [Delete a feed](/docs/api/examples/feeds/delete-feed) +- [Download package from built-in feed](/docs/api/examples/feeds/download-package-from-builtin-feed) +- [Push package to built-in feed](/docs/api/examples/feeds/push-package-to-builtin-feed) +- [Retrieve all feeds](/docs/api/examples/feeds/retrieve-feeds) +- [Synchronize packages](/docs/api/examples/feeds/synchronize-packages) diff --git a/src/pages/docs/api/examples/index.md b/src/pages/docs/api/examples/index.md index e40845e137..05c88fa8f2 100644 --- a/src/pages/docs/api/examples/index.md +++ b/src/pages/docs/api/examples/index.md @@ -57,36 +57,36 @@ The TypeScript examples are written using the [TypeScript API Client for Octopus Sometimes you want to perform an action on a resource in Octopus multiple times. For example, connecting a tenant to all of your projects. Having to run a script that performs an operation once, repeatedly, can become tedious. -To help with this, we've included examples of [bulk operations](/docs/octopus-rest-api/examples/bulk-operations) using the Octopus REST API. +To help with this, we've included examples of [bulk operations](/docs/api/examples/bulk-operations) using the Octopus REST API. ## Explore examples Explore the REST API examples further in this section: -- [Accounts](/docs/octopus-rest-api/examples/accounts) -- [Artifacts](/docs/octopus-rest-api/examples/artifacts) -- [Certificates](/docs/octopus-rest-api/examples/certificates) -- [Channels](/docs/octopus-rest-api/examples/channels) -- [Deployment process](/docs/octopus-rest-api/examples/deployment-process) -- [Deployment targets](/docs/octopus-rest-api/examples/deployment-targets) -- [Deployments](/docs/octopus-rest-api/examples/deployments) -- [Environments](/docs/octopus-rest-api/examples/environments) -- [Events](/docs/octopus-rest-api/examples/events) -- [Feeds](/docs/octopus-rest-api/examples/feeds) -- [Lifecycles](/docs/octopus-rest-api/examples/lifecycles) -- [Project Groups](/docs/octopus-rest-api/examples/project-groups) -- [Projects](/docs/octopus-rest-api/examples/projects) -- [Releases](/docs/octopus-rest-api/examples/releases) -- [Reports](/docs/octopus-rest-api/examples/reports) -- [Runbooks](/docs/octopus-rest-api/examples/runbooks) -- [Spaces](/docs/octopus-rest-api/examples/spaces) -- [Step Templates](/docs/octopus-rest-api/examples/step-templates) -- [Tag sets](/docs/octopus-rest-api/examples/tagsets) -- [Tasks](/docs/octopus-rest-api/examples/tasks) -- [Tenants](/docs/octopus-rest-api/examples/tenants) -- [Users and Teams](/docs/octopus-rest-api/examples/users-and-teams) -- [Variables](/docs/octopus-rest-api/examples/variables) -- [Bulk Operations](/docs/octopus-rest-api/examples/bulk-operations) +- [Accounts](/docs/api/examples/accounts) +- [Artifacts](/docs/api/examples/artifacts) +- [Certificates](/docs/api/examples/certificates) +- [Channels](/docs/api/examples/channels) +- [Deployment process](/docs/api/examples/deployment-process) +- [Deployment targets](/docs/api/examples/deployment-targets) +- [Deployments](/docs/api/examples/deployments) +- [Environments](/docs/api/examples/environments) +- [Events](/docs/api/examples/events) +- [Feeds](/docs/api/examples/feeds) +- [Lifecycles](/docs/api/examples/lifecycles) +- [Project Groups](/docs/api/examples/project-groups) +- [Projects](/docs/api/examples/projects) +- [Releases](/docs/api/examples/releases) +- [Reports](/docs/api/examples/reports) +- [Runbooks](/docs/api/examples/runbooks) +- [Spaces](/docs/api/examples/spaces) +- [Step Templates](/docs/api/examples/step-templates) +- [Tag sets](/docs/api/examples/tagsets) +- [Tasks](/docs/api/examples/tasks) +- [Tenants](/docs/api/examples/tenants) +- [Users and Teams](/docs/api/examples/users-and-teams) +- [Variables](/docs/api/examples/variables) +- [Bulk Operations](/docs/api/examples/bulk-operations) ## Get help from the community diff --git a/src/pages/docs/api/examples/lifecycles/index.md b/src/pages/docs/api/examples/lifecycles/index.md index a1cad14696..c953a465bf 100644 --- a/src/pages/docs/api/examples/lifecycles/index.md +++ b/src/pages/docs/api/examples/lifecycles/index.md @@ -10,4 +10,4 @@ hideInThisSectionHeader: true You can use the REST API to create and manage your [lifecycles](/docs/releases/lifecycles) in Octopus. Typical tasks can include: -- [Create a lifecycle](/docs/octopus-rest-api/examples/lifecycles/create-lifecycle) +- [Create a lifecycle](/docs/api/examples/lifecycles/create-lifecycle) diff --git a/src/pages/docs/api/examples/project-groups/index.md b/src/pages/docs/api/examples/project-groups/index.md index bade42c72b..a4060d3732 100644 --- a/src/pages/docs/api/examples/project-groups/index.md +++ b/src/pages/docs/api/examples/project-groups/index.md @@ -10,4 +10,4 @@ hideInThisSectionHeader: true You can use the REST API to create and manage [project groups](/docs/projects/#project-group) in Octopus. Typical tasks can include: -- [Create a project group](/docs/octopus-rest-api/examples/project-groups/create-projectgroup) +- [Create a project group](/docs/api/examples/project-groups/create-projectgroup) diff --git a/src/pages/docs/api/examples/projects/index.md b/src/pages/docs/api/examples/projects/index.md index f04faafde9..99c615ec66 100644 --- a/src/pages/docs/api/examples/projects/index.md +++ b/src/pages/docs/api/examples/projects/index.md @@ -10,12 +10,12 @@ hideInThisSectionHeader: true You can use the REST API to create and manage your Octopus [projects](/docs/projects). Typical tasks can include: -- [Coordinating multiple projects](/docs/octopus-rest-api/examples/projects/coordinating-multiple-projects) -- [Create a project](/docs/octopus-rest-api/examples/projects/create-project) -- [Delete a project](/docs/octopus-rest-api/examples/projects/delete-project) -- [Delete projects with no process](/docs/octopus-rest-api/examples/projects/delete-projects-with-empty-processes) -- [Disable project triggers](/docs/octopus-rest-api/examples/projects/disable-project-triggers) -- [Enable/disable project](/docs/octopus-rest-api/examples/projects/enable-disable-project) -- [Export projects](/docs/octopus-rest-api/examples/projects/export-projects) -- [Find unused projects](/docs/octopus-rest-api/examples/projects/find-unused-projects) -- [Import projects](/docs/octopus-rest-api/examples/projects/import-projects) +- [Coordinating multiple projects](/docs/api/examples/projects/coordinating-multiple-projects) +- [Create a project](/docs/api/examples/projects/create-project) +- [Delete a project](/docs/api/examples/projects/delete-project) +- [Delete projects with no process](/docs/api/examples/projects/delete-projects-with-empty-processes) +- [Disable project triggers](/docs/api/examples/projects/disable-project-triggers) +- [Enable/disable project](/docs/api/examples/projects/enable-disable-project) +- [Export projects](/docs/api/examples/projects/export-projects) +- [Find unused projects](/docs/api/examples/projects/find-unused-projects) +- [Import projects](/docs/api/examples/projects/import-projects) diff --git a/src/pages/docs/api/examples/releases/index.md b/src/pages/docs/api/examples/releases/index.md index 78b903c5db..4ff7f9fc28 100644 --- a/src/pages/docs/api/examples/releases/index.md +++ b/src/pages/docs/api/examples/releases/index.md @@ -9,7 +9,7 @@ hideInThisSectionHeader: true --- You can use the REST API to create and manage your Octopus [releases](/docs/releases). Typical tasks can include: -- [Create a release with specific version](/docs/octopus-rest-api/examples/releases/create-release-with-specific-version) -- [Delete project releases](/docs/octopus-rest-api/examples/releases/delete-project-releases) -- [Promote a release not in the destination](/docs/octopus-rest-api/examples/releases/promote-release-not-in-destination) -- [Update release variable snapshot](/docs/octopus-rest-api/examples/releases/update-release-variable-snapshot) +- [Create a release with specific version](/docs/api/examples/releases/create-release-with-specific-version) +- [Delete project releases](/docs/api/examples/releases/delete-project-releases) +- [Promote a release not in the destination](/docs/api/examples/releases/promote-release-not-in-destination) +- [Update release variable snapshot](/docs/api/examples/releases/update-release-variable-snapshot) diff --git a/src/pages/docs/api/examples/runbooks/index.md b/src/pages/docs/api/examples/runbooks/index.md index 2985415453..fd230c673c 100644 --- a/src/pages/docs/api/examples/runbooks/index.md +++ b/src/pages/docs/api/examples/runbooks/index.md @@ -9,10 +9,10 @@ hideInThisSectionHeader: true --- You can use the REST API to create and manage your Octopus [runbooks](/docs/runbooks). Typical tasks can include: -- [Add a script step to runbook](/docs/octopus-rest-api/examples/runbooks/add-script-step-to-runbook) -- [Create and publish a new runbook snapshot](/docs/octopus-rest-api/examples/runbooks/create-and-publish-runbook) -- [Create a runbook](/docs/octopus-rest-api/examples/runbooks/create-runbook) -- [Create a new scheduled runbook trigger](/docs/octopus-rest-api/examples/runbooks/create-scheduled-runbook-trigger) -- [Publish a runbook snapshot](/docs/octopus-rest-api/examples/runbooks/publish-runbook) -- [Run a runbook with prompted variables](/docs/octopus-rest-api/examples/runbooks/run-runbook-with-prompted-variables) -- [Run a published runbook](/docs/octopus-rest-api/examples/runbooks/run-runbook) +- [Add a script step to runbook](/docs/api/examples/runbooks/add-script-step-to-runbook) +- [Create and publish a new runbook snapshot](/docs/api/examples/runbooks/create-and-publish-runbook) +- [Create a runbook](/docs/api/examples/runbooks/create-runbook) +- [Create a new scheduled runbook trigger](/docs/api/examples/runbooks/create-scheduled-runbook-trigger) +- [Publish a runbook snapshot](/docs/api/examples/runbooks/publish-runbook) +- [Run a runbook with prompted variables](/docs/api/examples/runbooks/run-runbook-with-prompted-variables) +- [Run a published runbook](/docs/api/examples/runbooks/run-runbook) diff --git a/src/pages/docs/api/examples/runbooks/publish-runbook.mdx b/src/pages/docs/api/examples/runbooks/publish-runbook.mdx index 2eccdd6c2a..723b76067a 100644 --- a/src/pages/docs/api/examples/runbooks/publish-runbook.mdx +++ b/src/pages/docs/api/examples/runbooks/publish-runbook.mdx @@ -7,7 +7,7 @@ description: An example script to publish an existing runbook snapshot --- import PublishRunbookScripts from 'src/shared-content/scripts/publish-runbook-scripts.include.md'; -This script demonstrates how to programmatically publish an *existing* runbook snapshot. To learn how to create a new snapshot and publish it see [this example](/docs/octopus-rest-api/examples/runbooks/create-and-publish-runbook). +This script demonstrates how to programmatically publish an *existing* runbook snapshot. To learn how to create a new snapshot and publish it see [this example](/docs/api/examples/runbooks/create-and-publish-runbook). ## Usage diff --git a/src/pages/docs/api/examples/spaces/index.md b/src/pages/docs/api/examples/spaces/index.md index bfb11579f9..8689d7f2f1 100644 --- a/src/pages/docs/api/examples/spaces/index.md +++ b/src/pages/docs/api/examples/spaces/index.md @@ -9,5 +9,5 @@ hideInThisSectionHeader: true --- You can use the REST API to create and manage your Octopus [Spaces](/docs/administration/spaces). Typical tasks can include: -- [Add a Space with environments](/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments) -- [Delete a Space](/docs/octopus-rest-api/examples/spaces/delete-a-space) +- [Add a Space with environments](/docs/api/examples/spaces/add-a-space-with-environments) +- [Delete a Space](/docs/api/examples/spaces/delete-a-space) diff --git a/src/pages/docs/api/examples/step-templates/index.md b/src/pages/docs/api/examples/step-templates/index.md index 2620e3a5a3..2e659dfaf2 100644 --- a/src/pages/docs/api/examples/step-templates/index.md +++ b/src/pages/docs/api/examples/step-templates/index.md @@ -9,4 +9,4 @@ hideInThisSectionHeader: true --- You can use the REST API to create and manage your Octopus [step templates](/docs/projects/custom-step-templates). Typical tasks can include: -- [Export step templates](/docs/octopus-rest-api/examples/step-templates/export-step-templates) +- [Export step templates](/docs/api/examples/step-templates/export-step-templates) diff --git a/src/pages/docs/api/examples/tasks/index.md b/src/pages/docs/api/examples/tasks/index.md index 23404c9942..6c447c6737 100644 --- a/src/pages/docs/api/examples/tasks/index.md +++ b/src/pages/docs/api/examples/tasks/index.md @@ -10,5 +10,5 @@ hideInThisSectionHeader: true --- You can use the REST API to create and manage Server tasks in Octopus. Typical tasks might include: -- [Reprioritize Tasks](/docs/octopus-rest-api/examples/tasks/reprioritize-tasks) -- [Run a health check](/docs/octopus-rest-api/examples/tasks/run-healthcheck) +- [Reprioritize Tasks](/docs/api/examples/tasks/reprioritize-tasks) +- [Run a health check](/docs/api/examples/tasks/run-healthcheck) diff --git a/src/pages/docs/api/examples/tenants/index.md b/src/pages/docs/api/examples/tenants/index.md index 3bcdecff0d..b07621a3b7 100644 --- a/src/pages/docs/api/examples/tenants/index.md +++ b/src/pages/docs/api/examples/tenants/index.md @@ -9,6 +9,6 @@ hideInThisSectionHeader: true --- You can use the REST API to create and manage Server tasks in Octopus. Typical tasks might include: -- [Create a tenant](/docs/octopus-rest-api/examples/tenants/create-tenant) -- [Update tenant variables](/docs/octopus-rest-api/examples/tenants/update-tenant-variable) -- [Deactivate tenants](/docs/octopus-rest-api/examples/tenants/deactivate-tenant) +- [Create a tenant](/docs/api/examples/tenants/create-tenant) +- [Update tenant variables](/docs/api/examples/tenants/update-tenant-variable) +- [Deactivate tenants](/docs/api/examples/tenants/deactivate-tenant) diff --git a/src/pages/docs/api/examples/users-and-teams/index.md b/src/pages/docs/api/examples/users-and-teams/index.md index 3563cf02ca..300e712aaf 100644 --- a/src/pages/docs/api/examples/users-and-teams/index.md +++ b/src/pages/docs/api/examples/users-and-teams/index.md @@ -9,15 +9,15 @@ hideInThisSectionHeader: true --- You can use the REST API to create and manage your Octopus [Users and Teams](/docs/security/users-and-teams). Typical tasks can include: -- [Add Azure Active Directory login to users](/docs/octopus-rest-api/examples/users-and-teams/add-azure-ad-to-users) -- [Add domain teams](/docs/octopus-rest-api/examples/users-and-teams/add-domain-teams) -- [Add an environment to a team](/docs/octopus-rest-api/examples/users-and-teams/add-environment-to-team) -- [Change users domain](/docs/octopus-rest-api/examples/users-and-teams/change-users-domain) -- [Create an API Key](/docs/octopus-rest-api/examples/users-and-teams/create-api-key) -- [Find teams with role](/docs/octopus-rest-api/examples/users-and-teams/find-teams-with-role) -- [List users with editing roles](/docs/octopus-rest-api/examples/users-and-teams/list-users-with-editing-roles) -- [List users with role](/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role) -- [List users](/docs/octopus-rest-api/examples/users-and-teams/list-users) -- [Remove a project from team](/docs/octopus-rest-api/examples/users-and-teams/remove-project-from-team) -- [Swap AD group with LDAP group](/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group) -- [Change users AD domain to LDAP](/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap) +- [Add Azure Active Directory login to users](/docs/api/examples/users-and-teams/add-azure-ad-to-users) +- [Add domain teams](/docs/api/examples/users-and-teams/add-domain-teams) +- [Add an environment to a team](/docs/api/examples/users-and-teams/add-environment-to-team) +- [Change users domain](/docs/api/examples/users-and-teams/change-users-domain) +- [Create an API Key](/docs/api/examples/users-and-teams/create-api-key) +- [Find teams with role](/docs/api/examples/users-and-teams/find-teams-with-role) +- [List users with editing roles](/docs/api/examples/users-and-teams/list-users-with-editing-roles) +- [List users with role](/docs/api/examples/users-and-teams/list-users-with-role) +- [List users](/docs/api/examples/users-and-teams/list-users) +- [Remove a project from team](/docs/api/examples/users-and-teams/remove-project-from-team) +- [Swap AD group with LDAP group](/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group) +- [Change users AD domain to LDAP](/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap) diff --git a/src/pages/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx b/src/pages/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx index 1e162f8644..dbade507b9 100644 --- a/src/pages/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx +++ b/src/pages/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx @@ -9,7 +9,7 @@ import SwitchADDomainGroupToLdapGroupScripts from 'src/shared-content/scripts/sw This script demonstrates how to programmatically swap any Active Directory external group for a matching LDAP external group in each Octopus team. This can be useful when you are migrating from the Active Directory authentication provider to the LDAP provider. -We also have a script that will [swap Active Directory login records with matching LDAP ones](/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap) for Octopus users. +We also have a script that will [swap Active Directory login records with matching LDAP ones](/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap) for Octopus users. :::div{.hint} **Note:** diff --git a/src/pages/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx b/src/pages/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx index e00e776902..dcfb6f1768 100644 --- a/src/pages/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx +++ b/src/pages/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx @@ -9,7 +9,7 @@ import SwitchUsersADDomainToLdapScripts from 'src/shared-content/scripts/switch- This script demonstrates how to programmatically swap an Octopus user's Active Directory login record for a matching LDAP one. This can be useful when you are migrating from the Active Directory authentication provider to the LDAP provider. -We also have a script that will [swap Active Directory groups with matching LDAP groups](/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group) for Octopus teams. +We also have a script that will [swap Active Directory groups with matching LDAP groups](/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group) for Octopus teams. :::div{.hint} **Note:** diff --git a/src/pages/docs/api/examples/variables/index.md b/src/pages/docs/api/examples/variables/index.md index 629afb48f1..9844be37a0 100644 --- a/src/pages/docs/api/examples/variables/index.md +++ b/src/pages/docs/api/examples/variables/index.md @@ -9,11 +9,11 @@ hideInThisSectionHeader: true --- You can use the REST API to create and manage your Octopus [variables](/docs/projects/variables). Typical tasks can include: -- [Add variable set to a project](/docs/octopus-rest-api/examples/variables/add-library-set-to-project) -- [Add or update project variable](/docs/octopus-rest-api/examples/variables/add-update-project-variable) -- [Clear sensitive variables](/docs/octopus-rest-api/examples/variables/clear-sensitive-variables) -- [Find projects using variable set](/docs/octopus-rest-api/examples/variables/find-projects-using-library-set) -- [Find variable usage](/docs/octopus-rest-api/examples/variables/find-variable-usage) -- [Find variable value usage](/docs/octopus-rest-api/examples/variables/find-variable-value-usage) -- [Find variable set variables usage](/docs/octopus-rest-api/examples/variables/find-variableset-variables-usage) -- [Update variable set variable value](/docs/octopus-rest-api/examples/variables/update-variable-set-variable-value) +- [Add variable set to a project](/docs/api/examples/variables/add-library-set-to-project) +- [Add or update project variable](/docs/api/examples/variables/add-update-project-variable) +- [Clear sensitive variables](/docs/api/examples/variables/clear-sensitive-variables) +- [Find projects using variable set](/docs/api/examples/variables/find-projects-using-library-set) +- [Find variable usage](/docs/api/examples/variables/find-variable-usage) +- [Find variable value usage](/docs/api/examples/variables/find-variable-value-usage) +- [Find variable set variables usage](/docs/api/examples/variables/find-variableset-variables-usage) +- [Update variable set variable value](/docs/api/examples/variables/update-variable-set-variable-value) diff --git a/src/pages/docs/api/octopus.client/index.md b/src/pages/docs/api/octopus.client/index.md index a2899e7049..ff333a7ddd 100644 --- a/src/pages/docs/api/octopus.client/index.md +++ b/src/pages/docs/api/octopus.client/index.md @@ -19,4 +19,4 @@ Details for where to find the API and how to authenticate can be found in our [R ## Octopus.Client Examples -We have many examples showing how to use Octopus.Client in both our [API examples](/docs/octopus-rest-api/examples) and the [OctopusDeploy-API GitHub repository](https://github.com/OctopusDeploy/OctopusDeploy-Api/tree/master/Octopus.Client). +We have many examples showing how to use Octopus.Client in both our [API examples](/docs/api/examples) and the [OctopusDeploy-API GitHub repository](https://github.com/OctopusDeploy/OctopusDeploy-Api/tree/master/Octopus.Client). diff --git a/src/pages/docs/infrastructure/deployment-targets/dynamic-infrastructure/index.mdx b/src/pages/docs/infrastructure/deployment-targets/dynamic-infrastructure/index.mdx index 6b488e45b9..e460ecbdf4 100644 --- a/src/pages/docs/infrastructure/deployment-targets/dynamic-infrastructure/index.mdx +++ b/src/pages/docs/infrastructure/deployment-targets/dynamic-infrastructure/index.mdx @@ -29,13 +29,13 @@ Dynamic infrastructure can be enabled when a new environment is created, or it c Octopus comes with a REST API that can be used to register Octopus accounts and deployment targets dynamically: -- [Create an AWS Account](/docs/octopus-rest-api/examples/accounts/create-aws-account) -- [Create an Azure Service Principal Account](/docs/octopus-rest-api/examples/accounts/create-azure-service-principal) -- [Add an Azure Web App target](/docs/octopus-rest-api/examples/deployment-targets/add-azure-web-app) -- [Register a listening Tentacle](/docs/octopus-rest-api/examples/deployment-targets/register-listening-tentacle) -- [Register a Polling Tentacle](/docs/octopus-rest-api/examples/deployment-targets/register-polling-tentacle) +- [Create an AWS Account](/docs/api/examples/accounts/create-aws-account) +- [Create an Azure Service Principal Account](/docs/api/examples/accounts/create-azure-service-principal) +- [Add an Azure Web App target](/docs/api/examples/deployment-targets/add-azure-web-app) +- [Register a listening Tentacle](/docs/api/examples/deployment-targets/register-listening-tentacle) +- [Register a Polling Tentacle](/docs/api/examples/deployment-targets/register-polling-tentacle) -To learn more about the things you can do with the API, take a look at our [API examples](/docs/octopus-rest-api/examples) section. +To learn more about the things you can do with the API, take a look at our [API examples](/docs/api/examples) section. ## Using PowerShell functions diff --git a/src/pages/docs/infrastructure/deployment-targets/tentacle/windows/automating-tentacle-installation.mdx b/src/pages/docs/infrastructure/deployment-targets/tentacle/windows/automating-tentacle-installation.mdx index 07779b3cb2..24bfe10a1e 100644 --- a/src/pages/docs/infrastructure/deployment-targets/tentacle/windows/automating-tentacle-installation.mdx +++ b/src/pages/docs/infrastructure/deployment-targets/tentacle/windows/automating-tentacle-installation.mdx @@ -105,7 +105,7 @@ $repository.machines.create($tentacle) ``` :::div{.hint} -Want to register your Tentacles another way? Take a look at our [examples](/docs/octopus-rest-api/examples/deployment-targets/) for ways to register Tentacles using the [Octopus REST API](/docs/octopus-rest-api). +Want to register your Tentacles another way? Take a look at our [examples](/docs/api/examples/deployment-targets/) for ways to register Tentacles using the [Octopus REST API](/docs/octopus-rest-api). ::: ## Example: Polling Tentacle \{#AutomatingTentacleinstallation-Example-PollingTentacle} @@ -129,7 +129,7 @@ Tentacle.exe service --instance "Tentacle" --install --start --console **Tips:** - If you are running this from a PowerShell remote session, make sure to add `--console` at the end of each command to force Tentacle.exe not to run as a service. -- Want to register your Tentacles another way? Take a look at our [examples](/docs/octopus-rest-api/examples/deployment-targets/) for ways to register Tentacles using the [Octopus REST API](/docs/octopus-rest-api). +- Want to register your Tentacles another way? Take a look at our [examples](/docs/api/examples/deployment-targets/) for ways to register Tentacles using the [Octopus REST API](/docs/octopus-rest-api). ::: diff --git a/src/pages/docs/octopus-rest-api/examples/accounts/create-aws-account.mdx b/src/pages/docs/octopus-rest-api/examples/accounts/create-aws-account.mdx new file mode 100644 index 0000000000..3c79aa7d1e --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/accounts/create-aws-account.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/accounts/create-aws-account +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/accounts/create-azure-service-principal.mdx b/src/pages/docs/octopus-rest-api/examples/accounts/create-azure-service-principal.mdx new file mode 100644 index 0000000000..0e1b4c1d15 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/accounts/create-azure-service-principal.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/accounts/create-azure-service-principal +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/accounts/create-gcp-account.mdx b/src/pages/docs/octopus-rest-api/examples/accounts/create-gcp-account.mdx new file mode 100644 index 0000000000..b1aadaa1e1 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/accounts/create-gcp-account.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/accounts/create-gcp-account +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/accounts/index.md b/src/pages/docs/octopus-rest-api/examples/accounts/index.md new file mode 100644 index 0000000000..d1cdda67f3 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/accounts/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/accounts +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md b/src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md new file mode 100644 index 0000000000..5e3580f81a --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/add-a-space-with-environments +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md b/src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md new file mode 100644 index 0000000000..ad5e20d22c --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/add-azure-web-app +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md b/src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md new file mode 100644 index 0000000000..ea7ad135bc --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/add-environment-to-step +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/artifacts/create-and-upload-artifacts.mdx b/src/pages/docs/octopus-rest-api/examples/artifacts/create-and-upload-artifacts.mdx new file mode 100644 index 0000000000..8b6168df34 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/artifacts/create-and-upload-artifacts.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/artifacts/create-and-upload-artifacts +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/artifacts/download-deployment-artifacts.mdx b/src/pages/docs/octopus-rest-api/examples/artifacts/download-deployment-artifacts.mdx new file mode 100644 index 0000000000..d7667784b3 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/artifacts/download-deployment-artifacts.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/artifacts/download-deployment-artifacts +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/artifacts/download-runbook-artifacts.mdx b/src/pages/docs/octopus-rest-api/examples/artifacts/download-runbook-artifacts.mdx new file mode 100644 index 0000000000..d6bcff059d --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/artifacts/download-runbook-artifacts.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/artifacts/download-runbook-artifacts +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/artifacts/index.md b/src/pages/docs/octopus-rest-api/examples/artifacts/index.md new file mode 100644 index 0000000000..8307d49e5b --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/artifacts/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/artifacts +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/bulk-operations/bulk-add-projects-to-tenants.mdx b/src/pages/docs/octopus-rest-api/examples/bulk-operations/bulk-add-projects-to-tenants.mdx new file mode 100644 index 0000000000..d7f4a9f213 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/bulk-operations/bulk-add-projects-to-tenants.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/bulk-operations/bulk-add-projects-to-tenants +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/bulk-operations/index.md b/src/pages/docs/octopus-rest-api/examples/bulk-operations/index.md new file mode 100644 index 0000000000..b468c3851b --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/bulk-operations/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/bulk-operations +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx b/src/pages/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx new file mode 100644 index 0000000000..0cbf7bebae --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md b/src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md new file mode 100644 index 0000000000..4d43eeed76 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/cancel-queued-deployments +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/certificates/create-certificate.mdx b/src/pages/docs/octopus-rest-api/examples/certificates/create-certificate.mdx new file mode 100644 index 0000000000..d8cd21fcac --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/certificates/create-certificate.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/certificates/create-certificate +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/certificates/index.md b/src/pages/docs/octopus-rest-api/examples/certificates/index.md new file mode 100644 index 0000000000..c3d2331991 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/certificates/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/certificates +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/certificates/replace-certificate.mdx b/src/pages/docs/octopus-rest-api/examples/certificates/replace-certificate.mdx new file mode 100644 index 0000000000..27f3aea62f --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/certificates/replace-certificate.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/certificates/replace-certificate +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md b/src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md new file mode 100644 index 0000000000..7526aa86a7 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/change-machine-machinepolicy +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/channels/create-channel.mdx b/src/pages/docs/octopus-rest-api/examples/channels/create-channel.mdx new file mode 100644 index 0000000000..4dae72de0e --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/channels/create-channel.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/channels/create-channel +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/channels/index.md b/src/pages/docs/octopus-rest-api/examples/channels/index.md new file mode 100644 index 0000000000..038a3d4843 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/channels/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/channels +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md b/src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md new file mode 100644 index 0000000000..598a349eee --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/create-and-deploy-a-release +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md b/src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md new file mode 100644 index 0000000000..87ffa98c12 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/create-azure-service-principal +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/create-certificate.md b/src/pages/docs/octopus-rest-api/examples/create-certificate.md new file mode 100644 index 0000000000..ca80760efc --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/create-certificate.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/create-certificate +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/create-project.md b/src/pages/docs/octopus-rest-api/examples/create-project.md new file mode 100644 index 0000000000..ae6cc7b148 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/create-project.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/create-project +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/create-runbook.md b/src/pages/docs/octopus-rest-api/examples/create-runbook.md new file mode 100644 index 0000000000..a586f472db --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/create-runbook.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/create-runbook +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/create-script-step.md b/src/pages/docs/octopus-rest-api/examples/create-script-step.md new file mode 100644 index 0000000000..a7f6b0ffcf --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/create-script-step.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/create-script-step +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/delete-a-space.md b/src/pages/docs/octopus-rest-api/examples/delete-a-space.md new file mode 100644 index 0000000000..ee96ca25b7 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/delete-a-space.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/delete-a-space +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md b/src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md new file mode 100644 index 0000000000..5328e3ac74 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/delete-machines-by-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/delete-project-releases.md b/src/pages/docs/octopus-rest-api/examples/delete-project-releases.md new file mode 100644 index 0000000000..e7ebf9ea39 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/delete-project-releases.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/delete-project-releases +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/add-environment-to-step.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-process/add-environment-to-step.mdx new file mode 100644 index 0000000000..ffb558514e --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-process/add-environment-to-step.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-process/add-environment-to-step +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/create-script-step.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-process/create-script-step.mdx new file mode 100644 index 0000000000..e2c5d3f112 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-process/create-script-step.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-process/create-script-step +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-package.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-package.mdx new file mode 100644 index 0000000000..719bae35d6 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-package.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-process/get-steps-using-package +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-role.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-role.mdx new file mode 100644 index 0000000000..b4e92245e2 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-process/get-steps-using-role.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-process/get-steps-using-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-process/index.md b/src/pages/docs/octopus-rest-api/examples/deployment-process/index.md new file mode 100644 index 0000000000..4aa17caaff --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-process/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-process +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-azure-web-app.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-azure-web-app.mdx new file mode 100644 index 0000000000..ce32457913 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-azure-web-app.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/add-azure-web-app +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-target-role.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-target-role.mdx new file mode 100644 index 0000000000..712599d315 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-target-role.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/add-target-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-tenant-to-target.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-tenant-to-target.mdx new file mode 100644 index 0000000000..3f7803d8e7 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/add-tenant-to-target.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/add-tenant-to-target +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/change-target-machinepolicy.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/change-target-machinepolicy.mdx new file mode 100644 index 0000000000..b418585c39 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/change-target-machinepolicy.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/change-target-machinepolicy +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/check-for-tentacle-upgrades.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/check-for-tentacle-upgrades.mdx new file mode 100644 index 0000000000..daf08d4f16 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/check-for-tentacle-upgrades.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/check-for-tentacle-upgrades +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-name.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-name.mdx new file mode 100644 index 0000000000..edef30df9e --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-name.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/delete-machines-by-name +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-role.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-role.mdx new file mode 100644 index 0000000000..2f1c71c65f --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-role.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/delete-machines-by-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/enable-disable-machine.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/enable-disable-machine.mdx new file mode 100644 index 0000000000..15947e2b88 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/enable-disable-machine.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/enable-disable-machine +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/find-target-usage.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/find-target-usage.mdx new file mode 100644 index 0000000000..201eb64ede --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/find-target-usage.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/find-target-usage +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/find-unused-targets.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/find-unused-targets.mdx new file mode 100644 index 0000000000..7ca2e675de --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/find-unused-targets.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/find-unused-targets +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/index.md b/src/pages/docs/octopus-rest-api/examples/deployment-targets/index.md new file mode 100644 index 0000000000..cb315d7836 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-listening-tentacle.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-listening-tentacle.mdx new file mode 100644 index 0000000000..11bb9ee269 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-listening-tentacle.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/register-listening-tentacle +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-polling-tentacle.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-polling-tentacle.mdx new file mode 100644 index 0000000000..cc900a13d0 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-polling-tentacle.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/register-polling-tentacle +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-ssh-target.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-ssh-target.mdx new file mode 100644 index 0000000000..36a1935b25 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/register-ssh-target.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/register-ssh-target +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployment-targets/upgrade-machines.mdx b/src/pages/docs/octopus-rest-api/examples/deployment-targets/upgrade-machines.mdx new file mode 100644 index 0000000000..7176eda6d6 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployment-targets/upgrade-machines.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployment-targets/upgrade-machines +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/cancel-queued-deployments.mdx b/src/pages/docs/octopus-rest-api/examples/deployments/cancel-queued-deployments.mdx new file mode 100644 index 0000000000..63b99f1b17 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployments/cancel-queued-deployments.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployments/cancel-queued-deployments +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/create-and-deploy-a-release.mdx b/src/pages/docs/octopus-rest-api/examples/deployments/create-and-deploy-a-release.mdx new file mode 100644 index 0000000000..316c0f9f8e --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployments/create-and-deploy-a-release.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployments/create-and-deploy-a-release +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/deploy-release-with-prompted-variables.mdx b/src/pages/docs/octopus-rest-api/examples/deployments/deploy-release-with-prompted-variables.mdx new file mode 100644 index 0000000000..3fce09b638 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployments/deploy-release-with-prompted-variables.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployments/deploy-release-with-prompted-variables +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/deploy-release.mdx b/src/pages/docs/octopus-rest-api/examples/deployments/deploy-release.mdx new file mode 100644 index 0000000000..740f563e75 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployments/deploy-release.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployments/deploy-release +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/index.md b/src/pages/docs/octopus-rest-api/examples/deployments/index.md new file mode 100644 index 0000000000..9f61c60f1a --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployments/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployments +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/deployments/list-deployments-to-environment.mdx b/src/pages/docs/octopus-rest-api/examples/deployments/list-deployments-to-environment.mdx new file mode 100644 index 0000000000..afb8f1183c --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/deployments/list-deployments-to-environment.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/deployments/list-deployments-to-environment +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/environments/add-environments.mdx b/src/pages/docs/octopus-rest-api/examples/environments/add-environments.mdx new file mode 100644 index 0000000000..d0054a7b60 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/environments/add-environments.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/environments/add-environments +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/environments/index.md b/src/pages/docs/octopus-rest-api/examples/environments/index.md new file mode 100644 index 0000000000..4a10bb99e5 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/environments/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/environments +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/events/find-events-by-date.mdx b/src/pages/docs/octopus-rest-api/examples/events/find-events-by-date.mdx new file mode 100644 index 0000000000..ff340b6499 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/events/find-events-by-date.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/events/find-events-by-date +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/events/index.md b/src/pages/docs/octopus-rest-api/examples/events/index.md new file mode 100644 index 0000000000..0c97ae6a90 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/events/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/events +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/change-feed.mdx b/src/pages/docs/octopus-rest-api/examples/feeds/change-feed.mdx new file mode 100644 index 0000000000..f221a7d3c9 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/change-feed.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds/change-feed +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/create-feed.mdx b/src/pages/docs/octopus-rest-api/examples/feeds/create-feed.mdx new file mode 100644 index 0000000000..8627d7ddac --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/create-feed.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds/create-feed +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/delete-feed.mdx b/src/pages/docs/octopus-rest-api/examples/feeds/delete-feed.mdx new file mode 100644 index 0000000000..3e77d0d5f8 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/delete-feed.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds/delete-feed +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/download-package-from-builtin-feed.mdx b/src/pages/docs/octopus-rest-api/examples/feeds/download-package-from-builtin-feed.mdx new file mode 100644 index 0000000000..58e1cdfbcf --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/download-package-from-builtin-feed.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds/download-package-from-builtin-feed +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md b/src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md new file mode 100644 index 0000000000..553153c60c --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds/get-feeds +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/index.md b/src/pages/docs/octopus-rest-api/examples/feeds/index.md new file mode 100644 index 0000000000..bdee561bcd --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/push-package-to-builtin-feed.mdx b/src/pages/docs/octopus-rest-api/examples/feeds/push-package-to-builtin-feed.mdx new file mode 100644 index 0000000000..2afe49d9ec --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/push-package-to-builtin-feed.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds/push-package-to-builtin-feed +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/retrieve-feeds.mdx b/src/pages/docs/octopus-rest-api/examples/feeds/retrieve-feeds.mdx new file mode 100644 index 0000000000..6f8e26819b --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/retrieve-feeds.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds/retrieve-feeds +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/synchronize-packages.mdx b/src/pages/docs/octopus-rest-api/examples/feeds/synchronize-packages.mdx new file mode 100644 index 0000000000..7b0204e367 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/feeds/synchronize-packages.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/feeds/synchronize-packages +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md b/src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md new file mode 100644 index 0000000000..c2279c66ff --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/get-steps-using-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/lifecycles/create-lifecycle.mdx b/src/pages/docs/octopus-rest-api/examples/lifecycles/create-lifecycle.mdx new file mode 100644 index 0000000000..6aae2d4365 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/lifecycles/create-lifecycle.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/lifecycles/create-lifecycle +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/lifecycles/index.md b/src/pages/docs/octopus-rest-api/examples/lifecycles/index.md new file mode 100644 index 0000000000..78e381a149 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/lifecycles/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/lifecycles +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/list-users-with-role.md b/src/pages/docs/octopus-rest-api/examples/list-users-with-role.md new file mode 100644 index 0000000000..0d23c9017f --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/list-users-with-role.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/list-users-with-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/project-groups/create-projectgroup.mdx b/src/pages/docs/octopus-rest-api/examples/project-groups/create-projectgroup.mdx new file mode 100644 index 0000000000..1c09c0b575 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/project-groups/create-projectgroup.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/project-groups/create-projectgroup +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/project-groups/index.md b/src/pages/docs/octopus-rest-api/examples/project-groups/index.md new file mode 100644 index 0000000000..642beb54be --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/project-groups/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/project-groups +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/coordinating-multiple-projects.mdx b/src/pages/docs/octopus-rest-api/examples/projects/coordinating-multiple-projects.mdx new file mode 100644 index 0000000000..400ee2270a --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/coordinating-multiple-projects.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/coordinating-multiple-projects +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/create-project.mdx b/src/pages/docs/octopus-rest-api/examples/projects/create-project.mdx new file mode 100644 index 0000000000..ff280e33b8 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/create-project.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/create-project +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/delete-project.mdx b/src/pages/docs/octopus-rest-api/examples/projects/delete-project.mdx new file mode 100644 index 0000000000..4a8ab57bcb --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/delete-project.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/delete-project +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/delete-projects-with-empty-processes.mdx b/src/pages/docs/octopus-rest-api/examples/projects/delete-projects-with-empty-processes.mdx new file mode 100644 index 0000000000..ae8cd38ce1 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/delete-projects-with-empty-processes.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/delete-projects-with-empty-processes +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/disable-project-triggers.mdx b/src/pages/docs/octopus-rest-api/examples/projects/disable-project-triggers.mdx new file mode 100644 index 0000000000..1afe93b86f --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/disable-project-triggers.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/disable-project-triggers +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/enable-disable-project.mdx b/src/pages/docs/octopus-rest-api/examples/projects/enable-disable-project.mdx new file mode 100644 index 0000000000..53556c0bd2 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/enable-disable-project.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/enable-disable-project +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/export-projects.mdx b/src/pages/docs/octopus-rest-api/examples/projects/export-projects.mdx new file mode 100644 index 0000000000..669c63a134 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/export-projects.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/export-projects +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/find-unused-projects.mdx b/src/pages/docs/octopus-rest-api/examples/projects/find-unused-projects.mdx new file mode 100644 index 0000000000..c94a012940 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/find-unused-projects.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/find-unused-projects +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/import-projects.mdx b/src/pages/docs/octopus-rest-api/examples/projects/import-projects.mdx new file mode 100644 index 0000000000..07b7c3774b --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/import-projects.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects/import-projects +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/projects/index.md b/src/pages/docs/octopus-rest-api/examples/projects/index.md new file mode 100644 index 0000000000..df76443eef --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/projects/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/projects +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/publish-runbook.md b/src/pages/docs/octopus-rest-api/examples/publish-runbook.md new file mode 100644 index 0000000000..d252fe9009 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/publish-runbook.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/publish-runbook +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md b/src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md new file mode 100644 index 0000000000..6aeaa9534a --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/register-listening-tentacle +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md b/src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md new file mode 100644 index 0000000000..51f6a20ec8 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/register-polling-tentacle +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/releases/create-release-with-specific-version.mdx b/src/pages/docs/octopus-rest-api/examples/releases/create-release-with-specific-version.mdx new file mode 100644 index 0000000000..a1f8d8ad58 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/releases/create-release-with-specific-version.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/releases/create-release-with-specific-version +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/releases/delete-project-releases.mdx b/src/pages/docs/octopus-rest-api/examples/releases/delete-project-releases.mdx new file mode 100644 index 0000000000..7d4dad7ceb --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/releases/delete-project-releases.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/releases/delete-project-releases +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/releases/index.md b/src/pages/docs/octopus-rest-api/examples/releases/index.md new file mode 100644 index 0000000000..40c27ee482 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/releases/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/releases +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/releases/promote-release-not-in-destination.mdx b/src/pages/docs/octopus-rest-api/examples/releases/promote-release-not-in-destination.mdx new file mode 100644 index 0000000000..c63f0e56d9 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/releases/promote-release-not-in-destination.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/releases/promote-release-not-in-destination +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/releases/update-release-variable-snapshot.mdx b/src/pages/docs/octopus-rest-api/examples/releases/update-release-variable-snapshot.mdx new file mode 100644 index 0000000000..3c183d9d2d --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/releases/update-release-variable-snapshot.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/releases/update-release-variable-snapshot +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/replace-certificate.md b/src/pages/docs/octopus-rest-api/examples/replace-certificate.md new file mode 100644 index 0000000000..823fd8e031 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/replace-certificate.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/replace-certificate +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/reports/deployments-per-target-role-report.mdx b/src/pages/docs/octopus-rest-api/examples/reports/deployments-per-target-role-report.mdx new file mode 100644 index 0000000000..d0a808451b --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/reports/deployments-per-target-role-report.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/reports/deployments-per-target-role-report +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/reports/environment-permissions-report.mdx b/src/pages/docs/octopus-rest-api/examples/reports/environment-permissions-report.mdx new file mode 100644 index 0000000000..2e5f3b888f --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/reports/environment-permissions-report.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/reports/environment-permissions-report +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/reports/index.md b/src/pages/docs/octopus-rest-api/examples/reports/index.md new file mode 100644 index 0000000000..973964767e --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/reports/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/reports +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/reports/project-permissions-report.mdx b/src/pages/docs/octopus-rest-api/examples/reports/project-permissions-report.mdx new file mode 100644 index 0000000000..8a07248806 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/reports/project-permissions-report.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/reports/project-permissions-report +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/reports/project-release-deployment-targets-report.mdx b/src/pages/docs/octopus-rest-api/examples/reports/project-release-deployment-targets-report.mdx new file mode 100644 index 0000000000..5784c4318b --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/reports/project-release-deployment-targets-report.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/reports/project-release-deployment-targets-report +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/run-runbook.md b/src/pages/docs/octopus-rest-api/examples/run-runbook.md new file mode 100644 index 0000000000..358080d153 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/run-runbook.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/run-runbook +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/add-script-step-to-runbook.mdx b/src/pages/docs/octopus-rest-api/examples/runbooks/add-script-step-to-runbook.mdx new file mode 100644 index 0000000000..4a137dc4ae --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/runbooks/add-script-step-to-runbook.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/runbooks/add-script-step-to-runbook +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/create-and-publish-runbook.mdx b/src/pages/docs/octopus-rest-api/examples/runbooks/create-and-publish-runbook.mdx new file mode 100644 index 0000000000..f5d70fc444 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/runbooks/create-and-publish-runbook.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/runbooks/create-and-publish-runbook +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/create-runbook.mdx b/src/pages/docs/octopus-rest-api/examples/runbooks/create-runbook.mdx new file mode 100644 index 0000000000..5bc9e53b68 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/runbooks/create-runbook.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/runbooks/create-runbook +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/create-scheduled-runbook-trigger.mdx b/src/pages/docs/octopus-rest-api/examples/runbooks/create-scheduled-runbook-trigger.mdx new file mode 100644 index 0000000000..dec8576085 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/runbooks/create-scheduled-runbook-trigger.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/runbooks/create-scheduled-runbook-trigger +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/index.md b/src/pages/docs/octopus-rest-api/examples/runbooks/index.md new file mode 100644 index 0000000000..9ca47fffbf --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/runbooks/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/runbooks +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/publish-runbook.mdx b/src/pages/docs/octopus-rest-api/examples/runbooks/publish-runbook.mdx new file mode 100644 index 0000000000..338d0e85e1 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/runbooks/publish-runbook.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/runbooks/publish-runbook +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook-with-prompted-variables.mdx b/src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook-with-prompted-variables.mdx new file mode 100644 index 0000000000..5610320114 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook-with-prompted-variables.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/runbooks/run-runbook-with-prompted-variables +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook.mdx b/src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook.mdx new file mode 100644 index 0000000000..c7eeefda46 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/runbooks/run-runbook.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/runbooks/run-runbook +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments.mdx b/src/pages/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments.mdx new file mode 100644 index 0000000000..efe595cd45 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/spaces/add-a-space-with-environments +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/spaces/delete-a-space.mdx b/src/pages/docs/octopus-rest-api/examples/spaces/delete-a-space.mdx new file mode 100644 index 0000000000..34ec2c5949 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/spaces/delete-a-space.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/spaces/delete-a-space +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/spaces/index.md b/src/pages/docs/octopus-rest-api/examples/spaces/index.md new file mode 100644 index 0000000000..7048f838e9 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/spaces/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/spaces +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/step-templates/export-step-templates.mdx b/src/pages/docs/octopus-rest-api/examples/step-templates/export-step-templates.mdx new file mode 100644 index 0000000000..8168e09831 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/step-templates/export-step-templates.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/step-templates/export-step-templates +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/step-templates/index.md b/src/pages/docs/octopus-rest-api/examples/step-templates/index.md new file mode 100644 index 0000000000..40de7eed71 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/step-templates/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/step-templates +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tagsets/create-tagset.mdx b/src/pages/docs/octopus-rest-api/examples/tagsets/create-tagset.mdx new file mode 100644 index 0000000000..eba091c595 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tagsets/create-tagset.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tagsets/create-tagset +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tagsets/index.md b/src/pages/docs/octopus-rest-api/examples/tagsets/index.md new file mode 100644 index 0000000000..bca4532c99 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tagsets/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tagsets +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tasks/index.md b/src/pages/docs/octopus-rest-api/examples/tasks/index.md new file mode 100644 index 0000000000..ab6cae972d --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tasks/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tasks +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tasks/reprioritize-tasks.mdx b/src/pages/docs/octopus-rest-api/examples/tasks/reprioritize-tasks.mdx new file mode 100644 index 0000000000..f1433e1967 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tasks/reprioritize-tasks.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tasks/reprioritize-tasks +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tasks/run-healthcheck.mdx b/src/pages/docs/octopus-rest-api/examples/tasks/run-healthcheck.mdx new file mode 100644 index 0000000000..21afd98146 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tasks/run-healthcheck.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tasks/run-healthcheck +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md b/src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md new file mode 100644 index 0000000000..8fdfb7c7d1 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tenants/bulk-add-projects-to-tenants +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/create-tenant.mdx b/src/pages/docs/octopus-rest-api/examples/tenants/create-tenant.mdx new file mode 100644 index 0000000000..da73ec92c9 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tenants/create-tenant.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tenants/create-tenant +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/deactivate-tenant.mdx b/src/pages/docs/octopus-rest-api/examples/tenants/deactivate-tenant.mdx new file mode 100644 index 0000000000..5f19fa40a4 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tenants/deactivate-tenant.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tenants/deactivate-tenant +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/index.md b/src/pages/docs/octopus-rest-api/examples/tenants/index.md new file mode 100644 index 0000000000..31068723d9 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tenants/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tenants +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/update-tenant-variable.mdx b/src/pages/docs/octopus-rest-api/examples/tenants/update-tenant-variable.mdx new file mode 100644 index 0000000000..cc959dcbfa --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/tenants/update-tenant-variable.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/tenants/update-tenant-variable +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-azure-ad-to-users.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-azure-ad-to-users.mdx new file mode 100644 index 0000000000..62877f3c7c --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-azure-ad-to-users.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/add-azure-ad-to-users +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-domain-teams.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-domain-teams.mdx new file mode 100644 index 0000000000..fc7d3b5952 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-domain-teams.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/add-domain-teams +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-environment-to-team.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-environment-to-team.mdx new file mode 100644 index 0000000000..13d2c0e924 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/add-environment-to-team.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/add-environment-to-team +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/change-users-domain.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/change-users-domain.mdx new file mode 100644 index 0000000000..98bdc99994 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/change-users-domain.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/change-users-domain +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/create-api-key.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/create-api-key.mdx new file mode 100644 index 0000000000..26edc3add3 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/create-api-key.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/create-api-key +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/find-teams-with-role.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/find-teams-with-role.mdx new file mode 100644 index 0000000000..23209f7184 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/find-teams-with-role.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/find-teams-with-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/index.md b/src/pages/docs/octopus-rest-api/examples/users-and-teams/index.md new file mode 100644 index 0000000000..a4f8a8e197 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-editing-roles.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-editing-roles.mdx new file mode 100644 index 0000000000..dc77855d8f --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-editing-roles.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/list-users-with-editing-roles +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role.mdx new file mode 100644 index 0000000000..047267ea7c --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/list-users-with-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users.mdx new file mode 100644 index 0000000000..14a8ebdd83 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/list-users.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/list-users +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/remove-project-from-team.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/remove-project-from-team.mdx new file mode 100644 index 0000000000..b62772c3a7 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/remove-project-from-team.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/remove-project-from-team +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx new file mode 100644 index 0000000000..69c3405382 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx b/src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx new file mode 100644 index 0000000000..9323f23d39 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users/index.md b/src/pages/docs/octopus-rest-api/examples/users/index.md new file mode 100644 index 0000000000..494f382fe3 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md b/src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md new file mode 100644 index 0000000000..4c8a3ade9a --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/users/list-users-with-role +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/add-library-set-to-project.mdx b/src/pages/docs/octopus-rest-api/examples/variables/add-library-set-to-project.mdx new file mode 100644 index 0000000000..52bd26c4f7 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/add-library-set-to-project.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/add-library-set-to-project +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/add-update-project-variable.mdx b/src/pages/docs/octopus-rest-api/examples/variables/add-update-project-variable.mdx new file mode 100644 index 0000000000..6650818c23 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/add-update-project-variable.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/add-update-project-variable +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/clear-sensitive-variables.mdx b/src/pages/docs/octopus-rest-api/examples/variables/clear-sensitive-variables.mdx new file mode 100644 index 0000000000..34d599f384 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/clear-sensitive-variables.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/clear-sensitive-variables +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-projects-using-library-set.mdx b/src/pages/docs/octopus-rest-api/examples/variables/find-projects-using-library-set.mdx new file mode 100644 index 0000000000..a5e724ae7e --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/find-projects-using-library-set.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/find-projects-using-library-set +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variable-usage.mdx b/src/pages/docs/octopus-rest-api/examples/variables/find-variable-usage.mdx new file mode 100644 index 0000000000..8cfde392de --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/find-variable-usage.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/find-variable-usage +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variable-value-usage.mdx b/src/pages/docs/octopus-rest-api/examples/variables/find-variable-value-usage.mdx new file mode 100644 index 0000000000..c2284f655d --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/find-variable-value-usage.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/find-variable-value-usage +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md b/src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md new file mode 100644 index 0000000000..09ba534d7b --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/find-variable-vaule-usage +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variableset-variables-usage.mdx b/src/pages/docs/octopus-rest-api/examples/variables/find-variableset-variables-usage.mdx new file mode 100644 index 0000000000..cab79c335e --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/find-variableset-variables-usage.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/find-variableset-variables-usage +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/index.md b/src/pages/docs/octopus-rest-api/examples/variables/index.md new file mode 100644 index 0000000000..57cc967b1d --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/index.md @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/octopus-rest-api/examples/variables/update-variable-set-variable-value.mdx b/src/pages/docs/octopus-rest-api/examples/variables/update-variable-set-variable-value.mdx new file mode 100644 index 0000000000..f74ba2e146 --- /dev/null +++ b/src/pages/docs/octopus-rest-api/examples/variables/update-variable-set-variable-value.mdx @@ -0,0 +1,10 @@ +--- +layout: src/layouts/Redirect.astro +title: Redirect +redirect: https://octopus.com/docs/api/examples/variables/update-variable-set-variable-value +pubDate: 2023-01-01 +modDate: 2026-09-01 +navSearch: false +navSitemap: false +navMenu: false +--- diff --git a/src/pages/docs/projects/export-import/index.mdx b/src/pages/docs/projects/export-import/index.mdx index 5aebd991f7..44d87df13e 100644 --- a/src/pages/docs/projects/export-import/index.mdx +++ b/src/pages/docs/projects/export-import/index.mdx @@ -249,8 +249,8 @@ You can use the [Octopus REST API](/docs/octopus-rest-api) to export or import O To find out more take a look at our examples: -- [Export projects](/docs/octopus-rest-api/examples/projects/export-projects) -- [Import projects](/docs/octopus-rest-api/examples/projects/import-projects) +- [Export projects](/docs/api/examples/projects/export-projects) +- [Import projects](/docs/api/examples/projects/import-projects) ## Older versions diff --git a/src/pages/docs/tenants/tag-sets.md b/src/pages/docs/tenants/tag-sets.md index 87f4457008..7532c16795 100644 --- a/src/pages/docs/tenants/tag-sets.md +++ b/src/pages/docs/tenants/tag-sets.md @@ -98,5 +98,5 @@ You can use canonical names when: ## Learn more -- [Create a tag set via the REST API](/docs/octopus-rest-api/examples/tagsets/create-tagset) +- [Create a tag set via the REST API](/docs/api/examples/tagsets/create-tagset) - [Deployment patterns blog posts](https://octopus.com/blog/tag/Deployment%20Patterns) diff --git a/src/pages/docs/tenants/tenant-creation/index.mdx b/src/pages/docs/tenants/tenant-creation/index.mdx index 3e6514d3e5..08f4c97a59 100644 --- a/src/pages/docs/tenants/tenant-creation/index.mdx +++ b/src/pages/docs/tenants/tenant-creation/index.mdx @@ -15,7 +15,7 @@ import TenantsCreateTenant from 'src/shared-content/tenants/tenants-create-tenan Now that you've created a tenant, you can enable [tenanted deployments](/docs/tenants/tenant-creation/tenanted-deployments/) and then [connect the tenant to a project](/docs/tenants/tenant-creation/connecting-projects). :::div{.hint} -It's also possible to create a tenant using the [Octopus REST API](/docs/octopus-rest-api/). Learn more in our [create a tenant](/docs/octopus-rest-api/examples/tenants/create-tenant) example. +It's also possible to create a tenant using the [Octopus REST API](/docs/octopus-rest-api/). Learn more in our [create a tenant](/docs/api/examples/tenants/create-tenant) example. ::: ## Tenant logo \{#tenant-logo} diff --git a/src/shared-content/installation/migrate-from-windows-to-linux-container.include.md b/src/shared-content/installation/migrate-from-windows-to-linux-container.include.md index 19d1b70127..3f64f32acb 100644 --- a/src/shared-content/installation/migrate-from-windows-to-linux-container.include.md +++ b/src/shared-content/installation/migrate-from-windows-to-linux-container.include.md @@ -69,8 +69,8 @@ To migrate from Active Directory to LDAP, you will need to: 1. Enable and configure the [LDAP auth provider](/docs/security/authentication/ldap). 2. Add the LDAP auth provider to each user and group. We created two scripts to help speed that up: - - [Swap Active Directory groups with matching LDAP groups](/docs/octopus-rest-api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group) for Octopus teams. - - [Swap Active Directory login records with matching LDAP ones](/docs/octopus-rest-api/examples/users-and-teams/swap-users-ad-domain-to-ldap) for Octopus users. + - [Swap Active Directory groups with matching LDAP groups](/docs/api/examples/users-and-teams/swap-ad-domain-group-with-ldap-group) for Octopus teams. + - [Swap Active Directory login records with matching LDAP ones](/docs/api/examples/users-and-teams/swap-users-ad-domain-to-ldap) for Octopus users. 3. Log out with your current user and log back in, ideally with a new test user. 4. Verify permissions are as expected. 5. Test a few more users out. diff --git a/src/shared-content/scripts/sync-packages-scripts.include.md b/src/shared-content/scripts/sync-packages-scripts.include.md index ec5624e14b..799013b8db 100644 --- a/src/shared-content/scripts/sync-packages-scripts.include.md +++ b/src/shared-content/scripts/sync-packages-scripts.include.md @@ -10,7 +10,7 @@ param ( [ValidateSet("FileVersions", "LatestVersion", "AllVersions")] [string] $VersionSelection = "FileVersions", - [Parameter(Mandatory, HelpMessage="See https://octopus.com/docs/octopus-rest-api/examples/feeds/synchronize-packages#usage for example file list structure.")] + [Parameter(Mandatory, HelpMessage="See https://octopus.com/docs/api/examples/feeds/synchronize-packages#usage for example file list structure.")] [string] $PackageListFilePath, [Parameter(Mandatory)] From f64ede84b4642a21a6dd8cbd8684fc6ed0dc6035 Mon Sep 17 00:00:00 2001 From: Orion Edwards Date: Wed, 2 Sep 2026 00:08:24 +1200 Subject: [PATCH 4/8] Redirecting the redirects --- .github/CODEOWNERS | 36 ++++--------------- src/pages/components.mdx | 2 +- .../auto-scaling-high-availability-nodes.md | 2 +- .../managing-infrastructure/rate-limiting.md | 2 +- .../managing-configuration.md | 4 +-- .../migrate-spaces-with-octoterra/index.md | 6 ++-- .../report-on-deployments-excel-template.md | 2 +- .../report-on-deployments-using-excel.md | 2 +- .../api/how-to-create-an-api-key.md | 2 +- .../examples/add-a-space-with-environments.md | 2 +- .../examples/delete-a-space.md | 2 +- .../api-and-integration/examples/index.md | 2 +- .../migration-api/index.md | 2 +- .../api-and-integration/octopus.client.md | 2 +- .../openid-connect/github-actions.md | 2 +- .../authentication/openid-connect/index.md | 10 +++--- .../openid-connect/other-issuers.md | 2 +- .../examples/add-a-space-with-environments.md | 2 +- .../docs/api/examples/add-azure-web-app.md | 2 +- .../api/examples/add-environment-to-step.md | 2 +- .../api/examples/cancel-queued-deployments.md | 2 +- .../examples/change-machine-machinepolicy.md | 2 +- .../examples/create-and-deploy-a-release.md | 2 +- .../create-azure-service-principal.md | 2 +- .../docs/api/examples/create-certificate.md | 2 +- src/pages/docs/api/examples/create-project.md | 2 +- src/pages/docs/api/examples/create-runbook.md | 2 +- .../docs/api/examples/create-script-step.md | 2 +- src/pages/docs/api/examples/delete-a-space.md | 2 +- .../api/examples/delete-machines-by-role.md | 2 +- .../api/examples/delete-project-releases.md | 2 +- .../docs/api/examples/feeds/get-feeds.md | 2 +- .../docs/api/examples/get-steps-using-role.md | 2 +- src/pages/docs/api/examples/index.md | 4 +-- .../docs/api/examples/list-users-with-role.md | 2 +- .../docs/api/examples/publish-runbook.md | 2 +- .../examples/register-listening-tentacle.md | 2 +- .../api/examples/register-polling-tentacle.md | 2 +- .../docs/api/examples/replace-certificate.md | 2 +- src/pages/docs/api/examples/run-runbook.md | 2 +- .../tenants/bulk-add-projects-to-tenants.md | 2 +- .../users-and-teams/create-api-key.mdx | 2 +- src/pages/docs/api/examples/users/index.md | 2 +- .../examples/users/list-users-with-role.md | 2 +- .../variables/find-variable-vaule-usage.md | 2 +- .../octopus.client/using-client-directly.md | 2 +- .../instances/automated-installation.md | 2 +- .../users-roles-and-teams.md | 2 +- .../managing-project-resources.md | 4 +-- .../managing-runbook-resources.md | 4 +-- .../managing-space-resources.md | 6 ++-- .../databases/sql-server/redgate.md | 2 +- .../docs/deployments/node-js/node-on-linux.md | 4 +-- .../keeping-deployment-targets-up-to-date.md | 2 +- .../eks-reference-architecture.md | 2 +- .../webapp-reference-architecture.md | 2 +- .../how-to/how-to-create-an-api-key/index.md | 2 +- .../index.md | 2 +- .../infrastructure/accounts/azure/index.md | 2 +- .../via-the-azure-portal.mdx | 2 +- .../docs/infrastructure/workers/index.mdx | 4 +-- src/pages/docs/installation/index.mdx | 2 +- .../live-object-status/installation.md | 2 +- .../octopus-ai/claude-agent-step/tools.md | 2 +- src/pages/docs/octopus-ai/index.mdx | 2 +- src/pages/docs/octopus-ai/mcp/local/index.md | 4 +-- src/pages/docs/octopus-ai/mcp/remote/index.md | 4 +-- .../docs/octopus-ai/mcp/remote/use-cases.md | 2 +- .../docs/octopus-cloud/connection-agent.md | 2 +- .../docs/octopus-cloud/disaster-recovery.md | 2 +- src/pages/docs/octopus-cloud/migrations.md | 2 +- .../examples/add-a-space-with-environments.md | 2 +- .../examples/add-azure-web-app.md | 2 +- .../examples/add-environment-to-step.md | 2 +- .../examples/cancel-queued-deployments.md | 2 +- .../examples/change-machine-machinepolicy.md | 2 +- .../examples/create-and-deploy-a-release.md | 2 +- .../create-azure-service-principal.md | 2 +- .../examples/create-certificate.md | 2 +- .../examples/create-project.md | 2 +- .../examples/create-runbook.md | 2 +- .../examples/create-script-step.md | 2 +- .../examples/delete-a-space.md | 2 +- .../examples/delete-machines-by-role.md | 2 +- .../examples/delete-project-releases.md | 2 +- .../examples/feeds/get-feeds.md | 2 +- .../examples/get-steps-using-role.md | 2 +- .../examples/list-users-with-role.md | 2 +- .../examples/publish-runbook.md | 2 +- .../examples/register-listening-tentacle.md | 2 +- .../examples/register-polling-tentacle.md | 2 +- .../examples/replace-certificate.md | 2 +- .../octopus-rest-api/examples/run-runbook.md | 2 +- .../tenants/bulk-add-projects-to-tenants.md | 2 +- .../octopus-rest-api/examples/users/index.md | 2 +- .../examples/users/list-users-with-role.md | 2 +- .../variables/find-variable-vaule-usage.md | 2 +- .../build-servers/appveyor/index.md | 2 +- .../build-servers/bamboo.md | 2 +- .../build-servers/codefresh-pipelines.md | 2 +- .../build-servers/jenkins/index.mdx | 4 +-- .../build-servers/teamcity.mdx | 2 +- .../using-octopus-extension/index.mdx | 2 +- .../create-packages/octopack/index.md | 2 +- .../create-packages/octopus-cli.md | 2 +- .../built-in-repository/index.md | 8 ++--- .../process-templates/troubleshooting.md | 2 +- .../projects/deployment-process/index.mdx | 2 +- src/pages/docs/releases/channels/index.md | 2 +- .../runbooks/runbook-permissions/index.md | 2 +- .../runbooks/webhook-runbook-trigger/index.md | 2 +- .../security/cve/csrf-and-octopus-deploy.md | 2 +- .../users-and-teams/auditing/index.md | 2 +- .../docs/security/users-and-teams/index.md | 4 +-- .../users-and-teams/service-accounts.md | 10 +++--- src/pages/docs/tenants/tag-sets.md | 2 +- .../docs/tenants/tenant-creation/index.mdx | 2 +- .../docs/tenants/tenant-deployment-faq.md | 2 +- src/pages/docs/tenants/tenant-tags.md | 2 +- src/scripts/search-engine.ts | 2 +- .../octopus-project-variables-include.mdx | 2 +- ...oject-coordination-code-samples.include.md | 2 +- .../configure-linux-polling-worker.include.md | 2 +- .../configure-polling-target.include.md | 2 +- ...onfigure-windows-polling-worker.include.md | 2 +- tests/code-block.spec.ts | 2 +- 126 files changed, 156 insertions(+), 180 deletions(-) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index ad8fd3d92e..8b2b26b785 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -325,51 +325,27 @@ # updates to the octopus rest api overview page are reviewed by team-marketing -/docs/octopus-rest-api/index.mdx @OctopusDeploy/team-marketing +/docs/api/index.mdx @OctopusDeploy/team-marketing # updates to the how to create an api key page are reviewed by team-backend-foundations -/docs/octopus-rest-api/how-to-create-an-api-key.md @OctopusDeploy/team-backend-foundations +/docs/api/how-to-create-an-api-key.md @OctopusDeploy/team-backend-foundations # updates to the octopus client page are reviewed by team-backend-foundations -/docs/octopus-rest-api/octopus.client/index.md @OctopusDeploy/team-backend-foundations +/docs/api/octopus.client/index.md @OctopusDeploy/team-backend-foundations # updates to the octopus command line sections are reviewed by team-modern-deployments -/docs/octopus-rest-api/octopus-cli/ @OctopusDeploy/team-modern-deployments - -# updates to the API examples page are reviewed by team-backend-foundations - -/docs/octopus-rest-api/examples/index.md @OctopusDeploy/team-backend-foundations - -# updates to the octopus server command line page are reviewed by team-backend-foundations - -/docs/octopus-rest-api/octopus.server.exe-command-line/index.md @OctopusDeploy/team-backend-foundations - -# updates to the octopus rest api tentacle exe command line page are reviewed by team-executions-foundations - -/docs/octopus-rest-api/tentacle.exe-command-line/index.md @OctopusDeploy/team-executions-foundations - -# updates to the calamari page are reviewed by team-modern-deployments - -/docs/octopus-rest-api/calamari.md @OctopusDeploy/team-modern-deployments - -# updates to the octopus migrator command line page are reviewed by team-backend-foundations - -/docs/octopus-rest-api/octopus.migrator.exe-command-line/index.md @OctopusDeploy/team-backend-foundations - -# updates to the migration api page are reviewed by team-backend-foundations - -/docs/octopus-rest-api/migration-api/index.md @OctopusDeploy/team-backend-foundations +/docs/api/octopus-cli/ @OctopusDeploy/team-modern-deployments # updates to the octopus CLI sections are reviewed by team-modern-deployments -/docs/octopus-rest-api/cli/ @OctopusDeploy/team-modern-deployments +/docs/cli/ @OctopusDeploy/team-modern-deployments # updates to the openid connect page are reviewed by team-devex -/docs/octopus-rest-api/openid-connect/ @OctopusDeploy/team-devex +/docs/api/openid-connect/ @OctopusDeploy/team-devex # updates to the administration section are reviewed by team-backend-foundations diff --git a/src/pages/components.mdx b/src/pages/components.mdx index 3abc05b5f7..6db7d0d879 100644 --- a/src/pages/components.mdx +++ b/src/pages/components.mdx @@ -41,7 +41,7 @@ export const searchDemoResults = [ facet: 'docs', }, { - url: '/docs/octopus-rest-api/feeds/modify-a-feed', + url: '/docs/api/feeds/modify-a-feed', title: 'Modify a feed', excerpt: 'Updates the specified feed by setting the values of the parameters passed.', diff --git a/src/pages/docs/administration/high-availability/auto-scaling-high-availability-nodes.md b/src/pages/docs/administration/high-availability/auto-scaling-high-availability-nodes.md index 2791668d2d..b890ae4b3b 100644 --- a/src/pages/docs/administration/high-availability/auto-scaling-high-availability-nodes.md +++ b/src/pages/docs/administration/high-availability/auto-scaling-high-availability-nodes.md @@ -214,7 +214,7 @@ A task node is a node where the task cap is greater than 0. By default, all nod While High Availability was designed to add nodes quickly, it was not designed to delete nodes quickly. The assumption was made when a node went offline; it was for a server restart. It was not designed to handle scale-in events from an auto-scaling technology automatically. -Auto-scaling technologies don't let you run scripts directly on virtual machines as they are being deleted. They will typically publish a message you can process. Because of that, you'll need to leverage the [Octopus Deploy REST API](/docs/octopus-rest-api) to do the following: +Auto-scaling technologies don't let you run scripts directly on virtual machines as they are being deleted. They will typically publish a message you can process. Because of that, you'll need to leverage the [Octopus Deploy REST API](/docs/api) to do the following: - Enable drain mode on the node. While that is enabled, it will prevent the node from picking up new tasks and will attempt to finish in-process tasks. - Wait until either the node is marked offline or all tasks have finished processing. diff --git a/src/pages/docs/administration/managing-infrastructure/rate-limiting.md b/src/pages/docs/administration/managing-infrastructure/rate-limiting.md index 90fb64af06..6ad7cd60e0 100644 --- a/src/pages/docs/administration/managing-infrastructure/rate-limiting.md +++ b/src/pages/docs/administration/managing-infrastructure/rate-limiting.md @@ -33,7 +33,7 @@ The rate limit applies per user. ### Authenticated AI Agent Requests -This policy applies to any HTTP requests associated with an authenticated user which authenticate using an [agent API key](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key). +This policy applies to any HTTP requests associated with an authenticated user which authenticate using an [agent API key](/docs/api/create-an-api-key#creating-an-agent-api-key). The rate limit applies per user, counted separately from non-AI requests. ### Webhook Trigger Requests diff --git a/src/pages/docs/administration/managing-infrastructure/server-configuration/managing-configuration.md b/src/pages/docs/administration/managing-infrastructure/server-configuration/managing-configuration.md index 6f244a1d69..5f6e483735 100644 --- a/src/pages/docs/administration/managing-infrastructure/server-configuration/managing-configuration.md +++ b/src/pages/docs/administration/managing-infrastructure/server-configuration/managing-configuration.md @@ -20,7 +20,7 @@ In the Octopus Web Portal, you can access configuration by navigating to **Confi ## Octopus.Client -Using [Octopus.Client](/docs/octopus-rest-api/octopus.client), each of the configuration types can be managed programmatically, reading from and writing back to the Octopus Deploy database. +Using [Octopus.Client](/docs/api/octopus.client), each of the configuration types can be managed programmatically, reading from and writing back to the Octopus Deploy database. :::div{.hint} This requires version 15.2.0 or later of the client library. @@ -67,4 +67,4 @@ $guestConfig.IsEnabled = $true; $guestConfig = $modifyMethod.Invoke($repo.Configuration, $guestConfig) ``` -For more information on using the Octopus.Client library see [Octopus.Client](/docs/octopus-rest-api/octopus.client). +For more information on using the Octopus.Client library see [Octopus.Client](/docs/api/octopus.client). diff --git a/src/pages/docs/administration/migrate-spaces-with-octoterra/index.md b/src/pages/docs/administration/migrate-spaces-with-octoterra/index.md index 69de04750e..c9c65c7695 100644 --- a/src/pages/docs/administration/migrate-spaces-with-octoterra/index.md +++ b/src/pages/docs/administration/migrate-spaces-with-octoterra/index.md @@ -93,8 +93,8 @@ These are the prerequisites for migrating an Octopus space with the Octoterra Wi - [Backup](https://octopus.com/docs/administration/data/backup-and-restore) your Octopus instance again before the migration. - Download the Octoterra Wizard from [GitHub](https://github.com/OctopusSolutionsEngineering/OctoterraWizard). - Install [Terraform](https://developer.hashicorp.com/terraform/install) on your local workstation. -- [Create an API key](https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key) for the source Octopus instance. -- [Create an API key](https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key) for the destination Octopus instance. +- [Create an API key](https://octopus.com/docs/api/authentication/create-an-api-key) for the source Octopus instance. +- [Create an API key](https://octopus.com/docs/api/authentication/create-an-api-key) for the destination Octopus instance. - Create a remote [Terraform backend](https://developer.hashicorp.com/terraform/language/settings/backends/configuration) to maintain the state of the Terraform resources. [AWS S3](https://developer.hashicorp.com/terraform/language/settings/backends/s3) and [Azure Storage Accounts](https://developer.hashicorp.com/terraform/language/settings/backends/azurerm) are supported. - Install any required local tools. See the "Local Tools vs Container Images" section for more details. @@ -336,7 +336,7 @@ Any firewall rules relating to the Octopus server must be updated to reflect the ### Regenerate API keys -Any external scripts and platforms to connect to the destination Octopus server must make use of a new [API key](https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key). +Any external scripts and platforms to connect to the destination Octopus server must make use of a new [API key](https://octopus.com/docs/api/authentication/create-an-api-key). ### Reconfigure polling tentacles diff --git a/src/pages/docs/administration/reporting/report-on-deployments-excel-template.md b/src/pages/docs/administration/reporting/report-on-deployments-excel-template.md index 93374ab121..230768a180 100644 --- a/src/pages/docs/administration/reporting/report-on-deployments-excel-template.md +++ b/src/pages/docs/administration/reporting/report-on-deployments-excel-template.md @@ -59,7 +59,7 @@ The best way to consume reporting data from Octopus is using the XML feed. The f Where: - `` is the hostname of your Octopus Server -- `` is one of [your API keys](/docs/octopus-rest-api/how-to-create-an-api-key) +- `` is one of [your API keys](/docs/api/authentication/create-an-api-key) For example: diff --git a/src/pages/docs/administration/reporting/report-on-deployments-using-excel.md b/src/pages/docs/administration/reporting/report-on-deployments-using-excel.md index 19ea0415b2..4922585de8 100644 --- a/src/pages/docs/administration/reporting/report-on-deployments-using-excel.md +++ b/src/pages/docs/administration/reporting/report-on-deployments-using-excel.md @@ -24,7 +24,7 @@ At a high-level, the steps are: Before we can report on the data using Excel, we need to export it in a format that Excel can import. The easiest way to do this is using an XML file. -Octopus exposes data on deployments through the `/api/reporting/deployments/xml` endpoint. You can use our [Octopus API clients](/docs/octopus-rest-api/getting-started#api-clients) to download the XML file. +Octopus exposes data on deployments through the `/api/reporting/deployments/xml` endpoint. You can use our [Octopus API clients](docs/api/#api-clients) to download the XML file.
PowerShell diff --git a/src/pages/docs/api-and-integration/api/how-to-create-an-api-key.md b/src/pages/docs/api-and-integration/api/how-to-create-an-api-key.md index 225c980a29..ac03e5207e 100644 --- a/src/pages/docs/api-and-integration/api/how-to-create-an-api-key.md +++ b/src/pages/docs/api-and-integration/api/how-to-create-an-api-key.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key +redirect: https://octopus.com/docs/api/authentication/create-an-api-key pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api-and-integration/examples/add-a-space-with-environments.md b/src/pages/docs/api-and-integration/examples/add-a-space-with-environments.md index 4ca533f3f3..acffb8170b 100644 --- a/src/pages/docs/api-and-integration/examples/add-a-space-with-environments.md +++ b/src/pages/docs/api-and-integration/examples/add-a-space-with-environments.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments +redirect: https://octopus.com/docs/api/examples/spaces/add-a-space-with-environments pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api-and-integration/examples/delete-a-space.md b/src/pages/docs/api-and-integration/examples/delete-a-space.md index c6529b8503..fe8bf0f75c 100644 --- a/src/pages/docs/api-and-integration/examples/delete-a-space.md +++ b/src/pages/docs/api-and-integration/examples/delete-a-space.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/spaces/delete-a-space +redirect: https://octopus.com/docs/api/examples/spaces/delete-a-space pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api-and-integration/examples/index.md b/src/pages/docs/api-and-integration/examples/index.md index e165e097c1..c053b4ce77 100644 --- a/src/pages/docs/api-and-integration/examples/index.md +++ b/src/pages/docs/api-and-integration/examples/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples +redirect: https://octopus.com/docs/api/examples pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api-and-integration/migration-api/index.md b/src/pages/docs/api-and-integration/migration-api/index.md index 2be7519959..1cbdc36cf9 100644 --- a/src/pages/docs/api-and-integration/migration-api/index.md +++ b/src/pages/docs/api-and-integration/migration-api/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/migration-api +redirect: https://octopus.com/docs/api/migration-api pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api-and-integration/octopus.client.md b/src/pages/docs/api-and-integration/octopus.client.md index db5d77a6c6..bc45ecc2ce 100644 --- a/src/pages/docs/api-and-integration/octopus.client.md +++ b/src/pages/docs/api-and-integration/octopus.client.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/octopus.client +redirect: https://octopus.com/docs/api/octopus.client pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/authentication/openid-connect/github-actions.md b/src/pages/docs/api/authentication/openid-connect/github-actions.md index f021b4d4f3..e8648bb028 100644 --- a/src/pages/docs/api/authentication/openid-connect/github-actions.md +++ b/src/pages/docs/api/authentication/openid-connect/github-actions.md @@ -12,7 +12,7 @@ hideInThisSection: true Octopus has first-class support for using OpenID Connect (OIDC) within GitHub Actions when using the [`OctopusDeploy/login`](https://github.com/OctopusDeploy/login) action. :::div{.hint} -Using OIDC to access the Octopus API is only supported for service accounts, to access the API for a user account please use [an API key](/docs/octopus-rest-api/how-to-create-an-api-key). +Using OIDC to access the Octopus API is only supported for service accounts, to access the API for a user account please use [an API key](/docs/api/authentication/create-an-api-key). ::: For more information on OIDC in GitHub Actions see [Security hardening with OpenID Connect](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect). diff --git a/src/pages/docs/api/authentication/openid-connect/index.md b/src/pages/docs/api/authentication/openid-connect/index.md index 87313cb6f6..aca674d199 100644 --- a/src/pages/docs/api/authentication/openid-connect/index.md +++ b/src/pages/docs/api/authentication/openid-connect/index.md @@ -31,14 +31,14 @@ Some of the benefits of using OIDC in Octopus include: - Access tokens are only issued for requests from trusted external systems, allowing for controlled access to service accounts and promoting using the principle of least access. :::div{.hint} -Using OIDC to access the Octopus API is only supported for service accounts, to access the API for a user account please use [an API key](/docs/octopus-rest-api/how-to-create-an-api-key). +Using OIDC to access the Octopus API is only supported for service accounts, to access the API for a user account please use [an API key](/docs/api/authentication/create-an-api-key). ::: Any issuer that can generate signed OIDC tokens which can be validated anonymously is supported, however first-class support for GitHub Actions is provided with the [`OctopusDeploy/login`](https://github.com/OctopusDeploy/login) action. ## Getting started with GitHub Actions -Follow the guide below to get started using OIDC with GitHub Actions. For more complex scenarios, or for a full list of available options, see [Using OpenID Connect with Octopus and GitHub Actions](/docs/octopus-rest-api/openid-connect/github-actions). +Follow the guide below to get started using OIDC with GitHub Actions. For more complex scenarios, or for a full list of available options, see [Using OpenID Connect with Octopus and GitHub Actions](/docs/api/openid-connect/github-actions). ### Create an OIDC identity for a service account @@ -114,7 +114,7 @@ jobs: ## Getting started with other issuers -Follow the guide below to get started using OIDC with other issuers. For more complex scenarios, or for a full list of available options, see [Using OpenID Connect with Other Issuers](/docs/octopus-rest-api/openid-connect/other-issuers). +Follow the guide below to get started using OIDC with other issuers. For more complex scenarios, or for a full list of available options, see [Using OpenID Connect with Other Issuers](/docs/api/openid-connect/other-issuers). ### Create an OIDC identity for a service account @@ -150,7 +150,7 @@ A Service Account Id will be shown, this will be a GUID which must be supplied a 1. Obtain an OIDC token from the issuer, the `aud` claim must be the Service Account Id. The process for obtaining the OIDC token from the issuer will differ by issuer, please consult your OIDC issuers documentation. 2. Get the token exchange endpoint for your Octopus server from the `token_endpoint` property of the OpenID Connect Discovery endpoint `https://my-octopus-server.com/.well-known/openid-configuration`. -3. Exchange the OIDC token for an Octopus access token, setting `audience` property to the Service Account Id from above. See [Exchanging an OIDC token for an Octopus access token](/docs/octopus-rest-api/openid-connect/other-issuers#OidcOtherIssuers-TokenExchange) for more details on the token exchange request. +3. Exchange the OIDC token for an Octopus access token, setting `audience` property to the Service Account Id from above. See [Exchanging an OIDC token for an Octopus access token](/docs/api/openid-connect/other-issuers#OidcOtherIssuers-TokenExchange) for more details on the token exchange request. 4. Get the `access_token` from the token exchange response. ### Using the access token to access the Octopus API @@ -191,7 +191,7 @@ If you are encountering issues using OIDC validating identity tokens from your O - The audience must be the id of the service account and will be a GUID. - The issuer must be a URL using the HTTPS scheme. - The subject must match the configured subject on the OIDC identity and is *case-sensitive*. Support is available to include wildcard characters in the subject using `*` and `?` for multiple and single character matches respectively. -- If you are making the token exchange request manually (e.g. using an [issuer other than GitHub Actions](/docs/octopus-rest-api/openid-connect/other-issuers)), check that the required fields are set correctly. See [Exchanging an OIDC token for an Octopus access token](/docs/octopus-rest-api/openid-connect/other-issuers#OidcOtherIssuers-TokenExchange) for more information on the request format. +- If you are making the token exchange request manually (e.g. using an [issuer other than GitHub Actions](/docs/api/openid-connect/other-issuers)), check that the required fields are set correctly. See [Exchanging an OIDC token for an Octopus access token](/docs/api/openid-connect/other-issuers#OidcOtherIssuers-TokenExchange) for more information on the request format. - Check that the token has not expired (`exp`). Often identity tokens created by OIDC providers will have a short lifetime. - Check that the token is signed by a valid key from the issuer. Signing keys may be invalidated by providers under some circumstances. - Check that the public key used to sign the token are available using [OpenID discovery](https://openid.net/specs/openid-connect-discovery-1_0.html). diff --git a/src/pages/docs/api/authentication/openid-connect/other-issuers.md b/src/pages/docs/api/authentication/openid-connect/other-issuers.md index ae635807bb..653ccf9a97 100644 --- a/src/pages/docs/api/authentication/openid-connect/other-issuers.md +++ b/src/pages/docs/api/authentication/openid-connect/other-issuers.md @@ -12,7 +12,7 @@ hideInThisSection: true Octopus supports using OpenID Connect for any external system that can issue a signed OIDC token which can be validated anonymously via an HTTPS endpoint. :::div{.hint} -Using OIDC to access the Octopus API is only supported for service accounts, to access the API for a user account please use [an API key](/docs/octopus-rest-api/how-to-create-an-api-key). +Using OIDC to access the Octopus API is only supported for service accounts, to access the API for a user account please use [an API key](/docs/api/authentication/create-an-api-key). ::: ## Configuring an OIDC identity diff --git a/src/pages/docs/api/examples/add-a-space-with-environments.md b/src/pages/docs/api/examples/add-a-space-with-environments.md index 4ca533f3f3..acffb8170b 100644 --- a/src/pages/docs/api/examples/add-a-space-with-environments.md +++ b/src/pages/docs/api/examples/add-a-space-with-environments.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/spaces/add-a-space-with-environments +redirect: https://octopus.com/docs/api/examples/spaces/add-a-space-with-environments pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/add-azure-web-app.md b/src/pages/docs/api/examples/add-azure-web-app.md index 27e121a4c7..9a3e66be93 100644 --- a/src/pages/docs/api/examples/add-azure-web-app.md +++ b/src/pages/docs/api/examples/add-azure-web-app.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployment-targets/add-azure-web-app +redirect: https://octopus.com/docs/api/examples/deployment-targets/add-azure-web-app pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/add-environment-to-step.md b/src/pages/docs/api/examples/add-environment-to-step.md index 88f7036dc1..9eeb47c1a3 100644 --- a/src/pages/docs/api/examples/add-environment-to-step.md +++ b/src/pages/docs/api/examples/add-environment-to-step.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployment-process/add-environment-to-step +redirect: https://octopus.com/docs/api/examples/deployment-process/add-environment-to-step pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/cancel-queued-deployments.md b/src/pages/docs/api/examples/cancel-queued-deployments.md index 511e3b56b7..384d909869 100644 --- a/src/pages/docs/api/examples/cancel-queued-deployments.md +++ b/src/pages/docs/api/examples/cancel-queued-deployments.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployments/cancel-queued-deployments +redirect: https://octopus.com/docs/api/examples/deployments/cancel-queued-deployments pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/change-machine-machinepolicy.md b/src/pages/docs/api/examples/change-machine-machinepolicy.md index 8655321513..82a080f62c 100644 --- a/src/pages/docs/api/examples/change-machine-machinepolicy.md +++ b/src/pages/docs/api/examples/change-machine-machinepolicy.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployment-targets/change-target-machinepolicy +redirect: https://octopus.com/docs/api/examples/deployment-targets/change-target-machinepolicy pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/create-and-deploy-a-release.md b/src/pages/docs/api/examples/create-and-deploy-a-release.md index 53429e8665..2d1de06802 100644 --- a/src/pages/docs/api/examples/create-and-deploy-a-release.md +++ b/src/pages/docs/api/examples/create-and-deploy-a-release.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployments/create-and-deploy-a-release +redirect: https://octopus.com/docs/api/examples/deployments/create-and-deploy-a-release pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/create-azure-service-principal.md b/src/pages/docs/api/examples/create-azure-service-principal.md index 3f229d221f..d33cb9475a 100644 --- a/src/pages/docs/api/examples/create-azure-service-principal.md +++ b/src/pages/docs/api/examples/create-azure-service-principal.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/accounts/create-azure-service-principal +redirect: https://octopus.com/docs/api/examples/accounts/create-azure-service-principal pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/create-certificate.md b/src/pages/docs/api/examples/create-certificate.md index 404ce23865..3b5e7b6472 100644 --- a/src/pages/docs/api/examples/create-certificate.md +++ b/src/pages/docs/api/examples/create-certificate.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/certificates/create-certificate +redirect: https://octopus.com/docs/api/examples/certificates/create-certificate pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/create-project.md b/src/pages/docs/api/examples/create-project.md index 664116d3ef..947e601099 100644 --- a/src/pages/docs/api/examples/create-project.md +++ b/src/pages/docs/api/examples/create-project.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/projects/create-project +redirect: https://octopus.com/docs/api/examples/projects/create-project pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/create-runbook.md b/src/pages/docs/api/examples/create-runbook.md index 1d0431b831..8518cd8f86 100644 --- a/src/pages/docs/api/examples/create-runbook.md +++ b/src/pages/docs/api/examples/create-runbook.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/runbooks/create-runbook +redirect: https://octopus.com/docs/api/examples/runbooks/create-runbook pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/create-script-step.md b/src/pages/docs/api/examples/create-script-step.md index 997b45d8de..749c4174e9 100644 --- a/src/pages/docs/api/examples/create-script-step.md +++ b/src/pages/docs/api/examples/create-script-step.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployment-process/create-script-step +redirect: https://octopus.com/docs/api/examples/deployment-process/create-script-step pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/delete-a-space.md b/src/pages/docs/api/examples/delete-a-space.md index c6529b8503..fe8bf0f75c 100644 --- a/src/pages/docs/api/examples/delete-a-space.md +++ b/src/pages/docs/api/examples/delete-a-space.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/spaces/delete-a-space +redirect: https://octopus.com/docs/api/examples/spaces/delete-a-space pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/delete-machines-by-role.md b/src/pages/docs/api/examples/delete-machines-by-role.md index 0c5b670127..45ffdccd15 100644 --- a/src/pages/docs/api/examples/delete-machines-by-role.md +++ b/src/pages/docs/api/examples/delete-machines-by-role.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployment-targets/delete-machines-by-role +redirect: https://octopus.com/docs/api/examples/deployment-targets/delete-machines-by-role pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/delete-project-releases.md b/src/pages/docs/api/examples/delete-project-releases.md index 68c7c543f8..99d6890c45 100644 --- a/src/pages/docs/api/examples/delete-project-releases.md +++ b/src/pages/docs/api/examples/delete-project-releases.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/releases/delete-project-releases +redirect: https://octopus.com/docs/api/examples/releases/delete-project-releases pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/feeds/get-feeds.md b/src/pages/docs/api/examples/feeds/get-feeds.md index c5b466199f..93bfb65d05 100644 --- a/src/pages/docs/api/examples/feeds/get-feeds.md +++ b/src/pages/docs/api/examples/feeds/get-feeds.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/feeds/retrieve-feeds +redirect: https://octopus.com/docs/api/examples/feeds/retrieve-feeds pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/get-steps-using-role.md b/src/pages/docs/api/examples/get-steps-using-role.md index 5ae81249aa..243dc082e4 100644 --- a/src/pages/docs/api/examples/get-steps-using-role.md +++ b/src/pages/docs/api/examples/get-steps-using-role.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployment-process/get-steps-using-role +redirect: https://octopus.com/docs/api/examples/deployment-process/get-steps-using-role pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/index.md b/src/pages/docs/api/examples/index.md index 05c88fa8f2..bb11e0f1a5 100644 --- a/src/pages/docs/api/examples/index.md +++ b/src/pages/docs/api/examples/index.md @@ -21,7 +21,7 @@ In addition, we also have a wide range of some of the more common examples here ## Using the scripts -To use the example scripts, you'll need to provide your Octopus Server URL and an [API Key](/docs/octopus-rest-api/how-to-create-an-api-key). There may be other values that need to be updated to fit your scenario such as Space, Project, and Environment names. +To use the example scripts, you'll need to provide your Octopus Server URL and an [API Key](/docs/api/authentication/create-an-api-key). There may be other values that need to be updated to fit your scenario such as Space, Project, and Environment names. :::div{.hint} **The examples provided are for reference and should be modified and tested prior to using in a production Octopus instance.** @@ -33,7 +33,7 @@ The C# examples are written using [dotnet script](https://github.com/filipw/dotn ### Octopus.Client examples -Examples using [Octopus.Client](/docs/octopus-rest-api/octopus.client) require the library to be installed and a path to the library to be provided. +Examples using [Octopus.Client](/docs/api/octopus.client) require the library to be installed and a path to the library to be provided. ### Python examples diff --git a/src/pages/docs/api/examples/list-users-with-role.md b/src/pages/docs/api/examples/list-users-with-role.md index 5ead862cf1..c8d714c586 100644 --- a/src/pages/docs/api/examples/list-users-with-role.md +++ b/src/pages/docs/api/examples/list-users-with-role.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role +redirect: https://octopus.com/docs/api/examples/users-and-teams/list-users-with-role pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/publish-runbook.md b/src/pages/docs/api/examples/publish-runbook.md index 685b8a5f22..4b0116aff6 100644 --- a/src/pages/docs/api/examples/publish-runbook.md +++ b/src/pages/docs/api/examples/publish-runbook.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/runbooks/publish-runbook +redirect: https://octopus.com/docs/api/examples/runbooks/publish-runbook pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/register-listening-tentacle.md b/src/pages/docs/api/examples/register-listening-tentacle.md index 0f27819d3d..ea62650da1 100644 --- a/src/pages/docs/api/examples/register-listening-tentacle.md +++ b/src/pages/docs/api/examples/register-listening-tentacle.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployment-targets/register-listening-tentacle +redirect: https://octopus.com/docs/api/examples/deployment-targets/register-listening-tentacle pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/register-polling-tentacle.md b/src/pages/docs/api/examples/register-polling-tentacle.md index 51bedb4469..fcb630adfe 100644 --- a/src/pages/docs/api/examples/register-polling-tentacle.md +++ b/src/pages/docs/api/examples/register-polling-tentacle.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/deployment-targets/register-polling-tentacle +redirect: https://octopus.com/docs/api/examples/deployment-targets/register-polling-tentacle pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/replace-certificate.md b/src/pages/docs/api/examples/replace-certificate.md index 9dc542eeea..2e46978b49 100644 --- a/src/pages/docs/api/examples/replace-certificate.md +++ b/src/pages/docs/api/examples/replace-certificate.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/certificates/replace-certificate +redirect: https://octopus.com/docs/api/examples/certificates/replace-certificate pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/run-runbook.md b/src/pages/docs/api/examples/run-runbook.md index 861c0cc71c..bec063e988 100644 --- a/src/pages/docs/api/examples/run-runbook.md +++ b/src/pages/docs/api/examples/run-runbook.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/runbooks/run-runbook +redirect: https://octopus.com/docs/api/examples/runbooks/run-runbook pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/tenants/bulk-add-projects-to-tenants.md b/src/pages/docs/api/examples/tenants/bulk-add-projects-to-tenants.md index ba690fe6a5..99afcc2f12 100644 --- a/src/pages/docs/api/examples/tenants/bulk-add-projects-to-tenants.md +++ b/src/pages/docs/api/examples/tenants/bulk-add-projects-to-tenants.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/bulk-operations/bulk-add-projects-to-tenants +redirect: https://octopus.com/docs/api/examples/bulk-operations/bulk-add-projects-to-tenants pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/users-and-teams/create-api-key.mdx b/src/pages/docs/api/examples/users-and-teams/create-api-key.mdx index 96035312ad..bda92a41e1 100644 --- a/src/pages/docs/api/examples/users-and-teams/create-api-key.mdx +++ b/src/pages/docs/api/examples/users-and-teams/create-api-key.mdx @@ -10,7 +10,7 @@ import CreateApiKeyScripts from 'src/shared-content/scripts/create-api-key-scrip This script demonstrates how to programmatically create a new API Key. :::div{.warning} -**Note:** You can only create a new API Key for your own user account. You will also need an existing API Key to authenticate with the Octopus REST API, created from the [Octopus Web Portal](/docs/octopus-rest-api/how-to-create-an-api-key). +**Note:** You can only create a new API Key for your own user account. You will also need an existing API Key to authenticate with the Octopus REST API, created from the [Octopus Web Portal](/docs/api/authentication/create-an-api-key). ::: ## Usage diff --git a/src/pages/docs/api/examples/users/index.md b/src/pages/docs/api/examples/users/index.md index da640746c0..9ff254bbdf 100644 --- a/src/pages/docs/api/examples/users/index.md +++ b/src/pages/docs/api/examples/users/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/users-and-teams +redirect: https://octopus.com/docs/api/examples/users-and-teams pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/users/list-users-with-role.md b/src/pages/docs/api/examples/users/list-users-with-role.md index 5ead862cf1..c8d714c586 100644 --- a/src/pages/docs/api/examples/users/list-users-with-role.md +++ b/src/pages/docs/api/examples/users/list-users-with-role.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/users-and-teams/list-users-with-role +redirect: https://octopus.com/docs/api/examples/users-and-teams/list-users-with-role pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/examples/variables/find-variable-vaule-usage.md b/src/pages/docs/api/examples/variables/find-variable-vaule-usage.md index b9b97ad348..f46dbbccea 100644 --- a/src/pages/docs/api/examples/variables/find-variable-vaule-usage.md +++ b/src/pages/docs/api/examples/variables/find-variable-vaule-usage.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples/variables/find-variable-value-usage +redirect: https://octopus.com/docs/api/examples/variables/find-variable-value-usage pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/api/octopus.client/using-client-directly.md b/src/pages/docs/api/octopus.client/using-client-directly.md index 5771422cc5..004ee9a987 100644 --- a/src/pages/docs/api/octopus.client/using-client-directly.md +++ b/src/pages/docs/api/octopus.client/using-client-directly.md @@ -7,7 +7,7 @@ description: How to use the IOctopusClient type in the Octopus.Client library. navOrder: 30 --- -For some operations not available through [repositories](/docs/octopus-rest-api/octopus.client/using-resources), it will be necessary to use the `IOctopusClient` type: +For some operations not available through [repositories](/docs/api/octopus.client/using-resources), it will be necessary to use the `IOctopusClient` type:
PowerShell diff --git a/src/pages/docs/argo-cd/instances/automated-installation.md b/src/pages/docs/argo-cd/instances/automated-installation.md index faba3aed43..5ffe0353a3 100644 --- a/src/pages/docs/argo-cd/instances/automated-installation.md +++ b/src/pages/docs/argo-cd/instances/automated-installation.md @@ -177,7 +177,7 @@ The application YAML required to install the helm chart is as follows (replacing ``` 3. Generate Octopus Deploy Api-Key - 3.1. Follow the instructions on the [How to Create an API Key](/docs/octopus-rest-api/how-to-create-an-api-key) guide + 3.1. Follow the instructions on the [How to Create an API Key](/docs/api/authentication/create-an-api-key) guide 3.2. Save the token in a secret ```shell diff --git a/src/pages/docs/best-practices/octopus-administration/users-roles-and-teams.md b/src/pages/docs/best-practices/octopus-administration/users-roles-and-teams.md index bb08245eed..d53231dd88 100644 --- a/src/pages/docs/best-practices/octopus-administration/users-roles-and-teams.md +++ b/src/pages/docs/best-practices/octopus-administration/users-roles-and-teams.md @@ -32,7 +32,7 @@ We also recommend creating a unique service account per integration. For exampl ## API keys -[API Keys](/docs/octopus-rest-api/how-to-create-an-api-key/) allow you, or the service account, to access the [Octopus Deploy REST API](/docs/octopus-rest-api). API keys for users should be kept to a minimum, if a key was ever shared, then anyone can impersonate that user. Only use API keys for service accounts for any external integrations. +[API Keys](/docs/api/authentication/create-an-api-key/) allow you, or the service account, to access the [Octopus Deploy REST API](/docs/octopus-rest-api). API keys for users should be kept to a minimum, if a key was ever shared, then anyone can impersonate that user. Only use API keys for service accounts for any external integrations. **Octopus Deploy 2020.6** introduced the concept of expiring API keys. Our recommendation is to set up a periodic rotation of API keys following your companies policy on key expiration. diff --git a/src/pages/docs/best-practices/platform-engineering/managing-project-resources.md b/src/pages/docs/best-practices/platform-engineering/managing-project-resources.md index 8e5ec6a960..aa593a75f2 100644 --- a/src/pages/docs/best-practices/platform-engineering/managing-project-resources.md +++ b/src/pages/docs/best-practices/platform-engineering/managing-project-resources.md @@ -159,7 +159,7 @@ The steps documented below are best run on the `Hosted Ubuntu` worker pools for 1. Tick the `Ignore All Changes` option to instruct Terraform to ignore any changes made to a project through the UI using the [lifecycle meta-argument](https://developer.hashicorp.com/terraform/language/meta-arguments/lifecycle). This option is most useful when [RBAC controls](/docs/getting-started/best-practices/users-roles-and-teams) allow customers to edit the variables of a project managed by Terraform but not edit the project steps or other settings. This allows platform teams to treat entire projects much like [step templates](/docs/projects/custom-step-templates), where end users can edit parameters but not touch the configuration of the steps, but in this case the project variables can be edited but the project steps can not. 2. Set the `Terraform Backend` field to the [backend](https://developer.hashicorp.com/terraform/language/settings/backends/configuration) configured in the exported module. The step defaults to `s3`, which uses an S3 bucket to store Terraform state. However, any backend provider can be defined here. 3. Set the `Octopus Server URL` field to the URL of the Octopus server to export a space from. The default value of `#{Octopus.Web.ServerUri}` references the URL of the current Octopus instance. - 4. Set the `Octopus API Key` field to the [API key](/docs/octopus-rest-api/how-to-create-an-api-key) used to access the instance defined in the `Octopus Server URL` field. + 4. Set the `Octopus API Key` field to the [API key](/docs/api/authentication/create-an-api-key) used to access the instance defined in the `Octopus Server URL` field. 5. Set the `Octopus Space ID` field to the ID of the space to be exported. The default value of `#{Octopus.Space.Id}` references the current space. 6. Set the `Octopus Project Name` field to the name of the project to serialize. The default value of `#{Octopus.Project.Name}` assumes the runbook has been defined in the same project that is being exported. 7. Set the `Octopus Upload Space ID` field to the ID of another space to upload the resulting Terraform module zip file to the built-in feed of that space. Leave this field blank to upload the zip file to the built-in feed of the current space. @@ -187,7 +187,7 @@ The following steps create a project in an existing space with the Terraform mod 2. Set the `Terraform Workspace` field to a [workspace](https://developer.hashicorp.com/terraform/language/state/workspaces) that maintains the state of Octopus resources created by Terraform. The default value of `#{OctoterraApply.Octopus.SpaceID}` uses a workspace based on the ID of the space that is being populated. Leave the default value unless you have a specific reason to change it. 3. Select the package created by the export process in the previous section in the `Terraform Module Package` field. The package name is the same as the exported project name, with all non-alphanumeric characters replaced with an underscore. 4. Set the `Octopus Server URL` field to the URL of the Octopus server to create the new project in. The default value of `#{Octopus.Web.ServerUri}` references the URL of the current Octopus instance. - 5. Set the `Octopus API Key` field to the [API key](/docs/octopus-rest-api/how-to-create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. + 5. Set the `Octopus API Key` field to the [API key](/docs/api/authentication/create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. 6. Set the `Octopus Space ID` field to the ID of an existing space where the project will be created. 7. Set the `Terraform Additional Apply Params` field to a list of additional arguments to pass to the `terraform apply` command. This field is typically used to define the value of secrets such as secret variables e.g. `-var=eks_octopub_frontend_my_secret_1=TheSecretValue`. It is also useful to override the Git repository for a CaC enabled project, as [projects can not share Git repositories](/docs/projects/version-control/config-as-code-reference) e.g. `-var=project_frontend_webapp_git_url=http://github.com/username/project`. 8. Set the `Terraform Additional Init Params` field to a list of additional arguments to pass to the `terraform init` command. Leave this field blank unless you have a specific reason to pass an argument to Terraform. diff --git a/src/pages/docs/best-practices/platform-engineering/managing-runbook-resources.md b/src/pages/docs/best-practices/platform-engineering/managing-runbook-resources.md index ee7fb4ec22..7a6b340028 100644 --- a/src/pages/docs/best-practices/platform-engineering/managing-runbook-resources.md +++ b/src/pages/docs/best-practices/platform-engineering/managing-runbook-resources.md @@ -47,7 +47,7 @@ The steps documented below are best run on the `Hosted Ubuntu` worker pools for 1. Tick the `Ignore All Changes` option to instruct Terraform to ignore any changes made to a project through the UI using the [lifecycle meta-argument](https://developer.hashicorp.com/terraform/language/meta-arguments/lifecycle). Enabling this option allows the runbook to be edited via the UI once it is deployed and Terraform will not overwrite those changes when reapplying the module. Leave the option disabled to have Terraform overwrite any changes to the downstream runbook when the module is reapplied. 2. Set the `Terraform Backend` field to the [backend](https://developer.hashicorp.com/terraform/language/settings/backends/configuration) configured in the exported module. The step defaults to `s3`, which uses an S3 bucket to store Terraform state. However, any backend provider can be defined here. 3. Set the `Octopus Server URL` field to the URL of the Octopus server to export a space from. The default value of `#{Octopus.Web.ServerUri}` references the URL of the current Octopus instance. - 4. Set the `Octopus API Key` field to the [API key](/docs/octopus-rest-api/how-to-create-an-api-key) used to access the instance defined in the `Octopus Server URL` field. + 4. Set the `Octopus API Key` field to the [API key](/docs/api/authentication/create-an-api-key) used to access the instance defined in the `Octopus Server URL` field. 5. Set the `Octopus Space ID` field to the ID of the space to be exported. The default value of `#{Octopus.Space.Id}` references the current space. 6. Set the `Octopus Project Name` field to the name of the project that contains the runbook to be exported. The default value of `#{Octopus.Project.Name}` references the current project. 7. Set the `Octopus Runbook Name` field to the name of the runbook to serialize. @@ -81,7 +81,7 @@ The following steps create a runbook in an existing project with the Terraform m 2. Set the `Terraform Workspace` field to a [workspace](https://developer.hashicorp.com/terraform/language/state/workspaces) that maintains the state of Octopus resources created by Terraform. The default value of `#{OctoterraApply.Octopus.SpaceID}_#{OctoterraApply.Octopus.Project | Replace "[^A-Za-z0-9]" "_"}` uses a workspace based on the ID of the space and the name of the project that is being populated. Leave the default value unless you have a specific reason to change it. 3. Select the package created by the export process in the previous section in the `Terraform Module Package` field. The package name is the same as the exported runbook name, with all non-alphanumeric characters replaced with an underscore. 4. Set the `Octopus Server URL` field to the URL of the Octopus server to create the new project in. The default value of `#{Octopus.Web.ServerUri}` references the URL of the current Octopus instance. - 5. Set the `Octopus API Key` field to the [API key](/docs/octopus-rest-api/how-to-create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. + 5. Set the `Octopus API Key` field to the [API key](/docs/api/authentication/create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. 6. Set the `Octopus Space ID` field to the ID of an existing space where the project will be created. 7. Set the `Octopus Project Name` field to the name of the project to deploy the runbook into. 8. Set the `Terraform Additional Apply Params` field to a list of additional arguments to pass to the `terraform apply` command. This field is typically used to override the name of the runbook e.g. `"-var=runbook_eks_octopub_audits____describe_pods_name=The New Runbook Name"`. Leave this field blank if you do not wish to customize the deployed runbook. diff --git a/src/pages/docs/best-practices/platform-engineering/managing-space-resources.md b/src/pages/docs/best-practices/platform-engineering/managing-space-resources.md index f72e83b2e5..10a9801676 100644 --- a/src/pages/docs/best-practices/platform-engineering/managing-space-resources.md +++ b/src/pages/docs/best-practices/platform-engineering/managing-space-resources.md @@ -58,7 +58,7 @@ The following process serializes a space to a Terraform module: 2. Add the `Octopus - Serialize Space to Terraform` step from the [community step template library](/docs/projects/community-step-templates). 1. Set the `Terraform Backend` field to the [backend](https://developer.hashicorp.com/terraform/language/settings/backends/configuration) configured in the exported module. The step defaults to `s3`, which uses an S3 bucket to store Terraform state. However, any backend provider can be defined here. 2. Set the `Octopus Server URL` field to the URL of the Octopus server to export a space from. The default value of `#{Octopus.Web.ServerUri}` references the URL of the current Octopus instance. - 3. Set the `Octopus API Key` field to the [API key](/docs/octopus-rest-api/how-to-create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. + 3. Set the `Octopus API Key` field to the [API key](/docs/api/authentication/create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. 4. Set the `Octopus Space ID` field to the ID of the space to be exported. The default value of `#{Octopus.Space.Id}` references the current space. 5. Set the `Octopus Upload Space ID` field to the ID of another space to upload the resulting Terraform module zip file to the built-in feed of that space. Leave this field blank to upload the zip file to the built-in feed of the current space. 6. Set the `Ignored Variables Sets` field to a comma separated list of variable sets to exclude from the Terraform module. Typically, this field is used when the values of the previous fields were sourced from a variable set that should not be exported. @@ -94,7 +94,7 @@ The following process creates and populates a space with the Terraform module ex 4. Set the `Terraform Workspace` field to a [workspace](https://developer.hashicorp.com/terraform/language/state/workspaces) that tracks the new space. The default value of `#{OctoterraApply.Octopus.Space.NewName | Replace "[^A-Za-z0-9]" "_"}` creates a workspace name based on the space name with all non-alphanumeric characters replaced with an underscore. Leave the default value unless you have a specific reason to change it. 5. Select the package created by the export process in the previous section in the `Terraform Module Package` field. The package name is the same as the exported space name, with all non-alphanumeric characters replaced with an underscore. 6. Set the `Octopus Server URL` field to the URL of the Octopus server to create the new space in. The default value of `#{Octopus.Web.ServerUri}` references the URL of the current Octopus instance. - 7. Set the `Octopus API Key` field to the [API key](/docs/octopus-rest-api/how-to-create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. + 7. Set the `Octopus API Key` field to the [API key](/docs/api/authentication/create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. 8. Set the `Terraform Additional Apply Params` field to a list of additional arguments to pass to the `terraform apply` command. This field is typically used to define the value of any Terraform variables. However, there are no variables that need to be defined when creating a space, so leave this field blank unless you have a specific reason to pass an argument to Terraform. 9. Set the `Terraform Additional Init Params` field to a list of additional arguments to pass to the `terraform init` command. Leave this field blank unless you have a specific reason to pass an argument to Terraform. 10. Each `Octopus - Create Octoterra Space` step exposes values relating to their specific Terraform backend that must be configured. For example, the `Octopus - Create Octoterra Space (S3 Backend)` step exposes fields to configure the S3 bucket, key, and region where the Terraform state is saved. Other steps have similar fields. @@ -103,7 +103,7 @@ The following process creates and populates a space with the Terraform module ex 2. Set the `Terraform Workspace` field to a [workspace](https://developer.hashicorp.com/terraform/language/state/workspaces) that tracks the new space. The default value of `#{OctoterraApply.Octopus.SpaceID}` creates a workspace name based on the ID of the space that is being populated. Leave the default value unless you have a specific reason to change it. 3. Select the package created by the export process in the previous section in the `Terraform Module Package` field. The package name is the same as the exported space name, with all non-alphanumeric characters replaced with an underscore. 4. Set the `Octopus Server URL` field to the URL of the Octopus server to create the new space in. The default value of `#{Octopus.Web.ServerUri}` references the URL of the current Octopus instance. - 5. Set the `Octopus API Key` field to the [API key](/docs/octopus-rest-api/how-to-create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. + 5. Set the `Octopus API Key` field to the [API key](/docs/api/authentication/create-an-api-key) used when accessing the instance defined in the `Octopus Server URL` field. 6. Set the `Octopus Space ID` field to the ID of the space created by the previous step. The ID is an output variable that can be access with an [octostache template](/docs/projects/variables/variable-substitutions) like `#{Octopus.Action[Octopus - Create Octoterra Space (S3 Backend)].Output.TerraformValueOutputs[octopus_space_id]}`. Note that the name of the previous step may need to be changed from `Octopus - Create Octoterra Space (S3 Backend)` if your step has a different name. 7. Set the `Terraform Additional Apply Params` field to a list of additional arguments to pass to the `terraform apply` command. This field is typically used to define the value of secrets such as account or feed passwords e.g. `-var=account_aws_account=TheAwsSecretKey`. 8. Set the `Terraform Additional Init Params` field to a list of additional arguments to pass to the `terraform init` command. Leave this field blank unless you have a specific reason to pass an argument to Terraform. diff --git a/src/pages/docs/deployments/databases/sql-server/redgate.md b/src/pages/docs/deployments/databases/sql-server/redgate.md index e4234d76ed..7da1296c43 100644 --- a/src/pages/docs/deployments/databases/sql-server/redgate.md +++ b/src/pages/docs/deployments/databases/sql-server/redgate.md @@ -91,7 +91,7 @@ The Octopus Server will attempt to connect to the Tentacle. The listening Tenta The process to register Polling Tentacles as workers takes place in the **Tentacle Manager** on the server hosting the Tentacle. Select the polling Tentacle to get started with the wizard. -On the credentials screen enter a username and password or the [API key](/docs/octopus-rest-api/how-to-create-an-api-key) of a user who has permissions to add worker pools. This account will only be used for registration. +On the credentials screen enter a username and password or the [API key](/docs/api/authentication/create-an-api-key) of a user who has permissions to add worker pools. This account will only be used for registration. :::div{.info} The registration process will connect to the RESTful API of the Octopus Server. It will connect over port 80 or 443 using the http/https protocol. After registration the default port the Tentacle will connect to is port 10943. diff --git a/src/pages/docs/deployments/node-js/node-on-linux.md b/src/pages/docs/deployments/node-js/node-on-linux.md index 0c1848b845..9e91395411 100644 --- a/src/pages/docs/deployments/node-js/node-on-linux.md +++ b/src/pages/docs/deployments/node-js/node-on-linux.md @@ -133,7 +133,7 @@ npm install npm install --save-dev gulp-bump @octopusdeploy/gulp-octo ``` -Modify the **gulpfile.js** file to add the following gulp tasks. Substitute the correct **host** address for your Octopus Server and an **apiKey**. See [how to create an API Key](/docs/octopus-rest-api/how-to-create-an-api-key). +Modify the **gulpfile.js** file to add the following gulp tasks. Substitute the correct **host** address for your Octopus Server and an **apiKey**. See [how to create an API Key](/docs/api/authentication/create-an-api-key). ```js var bump = require('gulp-bump'); @@ -181,7 +181,7 @@ npm install npm install --save-dev grunt-bump grunt-contrib-clean @octopusdeploy/grunt-octo ``` -Modify the **gruntfile.js** file to add the following grunt tasks. Substitute the correct **host** address for your Octopus Server and an **apiKey**. See [how to create an API Key](/docs/octopus-rest-api/how-to-create-an-api-key). +Modify the **gruntfile.js** file to add the following grunt tasks. Substitute the correct **host** address for your Octopus Server and an **apiKey**. See [how to create an API Key](/docs/api/authentication/create-an-api-key). ```js grunt.initConfig({ diff --git a/src/pages/docs/deployments/patterns/elastic-and-transient-environments/keeping-deployment-targets-up-to-date.md b/src/pages/docs/deployments/patterns/elastic-and-transient-environments/keeping-deployment-targets-up-to-date.md index 06ed4e50cd..ef8c6d87f2 100644 --- a/src/pages/docs/deployments/patterns/elastic-and-transient-environments/keeping-deployment-targets-up-to-date.md +++ b/src/pages/docs/deployments/patterns/elastic-and-transient-environments/keeping-deployment-targets-up-to-date.md @@ -60,7 +60,7 @@ To test the trigger, we will disable a deployment target, deploy to that target' ## Overriding the release used for automatic deployments {#override-release-for-automatic-deployments} -Automatic deployments attempts to calculate the release to use for a project and environment (using the *current* and *successful* release that has been deployed, as shown in your Project Overview dashboard). In some cases the calculated release may not be the release that should be automatically deployed, or Octopus may not be able to find a deployment for an environment (maybe you have a release, but have not yet deployed it anywhere). It is possible to explicitly set the release that should be automatically deployed by overriding the automatic-deployment-release. Overrides can be configured using the [Octopus CLI](/docs/cli/octopus-cli/) or through [Octopus.Client](/docs/octopus-rest-api/octopus.client). Overrides define a release for a project when deploying to an environment (this can, for example, be useful for cloud-testing-automation when standing up new cloud infrastructure). For multi-tenanted deployments, overrides may be configured for each environment/tenant combination. +Automatic deployments attempts to calculate the release to use for a project and environment (using the *current* and *successful* release that has been deployed, as shown in your Project Overview dashboard). In some cases the calculated release may not be the release that should be automatically deployed, or Octopus may not be able to find a deployment for an environment (maybe you have a release, but have not yet deployed it anywhere). It is possible to explicitly set the release that should be automatically deployed by overriding the automatic-deployment-release. Overrides can be configured using the [Octopus CLI](/docs/cli/octopus-cli/) or through [Octopus.Client](/docs/api/octopus.client). Overrides define a release for a project when deploying to an environment (this can, for example, be useful for cloud-testing-automation when standing up new cloud infrastructure). For multi-tenanted deployments, overrides may be configured for each environment/tenant combination. **Octopus.Client** diff --git a/src/pages/docs/getting-started/reference-architectures/eks-reference-architecture.md b/src/pages/docs/getting-started/reference-architectures/eks-reference-architecture.md index 4a58a6e8b2..46b377b1e2 100644 --- a/src/pages/docs/getting-started/reference-architectures/eks-reference-architecture.md +++ b/src/pages/docs/getting-started/reference-architectures/eks-reference-architecture.md @@ -24,7 +24,7 @@ The step exposes a number of options, typically requesting credentials to the va - `AWS Access Key` and `AWS Secret Key` require the [access keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) of the user that will create the EKS cluster. - `Docker Hub Username` and `Docker Hub Password` require the credentials of a [Docker Hub user](https://docs.docker.com/docker-id/) that is used to access sample Docker images from public DockerHub repositories. These credentials are also used by a sample GitHub Actions workflow that publishes Docker images. - `GitHub Access Token` requires the [GitHub access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) of a user that is used to create a new GitHub repository holding a sample application. -- `Octopus API Key` requires an [API key](https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key) to the Octopus instance where the reference architecture projects and supporting resources are created. +- `Octopus API Key` requires an [API key](https://octopus.com/docs/api/authentication/create-an-api-key) to the Octopus instance where the reference architecture projects and supporting resources are created. - `Octopus Space ID` requires the space ID where the reference architecture projects and supporting resources are created. Leave the default value to populate the same space as the runbook. - `Octopus Server URL` requires the URL of the Octopus instance where the reference architecture projects and supporting resources are created. Leave the default value to populate the same instance as the runbook. - `Optional Terraform Apply Args` allows custom arguments to be passed to the `terraform apply` command. The Terraform module applied by this step exposes a number of optional variables that can be defined as apply arguments. These arguments can be defined by setting this field to a value like `-var=project_template_project_name=renamed -var=infrastructure_project_name=renamed2 -var=frontend_project_name=renamed3 -var=products_project_name=renamed4 -var=audits_project_name=renamed5`: diff --git a/src/pages/docs/getting-started/reference-architectures/webapp-reference-architecture.md b/src/pages/docs/getting-started/reference-architectures/webapp-reference-architecture.md index 596bd26e1d..17401fcaad 100644 --- a/src/pages/docs/getting-started/reference-architectures/webapp-reference-architecture.md +++ b/src/pages/docs/getting-started/reference-architectures/webapp-reference-architecture.md @@ -21,7 +21,7 @@ The step exposes a number of options, typically requesting credentials to the va - `Azure account application ID`, `Azure account subscription ID`, `Azure account tenant ID`, and `Azure account password` require the details associated with a [service principal](https://learn.microsoft.com/en-us/purview/create-service-principal-azure) used to access the Azure platform. - `Docker Hub Username` and `Docker Hub Password` require the credentials of a [Docker Hub user](https://docs.docker.com/docker-id/) that is used to access sample Docker images from public DockerHub repositories. These credentials are also used by a sample GitHub Actions workflow that publishes Docker images. - `GitHub Access Token` requires the [GitHub access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) of a user that is used to create a new GitHub repository holding a sample application. -- `Octopus API Key` requires an [API key](https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key) to the Octopus instance where the reference architecture projects and supporting resources are created. +- `Octopus API Key` requires an [API key](https://octopus.com/docs/api/authentication/create-an-api-key) to the Octopus instance where the reference architecture projects and supporting resources are created. - `Octopus Space ID` requires the space ID where the reference architecture projects and supporting resources are created. Leave the default value to populate the same space as the runbook. - `Octopus Server URL` requires the URL of the Octopus instance where the reference architecture projects and supporting resources are created. Leave the default value to populate the same instance as the runbook. - `Optional Terraform Apply Args` allows custom arguments to be passed to the `terraform apply` command. The Terraform module applied by this step exposes a number of optional variables that can be defined as apply arguments. These arguments can be defined by setting this field to a value like `-var=project_template_project_name=renamed -var=infrastructure_project_name=renamed2 -var=frontend_project_name=renamed3 -var=products_project_name=renamed4 -var=audits_project_name=renamed5`: diff --git a/src/pages/docs/how-to/how-to-create-an-api-key/index.md b/src/pages/docs/how-to/how-to-create-an-api-key/index.md index 225c980a29..ac03e5207e 100644 --- a/src/pages/docs/how-to/how-to-create-an-api-key/index.md +++ b/src/pages/docs/how-to/how-to-create-an-api-key/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key +redirect: https://octopus.com/docs/api/authentication/create-an-api-key pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/how-to/sensitive-properties-api-changes-in-release-3.3/index.md b/src/pages/docs/how-to/sensitive-properties-api-changes-in-release-3.3/index.md index e165e097c1..c053b4ce77 100644 --- a/src/pages/docs/how-to/sensitive-properties-api-changes-in-release-3.3/index.md +++ b/src/pages/docs/how-to/sensitive-properties-api-changes-in-release-3.3/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/octopus-rest-api/examples +redirect: https://octopus.com/docs/api/examples pubDate: 2023-01-01 navSearch: false navSitemap: false diff --git a/src/pages/docs/infrastructure/accounts/azure/index.md b/src/pages/docs/infrastructure/accounts/azure/index.md index 2b3a715c6a..907a7631c1 100644 --- a/src/pages/docs/infrastructure/accounts/azure/index.md +++ b/src/pages/docs/infrastructure/accounts/azure/index.md @@ -709,7 +709,7 @@ if ($answer.ToLower() -ne "y") Import-AzurePowerShellModules $OctopusURL = Get-ParameterValue -originalParameterValue $OctopusURL -parameterName "the URL of your Octopus Deploy Instance, example: https://samples.octopus.com" -$OctopusApiKey = Get-ParameterValue -originalParameterValue $OctopusApiKey -parameterName "the API Key of your Octopus Deploy User. See https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key for a guide on how to create one" +$OctopusApiKey = Get-ParameterValue -originalParameterValue $OctopusApiKey -parameterName "the API Key of your Octopus Deploy User. See https://octopus.com/docs/api/authentication/create-an-api-key for a guide on how to create one" $OctopusSpaceName = Get-ParameterValueWithDefault -originalParameterValue $OctopusSpaceName -parameterName "the name of the space in Octopus Deploy. If left empty it will default to 'Default'" -defaultValue "Default" $OctopusAccountName = Get-ParameterValueWithDefault -originalParameterValue $OctopusAccountName -parameterName "the name of the account you wish to create in Octopus Deploy. If left empty it will default to 'Bootstrap Azure Account'" -defaultValue "Bootstrap Azure Account" diff --git a/src/pages/docs/infrastructure/deployment-targets/tentacle/windows/azure-virtual-machines/via-the-azure-portal.mdx b/src/pages/docs/infrastructure/deployment-targets/tentacle/windows/azure-virtual-machines/via-the-azure-portal.mdx index e99bb805bd..8a20e9002a 100644 --- a/src/pages/docs/infrastructure/deployment-targets/tentacle/windows/azure-virtual-machines/via-the-azure-portal.mdx +++ b/src/pages/docs/infrastructure/deployment-targets/tentacle/windows/azure-virtual-machines/via-the-azure-portal.mdx @@ -42,7 +42,7 @@ The settings for the extension are: **Octopus Server URL**: URL to your Octopus Server. You'll need your own Octopus Server (possibly also running on Azure), and you should [consider using HTTPS](/docs/security/exposing-octopus/expose-the-octopus-web-portal-over-https/). The extension will use the [Octopus REST API](/docs/octopus-rest-api) against this URL to register the machine. -**API Key**: [Your API key](/docs/octopus-rest-api/how-to-create-an-api-key/). This key will only be used when registering the machine with the Octopus Server; it isn't used for [subsequent communication](/docs/security/octopus-tentacle-communication). +**API Key**: [Your API key](/docs/api/authentication/create-an-api-key/). This key will only be used when registering the machine with the Octopus Server; it isn't used for [subsequent communication](/docs/security/octopus-tentacle-communication). **Environments**: The name of the [environment](/docs/infrastructure/environments) to add the machine to. You can specify more than one by using commas; for example: `UAT1,UAT2`. diff --git a/src/pages/docs/infrastructure/workers/index.mdx b/src/pages/docs/infrastructure/workers/index.mdx index b014195d81..3deed6b779 100644 --- a/src/pages/docs/infrastructure/workers/index.mdx +++ b/src/pages/docs/infrastructure/workers/index.mdx @@ -105,7 +105,7 @@ Workers have machine policies, are health checked, and run Calamari, just like d ## Registering an External Worker \{#registering-an-external-worker} -Once the Tentacle or SSH machine has been configured, workers can be added using the [Web Portal](#registering-workers-in-the-octopus-web-portal), the [Octopus Deploy REST API](/docs/octopus-rest-api/), the [Octopus.Clients library](/docs/octopus-rest-api/octopus.client) or with the Tentacle executable. Only a user with the `ConfigureServer` permission can add or edit workers. +Once the Tentacle or SSH machine has been configured, workers can be added using the [Web Portal](#registering-workers-in-the-octopus-web-portal), the [Octopus Deploy REST API](/docs/api/), the [Octopus.Clients library](/docs/api/octopus.client) or with the Tentacle executable. Only a user with the `ConfigureServer` permission can add or edit workers. ### Registering Workers in the Octopus Web Portal \{#registering-workers-in-the-octopus-web-portal} @@ -173,7 +173,7 @@ The Tentacle executable can also be used to deregister workers, for example: ``` :::div{.hint} -For information on creating an API key, see [how to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key). +For information on creating an API key, see [how to create an API key](/docs/api/authentication/create-an-api-key). ::: ## Recommendations for External Workers \{#recommendations-for-external-workers} diff --git a/src/pages/docs/installation/index.mdx b/src/pages/docs/installation/index.mdx index 1ab1b54756..482646e758 100644 --- a/src/pages/docs/installation/index.mdx +++ b/src/pages/docs/installation/index.mdx @@ -51,7 +51,7 @@ When installed, the self-hosted Octopus Server: - As a Windows Service called **OctopusDeploy**, installed via an MSI. - In a [Linux](/docs/installation/octopus-server-linux-container) container. - Stores its data in an [SQL Server Database](/docs/installation/sql-server-database/). ([SQL Server Express](https://oc.to/downloadsqlserverexpress) is an easy way of getting started.) -- Includes an embedded HTTP server which serves the [Octopus REST API](/docs/octopus-rest-api/) and the **Octopus Web Portal** that you will use to manage your [infrastructure](/docs/infrastructure/), [deployments](/docs/projects/deployment-process/), [runbooks](/docs/runbooks/), and coordinate your [releases](/docs/releases). +- Includes an embedded HTTP server which serves the [Octopus REST API](/docs/api/) and the **Octopus Web Portal** that you will use to manage your [infrastructure](/docs/infrastructure/), [deployments](/docs/projects/deployment-process/), [runbooks](/docs/runbooks/), and coordinate your [releases](/docs/releases). Before you install Octopus Deploy, review the software and hardware [requirements](/docs/installation/requirements/), and make sure you have access to an instance of [SQL Server Database](/docs/installation/sql-server-database) that you can use with Octopus Deploy. diff --git a/src/pages/docs/kubernetes/live-object-status/installation.md b/src/pages/docs/kubernetes/live-object-status/installation.md index c1f721a644..1b7ddb0d63 100644 --- a/src/pages/docs/kubernetes/live-object-status/installation.md +++ b/src/pages/docs/kubernetes/live-object-status/installation.md @@ -32,7 +32,7 @@ Find the following values and replace them in the Helm command below | | Value | Example | | :----------- | :----------------------------------------------------------------------------------------------------: | :---------------------- | | INSTANCE_URL | The URL you access your instance with, without https:// or a trailing slash | my-instance.octopus.app | -| API_KEY | An [API key](/docs/octopus-rest-api/how-to-create-an-api-key) for your user, created from your profile | API-MYKEY | +| API_KEY | An [API key](/docs/api/authentication/create-an-api-key) for your user, created from your profile | API-MYKEY | | SPACE_ID | The ID of the space your agent is installed in, find this in any Octopus url | Spaces-1 | | AGENT_NAME | The name of the Kubernetes agent | My Agent | | HELM_RELEASE | The name of the Helm release used to install the Kubernetes agent | myagent | diff --git a/src/pages/docs/octopus-ai/claude-agent-step/tools.md b/src/pages/docs/octopus-ai/claude-agent-step/tools.md index 27d07b4d5c..68cdefddda 100644 --- a/src/pages/docs/octopus-ai/claude-agent-step/tools.md +++ b/src/pages/docs/octopus-ai/claude-agent-step/tools.md @@ -31,7 +31,7 @@ To connect the agent to your Octopus instance: 1. Create a dedicated [agent service account](/docs/security/users-and-teams/service-accounts#agent-service-accounts). This gives the agent its own identity, keeps its activity identifiable in the audit log, and lets you revoke it on its own. 2. Grant the account the least privilege the task needs. For investigation and reporting, read-only access is usually enough, and it's what we recommend for a first run. -3. Generate an [agent API key](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key) under the account. +3. Generate an [agent API key](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key) under the account. 4. Store the key as a **sensitive variable** (for example, `octopus-api-key`), so the key is kept out of the task log and execution context. 5. On the step, expand **Agent Capabilities (optional)** > **Octopus MCP Server** and set **Octopus API key** to a reference to your variable, for example `#{octopus-api-key}`. 6. In **Tools**, list which of the server's tools the agent may call, one per line without the `mcp__octopus__` prefix, or leave the default `*` to allow every tool the server offers. A blank field disallows any tool the MCP server exposes. diff --git a/src/pages/docs/octopus-ai/index.mdx b/src/pages/docs/octopus-ai/index.mdx index fd47bb09d2..8c18156c8e 100644 --- a/src/pages/docs/octopus-ai/index.mdx +++ b/src/pages/docs/octopus-ai/index.mdx @@ -37,7 +37,7 @@ The Assistant also helps monitor your Octopus Deploy instance for optimization o The Octopus MCP (Model Context Protocol) server represents a significant leap forward in AI integration capabilities. Built on Anthropic's open standard for connecting AI agents to external data sources and tools, the MCP server will enable AI agents like Claude to interact directly with your Octopus Deploy infrastructure. -With supporting **governance** features like [Agent API keys](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key) and [Agent Service Accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts), you can also keep agent actions fully auditable in clear, filterable audit logs, so you can meet your compliance requirements. +With supporting **governance** features like [Agent API keys](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key) and [Agent Service Accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts), you can also keep agent actions fully auditable in clear, filterable audit logs, so you can meet your compliance requirements. The Octopus MCP server provides similar capabilities to the Octopus AI Assistant, but provides further benefits: diff --git a/src/pages/docs/octopus-ai/mcp/local/index.md b/src/pages/docs/octopus-ai/mcp/local/index.md index 0364a205c4..fc6dd9e343 100644 --- a/src/pages/docs/octopus-ai/mcp/local/index.md +++ b/src/pages/docs/octopus-ai/mcp/local/index.md @@ -30,7 +30,7 @@ For more information, see the [Octopus REST API](/docs/octopus-rest-api) documen ## Governance -Use dedicated [Agent API keys](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key) and [Agent Service Accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts) for agents connecting to your Octopus instance. These make agent actions identifiable and filterable in the audit log. +Use dedicated [Agent API keys](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key) and [Agent Service Accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts) for agents connecting to your Octopus instance. These make agent actions identifiable and filterable in the audit log. ## Installation @@ -38,7 +38,7 @@ Use dedicated [Agent API keys](/docs/octopus-rest-api/how-to-create-an-api-key#c - Node.js 20 or later - An Octopus Deploy instance that the MCP server can access over HTTPS -- An Octopus Deploy API key. We recommend creating a dedicated [Agent Service Account](/docs/security/users-and-teams/service-accounts#agent-service-accounts) and generating an [Agent API key](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key) for it. This gives the MCP server its own identity, limits its permissions, and identifies its activity in the audit log and on the API Keys page. +- An Octopus Deploy API key. We recommend creating a dedicated [Agent Service Account](/docs/security/users-and-teams/service-accounts#agent-service-accounts) and generating an [Agent API key](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key) for it. This gives the MCP server its own identity, limits its permissions, and identifies its activity in the audit log and on the API Keys page. ### Configuration diff --git a/src/pages/docs/octopus-ai/mcp/remote/index.md b/src/pages/docs/octopus-ai/mcp/remote/index.md index 7ed9e7950a..75b695f3c9 100644 --- a/src/pages/docs/octopus-ai/mcp/remote/index.md +++ b/src/pages/docs/octopus-ai/mcp/remote/index.md @@ -41,7 +41,7 @@ Octopus Remote MCP initially supports a selected set of core Octopus features. W ### Requirements - An Octopus Deploy instance that can be accessed over HTTPS -- An Octopus Deploy API key. We recommend creating a dedicated [Agent Service Account](/docs/security/users-and-teams/service-accounts#agent-service-accounts) and generating an [Agent API key](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key) for it. This gives the MCP server its own identity, limits its permissions, and identifies its activity in the audit log and on the API Keys page. +- An Octopus Deploy API key. We recommend creating a dedicated [Agent Service Account](/docs/security/users-and-teams/service-accounts#agent-service-accounts) and generating an [Agent API key](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key) for it. This gives the MCP server its own identity, limits its permissions, and identifies its activity in the audit log and on the API Keys page. Set the `OCTOPUS_API_KEY` environment variable to your Agent API key, then run: @@ -75,7 +75,7 @@ The Octopus MCP server operates within the same security boundary as our Rest AP ## Governance -Use dedicated [Agent API keys](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key) and [Agent Service Accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts) for agents connecting to your Octopus instance. These make agent actions identifiable and filterable in the audit log. +Use dedicated [Agent API keys](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key) and [Agent Service Accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts) for agents connecting to your Octopus instance. These make agent actions identifiable and filterable in the audit log. ## Configuration diff --git a/src/pages/docs/octopus-ai/mcp/remote/use-cases.md b/src/pages/docs/octopus-ai/mcp/remote/use-cases.md index a9e138cd22..00f65f5410 100644 --- a/src/pages/docs/octopus-ai/mcp/remote/use-cases.md +++ b/src/pages/docs/octopus-ai/mcp/remote/use-cases.md @@ -70,4 +70,4 @@ Example prompts: - [Octopus Remote MCP](/docs/octopus-ai/mcp/remote) - [Agent Service Accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts) -- [Agent API keys](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key) +- [Agent API keys](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key) diff --git a/src/pages/docs/octopus-cloud/connection-agent.md b/src/pages/docs/octopus-cloud/connection-agent.md index f40a764783..fbdb352ea1 100644 --- a/src/pages/docs/octopus-cloud/connection-agent.md +++ b/src/pages/docs/octopus-cloud/connection-agent.md @@ -64,7 +64,7 @@ By default, you can register up to 5 Connection Agents per instance. [Contact ou **IMPORTANT - Protect your Private Key:** The generated `.pem` file is your private key and must be kept secret. It lets Connection Agent authenticate and proxy requests from Octopus Cloud. If the private key is compromised, immediately [rotate your private key](#rotate-the-agents-key). ::: -1. [Create an API key](https://octopus.com/docs/octopus-rest-api/how-to-create-an-api-key) with a short expiry date on your Octopus Cloud instance. This API key will only be used to register the Connection Agent. +1. [Create an API key](https://octopus.com/docs/api/authentication/create-an-api-key) with a short expiry date on your Octopus Cloud instance. This API key will only be used to register the Connection Agent. 1. Register the Connection Agent with your Octopus Cloud instance. This command doesn't need to be run on the same infrastructure you intend to run the Connection Agent on. diff --git a/src/pages/docs/octopus-cloud/disaster-recovery.md b/src/pages/docs/octopus-cloud/disaster-recovery.md index c8cba09fd8..126092a976 100644 --- a/src/pages/docs/octopus-cloud/disaster-recovery.md +++ b/src/pages/docs/octopus-cloud/disaster-recovery.md @@ -66,4 +66,4 @@ In the case of an Azure region wide disaster the time to restore services will v ### Importing data -Due to some key differences between the self-hosted and cloud configurations, it **is not possible** to use the existing [Migration API](/docs/octopus-rest-api/migration-api/) to import data. If you are migrating from an existing self-hosted instance please see [migrating from self-hosted to Octopus Cloud](/docs/octopus-cloud/migrations). +Due to some key differences between the self-hosted and cloud configurations, it **is not possible** to use the existing [Migration API](/docs/api/migration-api/) to import data. If you are migrating from an existing self-hosted instance please see [migrating from self-hosted to Octopus Cloud](/docs/octopus-cloud/migrations). diff --git a/src/pages/docs/octopus-cloud/migrations.md b/src/pages/docs/octopus-cloud/migrations.md index 3b9939c26b..abc972da94 100644 --- a/src/pages/docs/octopus-cloud/migrations.md +++ b/src/pages/docs/octopus-cloud/migrations.md @@ -292,6 +292,6 @@ In our experience, most people turn off their Octopus Server in about three to s ## No longer offered or supported -Please note that our existing [Migration API](https://octopus.com/docs/octopus-rest-api/migration-api) is **not supported** for migrations to cloud instances due to configuration differences between self-hosted and cloud installations. +Please note that our existing [Migration API](https://octopus.com/docs/api/migration-api) is **not supported** for migrations to cloud instances due to configuration differences between self-hosted and cloud installations. The legacy [Data Migration](https://octopus.com/docs/administration/data/data-migration) included with Octopus Deploy is **not supported** for migrations to cloud instances. That tool is a Windows command-line application that must be run directly on the server hosting Octopus Deploy via an RDP session. Octopus Cloud runs on our Linux Container image on a Kubernetes Cluster and therefore access to the Container is not permitted for security reasons. diff --git a/src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md b/src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md index 5e3580f81a..efe595cd45 100644 --- a/src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md +++ b/src/pages/docs/octopus-rest-api/examples/add-a-space-with-environments.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/add-a-space-with-environments +redirect: https://octopus.com/docs/api/examples/spaces/add-a-space-with-environments pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md b/src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md index ad5e20d22c..ce32457913 100644 --- a/src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md +++ b/src/pages/docs/octopus-rest-api/examples/add-azure-web-app.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/add-azure-web-app +redirect: https://octopus.com/docs/api/examples/deployment-targets/add-azure-web-app pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md b/src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md index ea7ad135bc..ffb558514e 100644 --- a/src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md +++ b/src/pages/docs/octopus-rest-api/examples/add-environment-to-step.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/add-environment-to-step +redirect: https://octopus.com/docs/api/examples/deployment-process/add-environment-to-step pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md b/src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md index 4d43eeed76..63b99f1b17 100644 --- a/src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md +++ b/src/pages/docs/octopus-rest-api/examples/cancel-queued-deployments.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/cancel-queued-deployments +redirect: https://octopus.com/docs/api/examples/deployments/cancel-queued-deployments pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md b/src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md index 7526aa86a7..b418585c39 100644 --- a/src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md +++ b/src/pages/docs/octopus-rest-api/examples/change-machine-machinepolicy.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/change-machine-machinepolicy +redirect: https://octopus.com/docs/api/examples/deployment-targets/change-target-machinepolicy pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md b/src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md index 598a349eee..316c0f9f8e 100644 --- a/src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md +++ b/src/pages/docs/octopus-rest-api/examples/create-and-deploy-a-release.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/create-and-deploy-a-release +redirect: https://octopus.com/docs/api/examples/deployments/create-and-deploy-a-release pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md b/src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md index 87ffa98c12..0e1b4c1d15 100644 --- a/src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md +++ b/src/pages/docs/octopus-rest-api/examples/create-azure-service-principal.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/create-azure-service-principal +redirect: https://octopus.com/docs/api/examples/accounts/create-azure-service-principal pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/create-certificate.md b/src/pages/docs/octopus-rest-api/examples/create-certificate.md index ca80760efc..d8cd21fcac 100644 --- a/src/pages/docs/octopus-rest-api/examples/create-certificate.md +++ b/src/pages/docs/octopus-rest-api/examples/create-certificate.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/create-certificate +redirect: https://octopus.com/docs/api/examples/certificates/create-certificate pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/create-project.md b/src/pages/docs/octopus-rest-api/examples/create-project.md index ae6cc7b148..ff280e33b8 100644 --- a/src/pages/docs/octopus-rest-api/examples/create-project.md +++ b/src/pages/docs/octopus-rest-api/examples/create-project.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/create-project +redirect: https://octopus.com/docs/api/examples/projects/create-project pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/create-runbook.md b/src/pages/docs/octopus-rest-api/examples/create-runbook.md index a586f472db..5bc9e53b68 100644 --- a/src/pages/docs/octopus-rest-api/examples/create-runbook.md +++ b/src/pages/docs/octopus-rest-api/examples/create-runbook.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/create-runbook +redirect: https://octopus.com/docs/api/examples/runbooks/create-runbook pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/create-script-step.md b/src/pages/docs/octopus-rest-api/examples/create-script-step.md index a7f6b0ffcf..e2c5d3f112 100644 --- a/src/pages/docs/octopus-rest-api/examples/create-script-step.md +++ b/src/pages/docs/octopus-rest-api/examples/create-script-step.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/create-script-step +redirect: https://octopus.com/docs/api/examples/deployment-process/create-script-step pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/delete-a-space.md b/src/pages/docs/octopus-rest-api/examples/delete-a-space.md index ee96ca25b7..34ec2c5949 100644 --- a/src/pages/docs/octopus-rest-api/examples/delete-a-space.md +++ b/src/pages/docs/octopus-rest-api/examples/delete-a-space.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/delete-a-space +redirect: https://octopus.com/docs/api/examples/spaces/delete-a-space pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md b/src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md index 5328e3ac74..2f1c71c65f 100644 --- a/src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md +++ b/src/pages/docs/octopus-rest-api/examples/delete-machines-by-role.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/delete-machines-by-role +redirect: https://octopus.com/docs/api/examples/deployment-targets/delete-machines-by-role pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/delete-project-releases.md b/src/pages/docs/octopus-rest-api/examples/delete-project-releases.md index e7ebf9ea39..7d4dad7ceb 100644 --- a/src/pages/docs/octopus-rest-api/examples/delete-project-releases.md +++ b/src/pages/docs/octopus-rest-api/examples/delete-project-releases.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/delete-project-releases +redirect: https://octopus.com/docs/api/examples/releases/delete-project-releases pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md b/src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md index 553153c60c..6f8e26819b 100644 --- a/src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md +++ b/src/pages/docs/octopus-rest-api/examples/feeds/get-feeds.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/feeds/get-feeds +redirect: https://octopus.com/docs/api/examples/feeds/retrieve-feeds pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md b/src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md index c2279c66ff..b4e92245e2 100644 --- a/src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md +++ b/src/pages/docs/octopus-rest-api/examples/get-steps-using-role.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/get-steps-using-role +redirect: https://octopus.com/docs/api/examples/deployment-process/get-steps-using-role pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/list-users-with-role.md b/src/pages/docs/octopus-rest-api/examples/list-users-with-role.md index 0d23c9017f..047267ea7c 100644 --- a/src/pages/docs/octopus-rest-api/examples/list-users-with-role.md +++ b/src/pages/docs/octopus-rest-api/examples/list-users-with-role.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/list-users-with-role +redirect: https://octopus.com/docs/api/examples/users-and-teams/list-users-with-role pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/publish-runbook.md b/src/pages/docs/octopus-rest-api/examples/publish-runbook.md index d252fe9009..338d0e85e1 100644 --- a/src/pages/docs/octopus-rest-api/examples/publish-runbook.md +++ b/src/pages/docs/octopus-rest-api/examples/publish-runbook.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/publish-runbook +redirect: https://octopus.com/docs/api/examples/runbooks/publish-runbook pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md b/src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md index 6aeaa9534a..11bb9ee269 100644 --- a/src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md +++ b/src/pages/docs/octopus-rest-api/examples/register-listening-tentacle.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/register-listening-tentacle +redirect: https://octopus.com/docs/api/examples/deployment-targets/register-listening-tentacle pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md b/src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md index 51f6a20ec8..cc900a13d0 100644 --- a/src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md +++ b/src/pages/docs/octopus-rest-api/examples/register-polling-tentacle.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/register-polling-tentacle +redirect: https://octopus.com/docs/api/examples/deployment-targets/register-polling-tentacle pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/replace-certificate.md b/src/pages/docs/octopus-rest-api/examples/replace-certificate.md index 823fd8e031..27f3aea62f 100644 --- a/src/pages/docs/octopus-rest-api/examples/replace-certificate.md +++ b/src/pages/docs/octopus-rest-api/examples/replace-certificate.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/replace-certificate +redirect: https://octopus.com/docs/api/examples/certificates/replace-certificate pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/run-runbook.md b/src/pages/docs/octopus-rest-api/examples/run-runbook.md index 358080d153..c7eeefda46 100644 --- a/src/pages/docs/octopus-rest-api/examples/run-runbook.md +++ b/src/pages/docs/octopus-rest-api/examples/run-runbook.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/run-runbook +redirect: https://octopus.com/docs/api/examples/runbooks/run-runbook pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md b/src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md index 8fdfb7c7d1..d7f4a9f213 100644 --- a/src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md +++ b/src/pages/docs/octopus-rest-api/examples/tenants/bulk-add-projects-to-tenants.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/tenants/bulk-add-projects-to-tenants +redirect: https://octopus.com/docs/api/examples/bulk-operations/bulk-add-projects-to-tenants pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/users/index.md b/src/pages/docs/octopus-rest-api/examples/users/index.md index 494f382fe3..a4f8a8e197 100644 --- a/src/pages/docs/octopus-rest-api/examples/users/index.md +++ b/src/pages/docs/octopus-rest-api/examples/users/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/users +redirect: https://octopus.com/docs/api/examples/users-and-teams pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md b/src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md index 4c8a3ade9a..047267ea7c 100644 --- a/src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md +++ b/src/pages/docs/octopus-rest-api/examples/users/list-users-with-role.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/users/list-users-with-role +redirect: https://octopus.com/docs/api/examples/users-and-teams/list-users-with-role pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md b/src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md index 09ba534d7b..c2284f655d 100644 --- a/src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md +++ b/src/pages/docs/octopus-rest-api/examples/variables/find-variable-vaule-usage.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/examples/variables/find-variable-vaule-usage +redirect: https://octopus.com/docs/api/examples/variables/find-variable-value-usage pubDate: 2023-01-01 modDate: 2026-09-01 navSearch: false diff --git a/src/pages/docs/packaging-applications/build-servers/appveyor/index.md b/src/pages/docs/packaging-applications/build-servers/appveyor/index.md index 28e8b04ac8..ef5532b4e8 100644 --- a/src/pages/docs/packaging-applications/build-servers/appveyor/index.md +++ b/src/pages/docs/packaging-applications/build-servers/appveyor/index.md @@ -62,7 +62,7 @@ You can use a wildcard to pick up the dynamically generated package. Next, go to the **Deployment** page in your project's settings and click **Add deployment** and from the **Deployment providers** select **Octopus Deploy**. -Enter the URL where the Octopus Server can be reached, and add an [API key](/docs/octopus-rest-api/how-to-create-an-api-key). +Enter the URL where the Octopus Server can be reached, and add an [API key](/docs/api/authentication/create-an-api-key). :::figure ![AppVeyor Deploy](/docs/img/packaging-applications/build-servers/appveyor/images/appveyor_deploy.png) diff --git a/src/pages/docs/packaging-applications/build-servers/bamboo.md b/src/pages/docs/packaging-applications/build-servers/bamboo.md index c55038c072..f61f112e8c 100644 --- a/src/pages/docs/packaging-applications/build-servers/bamboo.md +++ b/src/pages/docs/packaging-applications/build-servers/bamboo.md @@ -203,7 +203,7 @@ The `Octopus URL` field defines the URL of the Octopus Server that the package w ### API key -The `API key` field defines the API key that is used to authenticate with the Octopus Server. See [How to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key) for more information. +The `API key` field defines the API key that is used to authenticate with the Octopus Server. See [How to create an API key](/docs/api/authentication/create-an-api-key) for more information. ### Octopus CLI diff --git a/src/pages/docs/packaging-applications/build-servers/codefresh-pipelines.md b/src/pages/docs/packaging-applications/build-servers/codefresh-pipelines.md index a678985c05..4f6425d7e8 100644 --- a/src/pages/docs/packaging-applications/build-servers/codefresh-pipelines.md +++ b/src/pages/docs/packaging-applications/build-servers/codefresh-pipelines.md @@ -324,7 +324,7 @@ Each step includes one or two examples to help with setting up a workflow. Basic ### Log into Octopus -The **octopusdeploy-login** step authenticates to Octopus via OIDC, so your Octopus server needs a [service account with OIDC enabled](/docs/octopus-rest-api/openid-connect/other-issuers). +The **octopusdeploy-login** step authenticates to Octopus via OIDC, so your Octopus server needs a [service account with OIDC enabled](/docs/api/openid-connect/other-issuers). To allow connections from Codefresh, the service account's OIDC identity should have **Issuer** `https://oidc.codefresh.io` and a **Subject** matching the [Codefresh subject claim for your preferred pipeline trigger](https://codefresh.io/docs/docs/integrations/oidc-pipelines/#codefresh-trigger-types-for-subject-claims). The **octopusdeploy-login** step requires an `ID_TOKEN`, which can be generated by running the Codefresh **obtain-oidc-id-token** Marketplace step. This step sets the token as an environment variable which can be passed into the Octopus login step as an argument. See the [Codefresh OIDC documentation](https://codefresh.io/docs/docs/integrations/oidc-pipelines/) for further details. diff --git a/src/pages/docs/packaging-applications/build-servers/jenkins/index.mdx b/src/pages/docs/packaging-applications/build-servers/jenkins/index.mdx index ababee5541..91562b5870 100644 --- a/src/pages/docs/packaging-applications/build-servers/jenkins/index.mdx +++ b/src/pages/docs/packaging-applications/build-servers/jenkins/index.mdx @@ -45,7 +45,7 @@ After you have installed the Octopus Deploy plugin. First navigate to **Manage J :::div{.success} **Creating API keys** -Learn [how to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key) so the plugin can interact with your Octopus Server. +Learn [how to create an API key](/docs/api/authentication/create-an-api-key) so the plugin can interact with your Octopus Server. ::: ### Octopus CLI @@ -71,7 +71,7 @@ Next, navigate to **Manage Jenkins ➜ Configure System**. #### Octopus Server settings -Here you can create the link to your Octopus Server. You can add more than one if your organization uses multiple servers. This is where you supply an API Key, select a Service Account with suitable permission and see [how to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key) for it. +Here you can create the link to your Octopus Server. You can add more than one if your organization uses multiple servers. This is where you supply an API Key, select a Service Account with suitable permission and see [how to create an API key](/docs/api/authentication/create-an-api-key) for it. :::figure ![The Octopus Deploy servers section of the Jenkins configuration](/docs/img/packaging-applications/build-servers/jenkins/images/octopusdeploy-servers.png) diff --git a/src/pages/docs/packaging-applications/build-servers/teamcity.mdx b/src/pages/docs/packaging-applications/build-servers/teamcity.mdx index 336da4fc2e..1188213670 100644 --- a/src/pages/docs/packaging-applications/build-servers/teamcity.mdx +++ b/src/pages/docs/packaging-applications/build-servers/teamcity.mdx @@ -37,7 +37,7 @@ The plugin is simply a wrapper for the [Octopus CLI](/docs/cli/octopus-cli), the Octopus can be used as a [NuGet package repository](/docs/packaging-applications/package-repositories/built-in-repository), or it can be configured to use an external feed (such as retrieving them from TeamCity). -To push packages to Octopus during the OctoPack phase, enter the NuGet endpoint URL into the **Publish packages to http** field, and [an API key](/docs/octopus-rest-api/how-to-create-an-api-key) in the **Publish API Key** field. OctoPack will then push the packages when the solution is built. You'll find the URL to your repository on the **Deploy ➜ Manage ➜ Packages** tab in Octopus. Simply click the `Show examples` link to see options to upload packages including the repository URL. +To push packages to Octopus during the OctoPack phase, enter the NuGet endpoint URL into the **Publish packages to http** field, and [an API key](/docs/api/authentication/create-an-api-key) in the **Publish API Key** field. OctoPack will then push the packages when the solution is built. You'll find the URL to your repository on the **Deploy ➜ Manage ➜ Packages** tab in Octopus. Simply click the `Show examples` link to see options to upload packages including the repository URL. ## Consuming the TeamCity NuGet feed in Octopus \{#TeamCity-ConsumeNuGetFeedInOctopusConsumingTheTeamCityNuGetFeedInOctopus} diff --git a/src/pages/docs/packaging-applications/build-servers/tfs-azure-devops/using-octopus-extension/index.mdx b/src/pages/docs/packaging-applications/build-servers/tfs-azure-devops/using-octopus-extension/index.mdx index 83c9b73bcd..673d2a560d 100644 --- a/src/pages/docs/packaging-applications/build-servers/tfs-azure-devops/using-octopus-extension/index.mdx +++ b/src/pages/docs/packaging-applications/build-servers/tfs-azure-devops/using-octopus-extension/index.mdx @@ -55,7 +55,7 @@ You can bring your own version of the Octopus CLI and avoid the use of installer Follow [these](https://docs.microsoft.com/en-us/azure/devops/pipelines/library/service-endpoints) instructions to create a new service connection and make sure you pick **Octopus Deploy**. -Enter a valid [Octopus API Key](/docs/octopus-rest-api/how-to-create-an-api-key) in the **API Key** field and the Octopus Server url. +Enter a valid [Octopus API Key](/docs/api/authentication/create-an-api-key) in the **API Key** field and the Octopus Server url. After you've saved the connection, it should be available from the Octopus Deploy Build Tasks. diff --git a/src/pages/docs/packaging-applications/create-packages/octopack/index.md b/src/pages/docs/packaging-applications/create-packages/octopack/index.md index a9673b05b1..4b8a36b75e 100644 --- a/src/pages/docs/packaging-applications/create-packages/octopack/index.md +++ b/src/pages/docs/packaging-applications/create-packages/octopack/index.md @@ -225,7 +225,7 @@ Octopus provides a [built-in package repository](/docs/packaging-applications/pa To push your packages to the Octopus built-in repository use the following settings: - `/p:OctoPackPublishPackageToHttp=http://your.octopusserver.com/nuget/packages`: this is the URL to your Octopus Server noting the `/nuget/packages` path. -- `/p:OctoPackPublishApiKey=API-YOUR-KEY`: the [Octopus API key](/docs/octopus-rest-api/how-to-create-an-api-key) you want to use for pushing packages noting [these security considerations](/docs/packaging-applications/package-repositories/built-in-repository/#security-considerations). +- `/p:OctoPackPublishApiKey=API-YOUR-KEY`: the [Octopus API key](/docs/api/authentication/create-an-api-key) you want to use for pushing packages noting [these security considerations](/docs/packaging-applications/package-repositories/built-in-repository/#security-considerations). ## Push a NuGet package that already exists diff --git a/src/pages/docs/packaging-applications/create-packages/octopus-cli.md b/src/pages/docs/packaging-applications/create-packages/octopus-cli.md index 763cec8183..a07de5cdac 100644 --- a/src/pages/docs/packaging-applications/create-packages/octopus-cli.md +++ b/src/pages/docs/packaging-applications/create-packages/octopus-cli.md @@ -7,7 +7,7 @@ description: Using the Octopus CLI (octopus) command line tool to create package navOrder: 30 --- -The Octopus CLI (`octopus`) is a command line tool that interacts with the [Octopus Deploy REST API](/docs/octopus-rest-api/) and includes packaging commands to create packages either as [Zip](#create-zip-packages) or [NuGet](#create-nuget-packages) packages for deployment with Octopus. +The Octopus CLI (`octopus`) is a command line tool that interacts with the [Octopus Deploy REST API](/docs/api/) and includes packaging commands to create packages either as [Zip](#create-zip-packages) or [NuGet](#create-nuget-packages) packages for deployment with Octopus. ## Installation diff --git a/src/pages/docs/packaging-applications/package-repositories/built-in-repository/index.md b/src/pages/docs/packaging-applications/package-repositories/built-in-repository/index.md index eaf673d4d3..f51b191838 100644 --- a/src/pages/docs/packaging-applications/package-repositories/built-in-repository/index.md +++ b/src/pages/docs/packaging-applications/package-repositories/built-in-repository/index.md @@ -17,7 +17,7 @@ It is possible to manually upload a package file from your local machine via the However, we recommend using a [build server](/docs/packaging-applications/build-servers) to build, test, package and automatically upload your release packages into the Octopus Deploy built-in repository. -In most cases you simply provide the build server with the URL to your Octopus Server and an [Octopus API key](/docs/octopus-rest-api/how-to-create-an-api-key) with the required permissions (see [security considerations](/docs/packaging-applications/package-repositories/built-in-repository/#security-considerations)). +In most cases you simply provide the build server with the URL to your Octopus Server and an [Octopus API key](/docs/api/authentication/create-an-api-key) with the required permissions (see [security considerations](/docs/packaging-applications/package-repositories/built-in-repository/#security-considerations)). In addition to manually uploading packages or using your build server, you can add, upload packages to the built-in feed in the following ways: @@ -30,7 +30,7 @@ In addition to manually uploading packages or using your build server, you can a To push packages using these methods, you will need: 1. The URL to your Octopus Server. -2. An [Octopus API key](/docs/octopus-rest-api/how-to-create-an-api-key) with the required permissions (see [security considerations](/docs/packaging-applications/package-repositories/built-in-repository/#security-considerations)). +2. An [Octopus API key](/docs/api/authentication/create-an-api-key) with the required permissions (see [security considerations](/docs/packaging-applications/package-repositories/built-in-repository/#security-considerations)). ## Using the Octopus CLI {#UsingOctopusCli} @@ -62,14 +62,14 @@ You can upload a package via the [Octopus Deploy API](/docs/octopus-rest-api) - ## Using NuGet.exe push {#UsingNuGetExePush} -To push a package using `NuGet.exe` you'll need the URL for the Octopus NuGet feed to use with your build server or `NuGet.exe`. To find this, open the **Deploy ➜ Manage ➜ Packages** tab of the Octopus Web Portal. The Help sidebar has options and examples of how to upload packages. The screen shows an example command-line that can be used to push packages to the feed using [NuGet.exe](http://docs.nuget.org/docs/start-here/installing-nuget). You'll need to supply the NuGet package file (`.nupkg`) and an [Octopus API key](/docs/octopus-rest-api/how-to-create-an-api-key). +To push a package using `NuGet.exe` you'll need the URL for the Octopus NuGet feed to use with your build server or `NuGet.exe`. To find this, open the **Deploy ➜ Manage ➜ Packages** tab of the Octopus Web Portal. The Help sidebar has options and examples of how to upload packages. The screen shows an example command-line that can be used to push packages to the feed using [NuGet.exe](http://docs.nuget.org/docs/start-here/installing-nuget). You'll need to supply the NuGet package file (`.nupkg`) and an [Octopus API key](/docs/api/authentication/create-an-api-key). :::figure ![The Built-in Package Repository](/docs/img/packaging-applications/package-repositories/built-in-repository/built-in-package-repository.png) ::: :::div{.success} -If you're using a continuous integration server like TeamCity to produce packages you can use their built-in NuGet Push step. Supply the Octopus NuGet feed URL shown above and an [Octopus API key](/docs/octopus-rest-api/how-to-create-an-api-key) when prompted for the feed details. +If you're using a continuous integration server like TeamCity to produce packages you can use their built-in NuGet Push step. Supply the Octopus NuGet feed URL shown above and an [Octopus API key](/docs/api/authentication/create-an-api-key) when prompted for the feed details. ::: If a package with the same version exists, and you want to force the Octopus Server to replace it, you can modify the URL to include a `?replace=true` parameter: diff --git a/src/pages/docs/platform-hub/templates/process-templates/troubleshooting.md b/src/pages/docs/platform-hub/templates/process-templates/troubleshooting.md index dccc5bd63f..7ada915103 100644 --- a/src/pages/docs/platform-hub/templates/process-templates/troubleshooting.md +++ b/src/pages/docs/platform-hub/templates/process-templates/troubleshooting.md @@ -141,7 +141,7 @@ Process templates can be created and managed through our [public API](/docs/octo We do not currently support creating or managing process templates through the CLI or the Terraform provider. ::: -See [CreateProcessTemplateUsageStep](https://github.com/OctopusDeploy/OctopusDeploy-Api/blob/master/Octopus.Client/Csharp/DeploymentProcesses/CreateProcessTemplateUsageStep.cs) for an example of how to configure a process template on a deployment process using [Octopus.Client](/docs/octopus-rest-api/octopus.client). +See [CreateProcessTemplateUsageStep](https://github.com/OctopusDeploy/OctopusDeploy-Api/blob/master/Octopus.Client/Csharp/DeploymentProcesses/CreateProcessTemplateUsageStep.cs) for an example of how to configure a process template on a deployment process using [Octopus.Client](/docs/api/octopus.client). ### GitHub Connections diff --git a/src/pages/docs/projects/deployment-process/index.mdx b/src/pages/docs/projects/deployment-process/index.mdx index adeb8307d6..2c88abb55b 100644 --- a/src/pages/docs/projects/deployment-process/index.mdx +++ b/src/pages/docs/projects/deployment-process/index.mdx @@ -83,7 +83,7 @@ Octopus Deploy is built API-first, which means everything you can do through the - Steps - Actions -We have provided lots of helpful functions for building your deployment process in the [.NET SDK](/docs/octopus-rest-api/octopus.client), or you can use the raw HTTP API if that suits your needs better. +We have provided lots of helpful functions for building your deployment process in the [.NET SDK](/docs/api/octopus.client), or you can use the raw HTTP API if that suits your needs better. Learn about using the [Octopus REST API](/docs/octopus-rest-api). diff --git a/src/pages/docs/releases/channels/index.md b/src/pages/docs/releases/channels/index.md index e07313c311..cd8f7f36e1 100644 --- a/src/pages/docs/releases/channels/index.md +++ b/src/pages/docs/releases/channels/index.md @@ -301,7 +301,7 @@ The package list allows you to select the version of each package involved in th ### Using build server extensions or the Octopus CLI -When using one of the [build server extensions](/docs/octopus-rest-api/) or the [Octopus CLI](/docs/cli/octopus-cli/create-release) to create releases, you can either let Octopus automatically choose the correct channel for your release (this is the default behavior), or choose a specific channel yourself. +When using one of the [build server extensions](/docs/api/) or the [Octopus CLI](/docs/cli/octopus-cli/create-release) to create releases, you can either let Octopus automatically choose the correct channel for your release (this is the default behavior), or choose a specific channel yourself. ### Built-in package repository triggers diff --git a/src/pages/docs/runbooks/runbook-permissions/index.md b/src/pages/docs/runbooks/runbook-permissions/index.md index 91c2d074d3..136ef9cd12 100644 --- a/src/pages/docs/runbooks/runbook-permissions/index.md +++ b/src/pages/docs/runbooks/runbook-permissions/index.md @@ -42,7 +42,7 @@ Octopus Deploy is built API-first, which means everything you can do through the - RunbookSnapshots *(a runbook can have many snapshots, each with a unique name. Creating a snapshot needs RunbookSnapshotCreate, and publishing or deleting one needs RunbookEdit.)* - RunbookRuns *(a runbook snapshot will then be run/executed against an environment, with RunbookRunCreate permissions.)* -We have provided lots of helpful functions for building your runbook process in the [.NET SDK](/docs/octopus-rest-api/octopus.client), or you can use the raw HTTP API if that suits your needs better. +We have provided lots of helpful functions for building your runbook process in the [.NET SDK](/docs/api/octopus.client), or you can use the raw HTTP API if that suits your needs better. Learn about using the [Octopus REST API](/docs/octopus-rest-api). diff --git a/src/pages/docs/runbooks/webhook-runbook-trigger/index.md b/src/pages/docs/runbooks/webhook-runbook-trigger/index.md index e42e464452..900969134d 100644 --- a/src/pages/docs/runbooks/webhook-runbook-trigger/index.md +++ b/src/pages/docs/runbooks/webhook-runbook-trigger/index.md @@ -67,7 +67,7 @@ Runbook runs created this way are not attributed to an Octopus user, so no permi ### Octopus API key -With **Octopus API key**, callers authenticate as an Octopus user by sending an [API key](/docs/octopus-rest-api/how-to-create-an-api-key) in the `X-Octopus-ApiKey` header: +With **Octopus API key**, callers authenticate as an Octopus user by sending an [API key](/docs/api/authentication/create-an-api-key) in the `X-Octopus-ApiKey` header: ```bash curl -X POST https://your-octopus-url/api/Spaces-1/webhook/00000000-0000-0000-0000-000000000000 \ diff --git a/src/pages/docs/security/cve/csrf-and-octopus-deploy.md b/src/pages/docs/security/cve/csrf-and-octopus-deploy.md index fd0f1adc16..adb1c3716f 100644 --- a/src/pages/docs/security/cve/csrf-and-octopus-deploy.md +++ b/src/pages/docs/security/cve/csrf-and-octopus-deploy.md @@ -66,7 +66,7 @@ Octopus requires two cookies when using a web browser: the authentication cookie ### Using the Octopus REST API with raw HTTP -If you use raw HTTP to access Octopus Deploy we recommend using an [API Key](/docs/octopus-rest-api/how-to-create-an-api-key/) to authenticate your requests. Learn about the [Octopus REST API](/docs/octopus-rest-api) including [authenticating with the Octopus REST API](/docs/octopus-rest-api/#authentication). +If you use raw HTTP to access Octopus Deploy we recommend using an [API Key](/docs/api/authentication/create-an-api-key/) to authenticate your requests. Learn about the [Octopus REST API](/docs/octopus-rest-api) including [authenticating with the Octopus REST API](/docs/api/#authentication). ### Contact Octopus support {#support} diff --git a/src/pages/docs/security/users-and-teams/auditing/index.md b/src/pages/docs/security/users-and-teams/auditing/index.md index 570ee52951..18e4278e04 100644 --- a/src/pages/docs/security/users-and-teams/auditing/index.md +++ b/src/pages/docs/security/users-and-teams/auditing/index.md @@ -22,7 +22,7 @@ Some general points worth noting: - Octopus **does** capture the details of every mutating action (create/edit/delete) including who initiated the action. - Octopus **does** capture login events for specific user accounts, but **not** logout. - Octopus **does not** capture when data is read, however certain sensitive actions like downloading a certificate with its private key is captured. -- When an action is performed via an [agent API key](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key), Octopus captures the API key name alongside the action, so you can trace agent activity back to a specific credential and its owner. +- When an action is performed via an [agent API key](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key), Octopus captures the API key name alongside the action, so you can trace agent activity back to a specific credential and its owner. If you are concerned that Octopus does not capture a specific action of interest to you, please contact our [support team](https://octopus.com/support). diff --git a/src/pages/docs/security/users-and-teams/index.md b/src/pages/docs/security/users-and-teams/index.md index d52b09da52..d2325afb8d 100644 --- a/src/pages/docs/security/users-and-teams/index.md +++ b/src/pages/docs/security/users-and-teams/index.md @@ -22,9 +22,9 @@ You can manage users and teams in the Octopus Web Portal: ## User and service accounts -**User accounts** are allowed to use both the Octopus Web Portal and the Octopus API, and can authenticate with a username and password, [Active Directory credentials](/docs/security/authentication/active-directory/), or an [Octopus API key](/docs/octopus-rest-api/how-to-create-an-api-key). +**User accounts** are allowed to use both the Octopus Web Portal and the Octopus API, and can authenticate with a username and password, [Active Directory credentials](/docs/security/authentication/active-directory/), or an [Octopus API key](/docs/api/authentication/create-an-api-key). -[Service accounts](/docs/security/users-and-teams/service-accounts/) are **API-only accounts** that should be used for automated services that integrate with Octopus Deploy, and can only authenticate with an [Octopus API key](/docs/octopus-rest-api/how-to-create-an-api-key/). For more information refer to [Service accounts](/docs/security/users-and-teams/service-accounts). +[Service accounts](/docs/security/users-and-teams/service-accounts/) are **API-only accounts** that should be used for automated services that integrate with Octopus Deploy, and can only authenticate with an [Octopus API key](/docs/api/authentication/create-an-api-key/). For more information refer to [Service accounts](/docs/security/users-and-teams/service-accounts). :::div{.success} You should create a different User account for each person that will use Octopus Deploy. You should create a different [Service account](/docs/security/users-and-teams/service-accounts) for each service that will integrate with Octopus Deploy. diff --git a/src/pages/docs/security/users-and-teams/service-accounts.md b/src/pages/docs/security/users-and-teams/service-accounts.md index 8f5bec1057..9fcf82ebef 100644 --- a/src/pages/docs/security/users-and-teams/service-accounts.md +++ b/src/pages/docs/security/users-and-teams/service-accounts.md @@ -18,7 +18,7 @@ It is best to create **Service accounts** for this purpose to provide each servi :::div{.hint} **Service accounts** are **API-only accounts** that can be assigned permissions in the same way you do for normal accounts, but are prevented from using the Octopus Web Portal. -Service accounts authenticate with the Octopus API using [OpenID Connect](/docs/octopus-rest-api/openid-connect) or an [Octopus API Key](/docs/octopus-rest-api/how-to-create-an-api-key). For dedicated agent service accounts, see [Agent service accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts). +Service accounts authenticate with the Octopus API using [OpenID Connect](/docs/api/openid-connect) or an [Octopus API Key](/docs/api/authentication/create-an-api-key). For dedicated agent service accounts, see [Agent service accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts). ::: ## Creating a service account {#ServiceAccounts-CreatingAServiceAccount} @@ -37,12 +37,12 @@ Creating a new Service account is very similar to creating a new User account: ::: :::div{.hint} -This Service account is not very useful until it [belongs to one or more teams](/docs/security/users-and-teams/), and has one or more [OpenID Connect Identities](/docs/octopus-rest-api/openid-connect) or [Octopus API keys](/docs/octopus-rest-api/how-to-create-an-api-key) associated with it. +This Service account is not very useful until it [belongs to one or more teams](/docs/security/users-and-teams/), and has one or more [OpenID Connect Identities](/docs/api/openid-connect) or [Octopus API keys](/docs/api/authentication/create-an-api-key) associated with it. ::: ## OpenID Connect (OIDC) -You can use [OpenID Connect (OIDC)](/docs/octopus-rest-api/openid-connect) to automate Octopus with another service without needing to provision or manage API Keys. To do this you configure a specific *OIDC Identity* for the service which allows it to connect to Octopus securely. The service then exchanges an ID token with Octopus for a short-lived access token which it can then use for API requests. +You can use [OpenID Connect (OIDC)](/docs/api/openid-connect) to automate Octopus with another service without needing to provision or manage API Keys. To do this you configure a specific *OIDC Identity* for the service which allows it to connect to Octopus securely. The service then exchanges an ID token with Octopus for a short-lived access token which it can then use for API requests. ## API Keys @@ -50,7 +50,7 @@ You can use [OpenID Connect (OIDC)](/docs/octopus-rest-api/openid-connect) to au ![Service account API Key](/docs/img/security/users-and-teams/images/service-account-apikey.png) ::: -Once you have created an [Octopus API key](/docs/octopus-rest-api/how-to-create-an-api-key/) and [added this Service account to a team](/docs/security/users-and-teams), you can start using this Service account to automate Octopus with another service. +Once you have created an [Octopus API key](/docs/api/authentication/create-an-api-key/) and [added this Service account to a team](/docs/security/users-and-teams), you can start using this Service account to automate Octopus with another service. ## Agent service accounts {#agent-service-accounts} @@ -64,7 +64,7 @@ To create an agent service account: 2. Enter a **Service Username** and **Service Display Name** for the agent. 3. Save the user. -Once created, [add the agent service account to one or more teams](/docs/security/users-and-teams) to grant it the permissions it needs, then [create an agent API key](/docs/octopus-rest-api/how-to-create-an-api-key#creating-an-agent-api-key) for it. +Once created, [add the agent service account to one or more teams](/docs/security/users-and-teams) to grant it the permissions it needs, then [create an agent API key](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key) for it. ## Logins diff --git a/src/pages/docs/tenants/tag-sets.md b/src/pages/docs/tenants/tag-sets.md index 7532c16795..73cd51c85e 100644 --- a/src/pages/docs/tenants/tag-sets.md +++ b/src/pages/docs/tenants/tag-sets.md @@ -84,7 +84,7 @@ For example: You can use canonical names when: -- Deploying releases using [build server integrations](/docs/octopus-rest-api/) or the [Octopus CLI](/docs/cli/octopus-cli/). +- Deploying releases using [build server integrations](/docs/api/) or the [Octopus CLI](/docs/cli/octopus-cli/). - Scoping variables to tags. - Automating Octopus via the [Octopus REST API](/docs/octopus-rest-api). diff --git a/src/pages/docs/tenants/tenant-creation/index.mdx b/src/pages/docs/tenants/tenant-creation/index.mdx index 08f4c97a59..1ac8b8c229 100644 --- a/src/pages/docs/tenants/tenant-creation/index.mdx +++ b/src/pages/docs/tenants/tenant-creation/index.mdx @@ -15,7 +15,7 @@ import TenantsCreateTenant from 'src/shared-content/tenants/tenants-create-tenan Now that you've created a tenant, you can enable [tenanted deployments](/docs/tenants/tenant-creation/tenanted-deployments/) and then [connect the tenant to a project](/docs/tenants/tenant-creation/connecting-projects). :::div{.hint} -It's also possible to create a tenant using the [Octopus REST API](/docs/octopus-rest-api/). Learn more in our [create a tenant](/docs/api/examples/tenants/create-tenant) example. +It's also possible to create a tenant using the [Octopus REST API](/docs/api/). Learn more in our [create a tenant](/docs/api/examples/tenants/create-tenant) example. ::: ## Tenant logo \{#tenant-logo} diff --git a/src/pages/docs/tenants/tenant-deployment-faq.md b/src/pages/docs/tenants/tenant-deployment-faq.md index b58d4cd2f4..685c1250ec 100644 --- a/src/pages/docs/tenants/tenant-deployment-faq.md +++ b/src/pages/docs/tenants/tenant-deployment-faq.md @@ -67,7 +67,7 @@ No. Each tenanted deployment is independent. There is no built-in way to perform - I want to send an email once release **1.2.6** has been successfully deployed to all of my tenants in production. - I want to upgrade a batch of tenants and, if one fails, I want them all to roll-back to the last known good version. -You can achieve these behaviors using a custom script/application which leverages the [Octopus REST API](/docs/octopus-rest-api/) and taking advantage of [Subscriptions](/docs/administration/managing-infrastructure/subscriptions). This way you can use the information provided by Octopus to perform a complex deployment orchestration with any custom logic that suits your scenario perfectly. For example, you could write a script/application which starts a batch of tenanted deployments using a specific tag, then monitor the progress of those deployments, and finally take any action based on the results. +You can achieve these behaviors using a custom script/application which leverages the [Octopus REST API](/docs/api/) and taking advantage of [Subscriptions](/docs/administration/managing-infrastructure/subscriptions). This way you can use the information provided by Octopus to perform a complex deployment orchestration with any custom logic that suits your scenario perfectly. For example, you could write a script/application which starts a batch of tenanted deployments using a specific tag, then monitor the progress of those deployments, and finally take any action based on the results. ## Can I have a combination of tenanted and untenanted projects? diff --git a/src/pages/docs/tenants/tenant-tags.md b/src/pages/docs/tenants/tenant-tags.md index f8f97efba6..b82933ec0f 100644 --- a/src/pages/docs/tenants/tenant-tags.md +++ b/src/pages/docs/tenants/tenant-tags.md @@ -75,7 +75,7 @@ octopus release deploy --project "My Project" --version "1.0.1" --tenant-tag "Re You can use tenant tags when: -- Deploying releases using [build server integrations](/docs/octopus-rest-api/) or the [Octopus CLI](/docs/cli/octopus-cli/deploy-release). +- Deploying releases using [build server integrations](/docs/api/) or the [Octopus CLI](/docs/cli/octopus-cli/deploy-release). - Scoping a deployment target to one or more tenants when registering a new Tentacle - read more in our [tenant infrastructure](/docs/tenants/tenant-infrastructure) section. - Automating Octopus via the [Octopus REST API](/docs/octopus-rest-api). diff --git a/src/scripts/search-engine.ts b/src/scripts/search-engine.ts index 01fff5040d..8b52993ceb 100644 --- a/src/scripts/search-engine.ts +++ b/src/scripts/search-engine.ts @@ -80,7 +80,7 @@ const SECTIONS: { prefix: RegExp; }[] = [ { facet: 'cli', kind: 'command', prefix: /^\/docs\/cli(\/|$)/ }, - { facet: 'api', kind: 'command', prefix: /^\/docs\/octopus-rest-api(\/|$)/ }, + { facet: 'api', kind: 'command', prefix: /^\/docs\/api(\/|$)/ }, { facet: 'integrations', kind: 'page', diff --git a/src/shared-content/octopus-rest-api/octopus-project-variables-include.mdx b/src/shared-content/octopus-rest-api/octopus-project-variables-include.mdx index 60312f2a93..c835105855 100644 --- a/src/shared-content/octopus-rest-api/octopus-project-variables-include.mdx +++ b/src/shared-content/octopus-rest-api/octopus-project-variables-include.mdx @@ -38,4 +38,4 @@ octopus project variable include --variable-set "Slack Variables" ## Learn more - [Octopus CLI](/docs/cli) -- [Creating API keys](/docs/octopus-rest-api/how-to-create-an-api-key) +- [Creating API keys](/docs/api/authentication/create-an-api-key) diff --git a/src/shared-content/octopus-rest-api/project-coordination-code-samples.include.md b/src/shared-content/octopus-rest-api/project-coordination-code-samples.include.md index 85f8ee954d..dec41746e2 100644 --- a/src/shared-content/octopus-rest-api/project-coordination-code-samples.include.md +++ b/src/shared-content/octopus-rest-api/project-coordination-code-samples.include.md @@ -3,7 +3,7 @@ These samples show how to perform various tasks related to project coordination. See the [OctopusDeploy-Api](https://github.com/OctopusDeploy/OctopusDeploy-Api) repository for further API documentation and examples using the [raw REST API](https://github.com/OctopusDeploy/OctopusDeploy-Api/tree/master/REST/PowerShell) or Octopus.Client in [C#](https://github.com/OctopusDeploy/OctopusDeploy-Api/tree/master/Octopus.Client/Csharp), [PowerShell](https://github.com/OctopusDeploy/OctopusDeploy-Api/tree/master/Octopus.Client/PowerShell) or [LINQPad](https://github.com/OctopusDeploy/OctopusDeploy-Api/tree/master/Octopus.Client/LINQPad). :::div{.success} -These examples use the [Octopus.Client](/docs/octopus-rest-api/octopus.client/) library, see the [Loading in an Octopus Step](/docs/octopus-rest-api/octopus.client/using-client-in-octopus/) section of the [Octopus.Client](/docs/octopus-rest-api/octopus.client) documentation for details on how to load the library from inside Octopus using PowerShell or C# Script steps. +These examples use the [Octopus.Client](/docs/api/octopus.client/) library, see the [Loading in an Octopus Step](/docs/api/octopus.client/using-client-in-octopus/) section of the [Octopus.Client](/docs/api/octopus.client) documentation for details on how to load the library from inside Octopus using PowerShell or C# Script steps. ::: ## Querying the current state diff --git a/src/shared-content/tentacle/configure-linux-polling-worker.include.md b/src/shared-content/tentacle/configure-linux-polling-worker.include.md index 9935b0eb65..7b38d8df49 100644 --- a/src/shared-content/tentacle/configure-linux-polling-worker.include.md +++ b/src/shared-content/tentacle/configure-linux-polling-worker.include.md @@ -5,7 +5,7 @@ 1. Configure the folder to store applications and press **Enter**. 1. Enter the **Octopus Server URL** (e.g. ) and press **Enter**. 1. Enter the authentication details the Tentacle will use to connect to the Octopus Server: - i. Select **1)** if using an Octopus API key, see [How to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key) or: + i. Select **1)** if using an Octopus API key, see [How to create an API key](/docs/api/authentication/create-an-api-key) or: ii. Select **2)** to provide a username and password you use to log into Octopus 1. Select **2) Worker** for the type of Tentacle to setup and press **Enter**. 1. Give the **Space** you wish to register the Tentacle in and press **Enter**. diff --git a/src/shared-content/tentacle/configure-polling-target.include.md b/src/shared-content/tentacle/configure-polling-target.include.md index 2f711ec22e..89e6e20ec2 100644 --- a/src/shared-content/tentacle/configure-polling-target.include.md +++ b/src/shared-content/tentacle/configure-polling-target.include.md @@ -4,7 +4,7 @@ a. The Octopus URL: the hostname or IP address. b. Select the authentication mode and enter the details: i. The username and password you use to log into Octopus, or: - i. Your Octopus API key, see [How to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key). + i. Your Octopus API key, see [How to create an API key](/docs/api/authentication/create-an-api-key). :::div{.hint} The Octopus credentials specified here are only used once to configure the Tentacle. All future communication is performed over a [secure TLS connection using certificates](/docs/security/octopus-tentacle-communication/#Octopus-Tentaclecommunication-Scenario:PollingTentacles). diff --git a/src/shared-content/tentacle/configure-windows-polling-worker.include.md b/src/shared-content/tentacle/configure-windows-polling-worker.include.md index fa2df182f0..1d5d052037 100644 --- a/src/shared-content/tentacle/configure-windows-polling-worker.include.md +++ b/src/shared-content/tentacle/configure-windows-polling-worker.include.md @@ -4,7 +4,7 @@ a. The Octopus URL: the hostname or IP address. b. Select the authentication mode and enter the details: i. The username and password you use to log into Octopus, or: - i. Your Octopus API key, see [How to create an API key](/docs/octopus-rest-api/how-to-create-an-api-key). + i. Your Octopus API key, see [How to create an API key](/docs/api/authentication/create-an-api-key). :::div{.hint} The Octopus credentials specified here are only used once to configure the Tentacle. All future communication is performed over a [secure TLS connection using certificates](/docs/security/octopus-tentacle-communication/#Octopus-Tentaclecommunication-Scenario:PollingTentacles). diff --git a/tests/code-block.spec.ts b/tests/code-block.spec.ts index f537241c17..1eea04b6b0 100644 --- a/tests/code-block.spec.ts +++ b/tests/code-block.spec.ts @@ -1,7 +1,7 @@ import { test, expect } from '@playwright/test'; // A page with two
panels, each a lone code block -const GROUPED = '/docs/octopus-rest-api/octopus.client/using-resources'; +const GROUPED = '/docs/api/octopus.client/using-resources'; // A page whose group panels hold prose as well as code, so they stay tabs const TABBED = '/docs/kubernetes/targets/kubernetes-agent/permissions'; From 5da8d4e590dfdc72406a2d055a161d1103847656 Mon Sep 17 00:00:00 2001 From: Orion Edwards Date: Wed, 2 Sep 2026 00:34:24 +1200 Subject: [PATCH 5/8] Fix broken redirect --- src/pages/docs/api-and-integration/migration-api/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/api-and-integration/migration-api/index.md b/src/pages/docs/api-and-integration/migration-api/index.md index 1cbdc36cf9..3b43368f00 100644 --- a/src/pages/docs/api-and-integration/migration-api/index.md +++ b/src/pages/docs/api-and-integration/migration-api/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Redirect.astro title: Redirect -redirect: https://octopus.com/docs/api/migration-api +redirect: https://octopus.com/docs/api/migrations pubDate: 2023-01-01 navSearch: false navSitemap: false From 290d3962500c684280c561afb3314db1d32b5ff8 Mon Sep 17 00:00:00 2001 From: Orion Edwards Date: Wed, 2 Sep 2026 00:39:25 +1200 Subject: [PATCH 6/8] FFS markdown lint --- src/pages/docs/kubernetes/live-object-status/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/kubernetes/live-object-status/installation.md b/src/pages/docs/kubernetes/live-object-status/installation.md index 1b7ddb0d63..42d2968079 100644 --- a/src/pages/docs/kubernetes/live-object-status/installation.md +++ b/src/pages/docs/kubernetes/live-object-status/installation.md @@ -32,7 +32,7 @@ Find the following values and replace them in the Helm command below | | Value | Example | | :----------- | :----------------------------------------------------------------------------------------------------: | :---------------------- | | INSTANCE_URL | The URL you access your instance with, without https:// or a trailing slash | my-instance.octopus.app | -| API_KEY | An [API key](/docs/api/authentication/create-an-api-key) for your user, created from your profile | API-MYKEY | +| API_KEY | An [API key](/docs/api/authentication/create-an-api-key) for your user, created from your profile | API-MYKEY | | SPACE_ID | The ID of the space your agent is installed in, find this in any Octopus url | Spaces-1 | | AGENT_NAME | The name of the Kubernetes agent | My Agent | | HELM_RELEASE | The name of the Helm release used to install the Kubernetes agent | myagent | From 78f8cd655a912bf69e475427e6824c269149749b Mon Sep 17 00:00:00 2001 From: Orion Edwards Date: Wed, 2 Sep 2026 00:51:33 +1200 Subject: [PATCH 7/8] Give node more memory so it doesn't crash --- package.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/package.json b/package.json index bf785fb0f3..f915c33ae7 100644 --- a/package.json +++ b/package.json @@ -15,14 +15,14 @@ "dev:astro": "astro dev", "dev:watch": "onchange 'src/**/*.{js,mjs,ts,astro,css}' -- prettier --write --plugin=prettier-plugin-astro {{changed}}", "astro": "astro", - "build": "astro build", + "build": "node --max-old-space-size=8192 node_modules/astro/bin/astro.mjs build", "crawl": "linkinator ./dist --skip \"^(?!http://localhost)\" --recurse --verbosity error", "format": "prettier --write --plugin=prettier-plugin-astro 'src/**/*.{js,mjs,ts,astro,css}'", "preview": "astro preview", "renovate": "renovate", "spellcheck": "git fetch origin main:refs/remotes/origin/main && git diff origin/main --name-only --diff-filter=ACMRTUXB | cspell --no-must-find-files --file-list stdin", "spellcheck-all": "cspell \"**/*.{md,mdx}\"", - "test": "astro build && npx playwright install chromium && npx playwright test", + "test": "node --max-old-space-size=8192 node_modules/astro/bin/astro.mjs build && npx playwright install chromium && npx playwright test", "watch": "onchange 'src/**/*.{js,mjs,ts,astro,css}' -- prettier --write --plugin=prettier-plugin-astro {{changed}}" }, "dependencies": { From d59ecfb70e5a15cfc1dc9d54078fa3b291053c13 Mon Sep 17 00:00:00 2001 From: Orion Edwards Date: Wed, 2 Sep 2026 00:54:14 +1200 Subject: [PATCH 8/8] Fix more links plus formatting --- src/lib/searchIndexing.ts | 3 +-- .../managing-infrastructure/rate-limiting.md | 2 +- .../reporting/report-on-deployments-using-excel.md | 2 +- src/pages/docs/api/authentication/openid-connect/index.md | 8 ++++---- src/pages/docs/octopus-cloud/disaster-recovery.md | 2 +- src/pages/docs/octopus-cloud/migrations.md | 2 +- .../build-servers/codefresh-pipelines.md | 2 +- .../docs/security/users-and-teams/service-accounts.md | 6 +++--- 8 files changed, 13 insertions(+), 14 deletions(-) diff --git a/src/lib/searchIndexing.ts b/src/lib/searchIndexing.ts index 0660907dac..34fc325c6a 100644 --- a/src/lib/searchIndexing.ts +++ b/src/lib/searchIndexing.ts @@ -47,8 +47,7 @@ export function searchIndexAttributes( pathname: string, frontmatter: Frontmatter ): IndexAttributes { - const indexable = - frontmatter.navSearch !== false; + const indexable = frontmatter.navSearch !== false; // `all` rather than the default `index`: a bare ignore still lets Pagefind // read a title or metadata out of the block. diff --git a/src/pages/docs/administration/managing-infrastructure/rate-limiting.md b/src/pages/docs/administration/managing-infrastructure/rate-limiting.md index 6ad7cd60e0..5c30422a36 100644 --- a/src/pages/docs/administration/managing-infrastructure/rate-limiting.md +++ b/src/pages/docs/administration/managing-infrastructure/rate-limiting.md @@ -33,7 +33,7 @@ The rate limit applies per user. ### Authenticated AI Agent Requests -This policy applies to any HTTP requests associated with an authenticated user which authenticate using an [agent API key](/docs/api/create-an-api-key#creating-an-agent-api-key). +This policy applies to any HTTP requests associated with an authenticated user which authenticate using an [agent API key](/docs/api/authentication/create-an-api-key#creating-an-agent-api-key). The rate limit applies per user, counted separately from non-AI requests. ### Webhook Trigger Requests diff --git a/src/pages/docs/administration/reporting/report-on-deployments-using-excel.md b/src/pages/docs/administration/reporting/report-on-deployments-using-excel.md index 4922585de8..7eac77e3fd 100644 --- a/src/pages/docs/administration/reporting/report-on-deployments-using-excel.md +++ b/src/pages/docs/administration/reporting/report-on-deployments-using-excel.md @@ -24,7 +24,7 @@ At a high-level, the steps are: Before we can report on the data using Excel, we need to export it in a format that Excel can import. The easiest way to do this is using an XML file. -Octopus exposes data on deployments through the `/api/reporting/deployments/xml` endpoint. You can use our [Octopus API clients](docs/api/#api-clients) to download the XML file. +Octopus exposes data on deployments through the `/api/reporting/deployments/xml` endpoint. You can use our [Octopus API clients](/docs/api/#api-clients) to download the XML file.
PowerShell diff --git a/src/pages/docs/api/authentication/openid-connect/index.md b/src/pages/docs/api/authentication/openid-connect/index.md index aca674d199..81bf81eab1 100644 --- a/src/pages/docs/api/authentication/openid-connect/index.md +++ b/src/pages/docs/api/authentication/openid-connect/index.md @@ -38,7 +38,7 @@ Any issuer that can generate signed OIDC tokens which can be validated anonymous ## Getting started with GitHub Actions -Follow the guide below to get started using OIDC with GitHub Actions. For more complex scenarios, or for a full list of available options, see [Using OpenID Connect with Octopus and GitHub Actions](/docs/api/openid-connect/github-actions). +Follow the guide below to get started using OIDC with GitHub Actions. For more complex scenarios, or for a full list of available options, see [Using OpenID Connect with Octopus and GitHub Actions](/docs/api/authentication/openid-connect/github-actions). ### Create an OIDC identity for a service account @@ -114,7 +114,7 @@ jobs: ## Getting started with other issuers -Follow the guide below to get started using OIDC with other issuers. For more complex scenarios, or for a full list of available options, see [Using OpenID Connect with Other Issuers](/docs/api/openid-connect/other-issuers). +Follow the guide below to get started using OIDC with other issuers. For more complex scenarios, or for a full list of available options, see [Using OpenID Connect with Other Issuers](/docs/api/authentication/openid-connect/other-issuers). ### Create an OIDC identity for a service account @@ -150,7 +150,7 @@ A Service Account Id will be shown, this will be a GUID which must be supplied a 1. Obtain an OIDC token from the issuer, the `aud` claim must be the Service Account Id. The process for obtaining the OIDC token from the issuer will differ by issuer, please consult your OIDC issuers documentation. 2. Get the token exchange endpoint for your Octopus server from the `token_endpoint` property of the OpenID Connect Discovery endpoint `https://my-octopus-server.com/.well-known/openid-configuration`. -3. Exchange the OIDC token for an Octopus access token, setting `audience` property to the Service Account Id from above. See [Exchanging an OIDC token for an Octopus access token](/docs/api/openid-connect/other-issuers#OidcOtherIssuers-TokenExchange) for more details on the token exchange request. +3. Exchange the OIDC token for an Octopus access token, setting `audience` property to the Service Account Id from above. See [Exchanging an OIDC token for an Octopus access token](/docs/api/authentication/openid-connect/other-issuers#OidcOtherIssuers-TokenExchange) for more details on the token exchange request. 4. Get the `access_token` from the token exchange response. ### Using the access token to access the Octopus API @@ -191,7 +191,7 @@ If you are encountering issues using OIDC validating identity tokens from your O - The audience must be the id of the service account and will be a GUID. - The issuer must be a URL using the HTTPS scheme. - The subject must match the configured subject on the OIDC identity and is *case-sensitive*. Support is available to include wildcard characters in the subject using `*` and `?` for multiple and single character matches respectively. -- If you are making the token exchange request manually (e.g. using an [issuer other than GitHub Actions](/docs/api/openid-connect/other-issuers)), check that the required fields are set correctly. See [Exchanging an OIDC token for an Octopus access token](/docs/api/openid-connect/other-issuers#OidcOtherIssuers-TokenExchange) for more information on the request format. +- If you are making the token exchange request manually (e.g. using an [issuer other than GitHub Actions](/docs/api/authentication/openid-connect/other-issuers)), check that the required fields are set correctly. See [Exchanging an OIDC token for an Octopus access token](/docs/api/authentication/openid-connect/other-issuers#OidcOtherIssuers-TokenExchange) for more information on the request format. - Check that the token has not expired (`exp`). Often identity tokens created by OIDC providers will have a short lifetime. - Check that the token is signed by a valid key from the issuer. Signing keys may be invalidated by providers under some circumstances. - Check that the public key used to sign the token are available using [OpenID discovery](https://openid.net/specs/openid-connect-discovery-1_0.html). diff --git a/src/pages/docs/octopus-cloud/disaster-recovery.md b/src/pages/docs/octopus-cloud/disaster-recovery.md index 126092a976..1cfad77c7b 100644 --- a/src/pages/docs/octopus-cloud/disaster-recovery.md +++ b/src/pages/docs/octopus-cloud/disaster-recovery.md @@ -66,4 +66,4 @@ In the case of an Azure region wide disaster the time to restore services will v ### Importing data -Due to some key differences between the self-hosted and cloud configurations, it **is not possible** to use the existing [Migration API](/docs/api/migration-api/) to import data. If you are migrating from an existing self-hosted instance please see [migrating from self-hosted to Octopus Cloud](/docs/octopus-cloud/migrations). +Due to some key differences between the self-hosted and cloud configurations, it **is not possible** to use the existing [Migration API](/docs/api/migrations) to import data. If you are migrating from an existing self-hosted instance please see [migrating from self-hosted to Octopus Cloud](/docs/octopus-cloud/migrations). diff --git a/src/pages/docs/octopus-cloud/migrations.md b/src/pages/docs/octopus-cloud/migrations.md index abc972da94..f93946807a 100644 --- a/src/pages/docs/octopus-cloud/migrations.md +++ b/src/pages/docs/octopus-cloud/migrations.md @@ -292,6 +292,6 @@ In our experience, most people turn off their Octopus Server in about three to s ## No longer offered or supported -Please note that our existing [Migration API](https://octopus.com/docs/api/migration-api) is **not supported** for migrations to cloud instances due to configuration differences between self-hosted and cloud installations. +Please note that our existing [Migration API](/docs/api/migrations) is **not supported** for migrations to cloud instances due to configuration differences between self-hosted and cloud installations. The legacy [Data Migration](https://octopus.com/docs/administration/data/data-migration) included with Octopus Deploy is **not supported** for migrations to cloud instances. That tool is a Windows command-line application that must be run directly on the server hosting Octopus Deploy via an RDP session. Octopus Cloud runs on our Linux Container image on a Kubernetes Cluster and therefore access to the Container is not permitted for security reasons. diff --git a/src/pages/docs/packaging-applications/build-servers/codefresh-pipelines.md b/src/pages/docs/packaging-applications/build-servers/codefresh-pipelines.md index 4f6425d7e8..8e4c7d2a65 100644 --- a/src/pages/docs/packaging-applications/build-servers/codefresh-pipelines.md +++ b/src/pages/docs/packaging-applications/build-servers/codefresh-pipelines.md @@ -324,7 +324,7 @@ Each step includes one or two examples to help with setting up a workflow. Basic ### Log into Octopus -The **octopusdeploy-login** step authenticates to Octopus via OIDC, so your Octopus server needs a [service account with OIDC enabled](/docs/api/openid-connect/other-issuers). +The **octopusdeploy-login** step authenticates to Octopus via OIDC, so your Octopus server needs a [service account with OIDC enabled](/docs/api/authentication/openid-connect/other-issuers). To allow connections from Codefresh, the service account's OIDC identity should have **Issuer** `https://oidc.codefresh.io` and a **Subject** matching the [Codefresh subject claim for your preferred pipeline trigger](https://codefresh.io/docs/docs/integrations/oidc-pipelines/#codefresh-trigger-types-for-subject-claims). The **octopusdeploy-login** step requires an `ID_TOKEN`, which can be generated by running the Codefresh **obtain-oidc-id-token** Marketplace step. This step sets the token as an environment variable which can be passed into the Octopus login step as an argument. See the [Codefresh OIDC documentation](https://codefresh.io/docs/docs/integrations/oidc-pipelines/) for further details. diff --git a/src/pages/docs/security/users-and-teams/service-accounts.md b/src/pages/docs/security/users-and-teams/service-accounts.md index 9fcf82ebef..fb7834a494 100644 --- a/src/pages/docs/security/users-and-teams/service-accounts.md +++ b/src/pages/docs/security/users-and-teams/service-accounts.md @@ -18,7 +18,7 @@ It is best to create **Service accounts** for this purpose to provide each servi :::div{.hint} **Service accounts** are **API-only accounts** that can be assigned permissions in the same way you do for normal accounts, but are prevented from using the Octopus Web Portal. -Service accounts authenticate with the Octopus API using [OpenID Connect](/docs/api/openid-connect) or an [Octopus API Key](/docs/api/authentication/create-an-api-key). For dedicated agent service accounts, see [Agent service accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts). +Service accounts authenticate with the Octopus API using [OpenID Connect](/docs/api/authentication/openid-connect) or an [Octopus API Key](/docs/api/authentication/create-an-api-key). For dedicated agent service accounts, see [Agent service accounts](/docs/security/users-and-teams/service-accounts#agent-service-accounts). ::: ## Creating a service account {#ServiceAccounts-CreatingAServiceAccount} @@ -37,12 +37,12 @@ Creating a new Service account is very similar to creating a new User account: ::: :::div{.hint} -This Service account is not very useful until it [belongs to one or more teams](/docs/security/users-and-teams/), and has one or more [OpenID Connect Identities](/docs/api/openid-connect) or [Octopus API keys](/docs/api/authentication/create-an-api-key) associated with it. +This Service account is not very useful until it [belongs to one or more teams](/docs/security/users-and-teams/), and has one or more [OpenID Connect Identities](/docs/api/authentication/openid-connect) or [Octopus API keys](/docs/api/authentication/create-an-api-key) associated with it. ::: ## OpenID Connect (OIDC) -You can use [OpenID Connect (OIDC)](/docs/api/openid-connect) to automate Octopus with another service without needing to provision or manage API Keys. To do this you configure a specific *OIDC Identity* for the service which allows it to connect to Octopus securely. The service then exchanges an ID token with Octopus for a short-lived access token which it can then use for API requests. +You can use [OpenID Connect (OIDC)](/docs/api/authentication/openid-connect) to automate Octopus with another service without needing to provision or manage API Keys. To do this you configure a specific *OIDC Identity* for the service which allows it to connect to Octopus securely. The service then exchanges an ID token with Octopus for a short-lived access token which it can then use for API requests. ## API Keys