---
title: "Retrieve a single published process template and its version by version mask (no space context)"
method: GET
path: "/platformhub/processtemplates/{slug}/{versionMask}"
tags: ["ProcessTemplates"]
---

# Retrieve a single published process template and its version by version mask (no space context)

`GET /platformhub/processtemplates/{slug}/{versionMask}`

## Path parameters

- `slug` string, required
- `versionMask` string, required

## Response `200`

The requested published process template and its version

- GetPublishedProcessTemplateByVersionMaskResponse
  - `ProcessTemplate` ProcessTemplateResource, required
    - `Description` string
    - `GitRef` string
    - `Icon` IconResource
      - `Color` string
      - `Id` string
    - `Id` string
    - `Name` string
    - `Parameters` ProcessTemplateParameterResource[]
      - `DisplaySettings` object
      - `HelpText` string
      - `IsOptional` boolean
      - `Label` string
      - `Name` string
      - `Values` TemplateParameterValueResource[]
        - `Scope` object, required
          - `Project` string[]
          - `Environment` string[]
          - `Machine` string[]
          - `Role` string[]
          - `TargetRole` string[]
          - `Action` string[]
          - `User` string[]
          - `Trigger` string[]
          - `ParentDeployment` string[]
          - `Private` string[]
          - `Channel` string[]
          - `TenantTag` string[]
          - `Tenant` string[]
          - `ProcessOwner` string[]
          - `ProjectTemplate` string[]
          - `TemplatedProject` string[]
          - `ProcessTemplateStep` string[]
          - `EnvironmentParameter` string[]
          - `TargetTagParameter` string[]
          - `TenantTagParameter` string[]
        - `Value` PropertyValueResource, required
          - `IsSensitive` boolean
          - `SensitiveValue` SensitiveValue
            - `HasValue` boolean
            - `Hint` string
            - `NewValue` string
          - `Value` string
    - `Slug` string
    - `Steps` DeploymentStepResource[]
      - `Actions` DeploymentActionResource[]
        - `ActionType` string
        - `AvailableStepPackageVersions` string[]
        - `CanBeUsedForProjectVersioning` boolean
        - `Channels` string[]
        - `ChannelsVariable` string
        - `CommunityActionTemplateSnapshot` CommunityActionTemplateSnapshotResource
          - `Id` string
          - `Parameters` ActionTemplateParameterResource[]
            - `DefaultValue` PropertyValueResource
              - …
            - `DisplaySettings` object
            - `HelpText` string
            - `Id` string
            - `Label` string
            - `Name` string
          - `Version` integer
        - `Condition` 'Success' | 'Variable'
        - `Container` DeploymentActionContainerResource
          - `Dockerfile` string
          - `FeedId` string
          - `GitUrl` string
          - `Image` string
        - `Environments` string[]
        - `EnvironmentsVariable` string
        - `ExcludedEnvironments` string[]
        - `ExcludedEnvironmentsVariable` string
        - `GitDependencies` GitDependencyResource[]
          - `DefaultBranch` string, required
          - `FilePathFilters` string[]
          - `GitCredentialId` string
          - `GitCredentialType` string, required
          - `GitHubConnectionId` string
          - `Name` string, required
          - `RepositoryUri` string, required
          - `StepPackageInputsReferenceId` string
        - `Id` string
        - `Inputs` StepPackageInputsResource
          - `Value` unknown
        - `IsDisabled` boolean
        - `IsRequired` boolean
        - `LastModifiedBy` string
        - `LastModifiedOn` string, date-time
        - `LastSavedStepPackageVersion` string
        - `Links` object
        - `Name` string
        - `Notes` string
        - `Packages` PackageReferenceResource[]
          - `AcquisitionLocation` string
          - `FeedId` string
          - `Id` string
          - `Name` string
          - `PackageId` string
          - `Properties` object
          - `StepPackageInputsReferenceId` string
          - `Version` string
        - `Properties` object
        - `Slug` string
        - `StepPackageVersion` string
        - `TenantTags` string[]
        - `TenantTagsVariable` string
        - `WorkerPoolId` string
        - `WorkerPoolVariable` string
      - `Condition` 'Success' | 'Failure' | 'Always' | 'Variable'
      - `Id` string
      - `Name` string, required
      - `PackageRequirement` 'LetOctopusDecide' | 'BeforePackageAcquisition' | 'AfterPackageAcquisition'
      - `Properties` object
      - `Slug` string
      - `StartTrigger` 'StartAfterPrevious' | 'StartWithPrevious'
      - `Type` string
  - `ProcessTemplateVersion` string, required

## 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/versions/bc9158facfc7/schema)