---
title: "List all of the projects in the supplied Octopus Deploy Space, from all project groups. The results will be sorted alphabetically by name."
method: GET
path: "/{spaceId}/projects"
tags: ["Projects"]
---

# List all of the projects in the supplied Octopus Deploy Space, from all project groups. The results will be sorted alphabetically by name.

`GET /{spaceId}/projects`

## Path parameters

- `spaceId` string, required

## Query parameters

- `clonedFromProjectId` string
- `ids` string[]
- `name` string
- `partialName` string
- `skip` integer
- `take` integer

## Response `200`

List all of the projects in the supplied Octopus Deploy Space, from all project groups. The results will be sorted alphabetically by name.

- ProjectResourceCollection
  - `Id` string — Gets or sets a unique identifier for this resource.
  - `Items` ProjectResource[]
    - `AllowIgnoreChannelRules` boolean
    - `AutoCreateRelease` boolean
    - `AutoDeployReleaseOverrides` AutoDeployReleaseOverrideResource[]
      - `EnvironmentId` string
      - `ReleaseId` string
      - `TenantId` string
    - `ClonedFromProjectId` string
    - `CombineHealthAndSyncStatusInDashboardLiveStatus` boolean
    - `DefaultGuidedFailureMode` 'EnvironmentDefault' | 'Off' | 'On'
    - `DefaultPowerShellEdition` string
    - `DefaultToSkipIfAlreadyInstalled` boolean
    - `DeploymentChangesTemplate` string
    - `DeploymentProcessId` string
    - `DeprovisioningRunbookId` string
    - `Description` string
    - `DiscreteChannelRelease` boolean — Treats releases of different channels to the same environment as a seperate deployment dimension. 'False' indicates a "hotfix"-style usage of channels (single release active per environment ignoring channels), whereas `True` indicates "microservice"-style usage (single release per environment per channel)
    - `ExecuteDeploymentsOnEventBasedPipeline` boolean
    - `ExtensionSettings` ExtensionSettingsValues[]
      - `ExtensionId` string
      - `Values` unknown
    - `ForcePackageDownload` boolean
    - `Icon` IconResource
      - `Color` string — Icon background colour, as a Hex string
      - `Id` string — Font Awesome Icon Id
    - `Id` string — Gets or sets a unique identifier for this resource.
    - `IncludedLibraryVariableSetIds` string[] — Library variable sets included in the project. Sets are listed in order of precedence, with earlier items in the list overriding any variables with the same name and scope definition appearing later in the list.
    - `IsBadgesEnabled` boolean
    - `IsDisabled` boolean
    - `IsVersionControlled` boolean
    - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
    - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
    - `LifecycleId` string
    - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
    - `Name` string
    - `PersistenceSettings` PersistenceSettingsResource
      - `Type` 'Database' | 'VersionControlled'
    - `ProjectConnectivityPolicy` DeploymentConnectivityPolicy
      - `AllowDeploymentsToNoTargets` boolean
      - `ExcludeUnhealthyTargets` boolean
      - `SkipMachineBehavior` 'None' | 'SkipUnavailableMachines'
      - `TargetRoles` string[]
    - `ProjectGroupId` string
    - `ProjectTags` string[] — List of tags assigned to this project
    - `ProjectTemplateDetails` ProjectTemplateDetailsResource
      - `IsShared` boolean
      - `Slug` string, required
      - `VersionMask` string, required
    - `ProvisioningRunbookId` string
    - `ReleaseCreationStrategy` ReleaseCreationStrategyResource
      - `ChannelId` string
      - `ReleaseCreationPackage` DeploymentActionPackageResource
        - `DeploymentAction` string — The name or ID of the deployment action
        - `PackageReference` string — The name or ID of the package reference
    - `ReleaseNotesTemplate` string
    - `Slug` string
    - `SpaceId` string
    - `Templates` ActionTemplateParameterResource[]
      - `DefaultValue` PropertyValueResource
        - `IsSensitive` boolean
        - `SensitiveValue` SensitiveValue
          - `HasValue` boolean
          - `Hint` string
          - `NewValue` string
        - `Value` string
      - `DisplaySettings` object
      - `HelpText` string
      - `Id` string
      - `Label` string
      - `Name` string
    - `TenantedDeploymentMode` 'Untenanted' | 'TenantedOrUntenanted' | 'Tenanted'
    - `VariableSetId` string
    - `VersioningStrategy` VersioningStrategyResource
      - `DonorPackage` DeploymentActionPackageResource
        - `DeploymentAction` string — The name or ID of the deployment action
        - `PackageReference` string — The name or ID of the package reference
      - `Template` string
  - `ItemsPerPage` integer
  - `ItemType` string
  - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
  - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
  - `LastPageNumber` integer
  - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
  - `NumberOfPages` integer
  - `TotalResults` integer

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/revisions/b296c3a60aa5/schema)