Scopes

The scope defines the level at which an integration is available within your workspace. This determines where the integration can be used across projects, pipelines, and environments.

Scope levels

There are three scope levels available for integrations:

  • Workspace - the integration is available globally to all pipelines across all projects in your workspace.
  • Project - the integration is available to all pipelines within a specific project.
  • Environment - the integration is available only to pipelines with permissions to the specific environment.

Available scope options

The available scope options depend on where you add the integration:

  • When adding an integration from a project, you can choose between Project or Workspace scope.
  • When adding an integration from an environment, you can choose between Environment or Workspace scope.
  • When adding an integration from the workspace level, you can set it to Workspace scope.
Warning
The scope can only be set when adding an integration and cannot be changed afterwards. If you need a different scope, you must create a new integration.
Hint
The scope defines where the integration is available, while permissions define who can use and manage it.

Last modified on Nov 21, 2025