---
title: "Get the runbook process for the given ID"
method: GET
path: "/spaces/{spaceIdentifier}/projects/{projectId}/{gitRef}/runbookProcesses/{id}"
tags: ["RunbookProcesses"]
---

# Get the runbook process for the given ID

`GET /spaces/{spaceIdentifier}/projects/{projectId}/{gitRef}/runbookProcesses/{id}`

## Path parameters

- `spaceIdentifier` string, required
- `projectId` string, required
- `gitRef` string, required
- `id` string, required

## Response `200`

Returns the Runbook Process

- RunbookProcessResource
  - `Id` string
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `LastSnapshotId` string
  - `Links` object
  - `ProjectId` string
  - `RunbookId` string
  - `SpaceId` string
  - `Steps` DeploymentStepResource[]
    - `Actions` DeploymentActionResource[]
      - `ActionType` string
      - `AvailableStepPackageVersions` string[]
      - `CanBeUsedForProjectVersioning` boolean
      - `Channels` string[]
      - `ChannelsVariable` string
      - `CommunityActionTemplateSnapshot` CommunityActionTemplateSnapshotResource
        - `Id` string
        - `Parameters` ActionTemplateParameterResource[]
          - `DefaultValue` PropertyValueResource
            - `IsSensitive` boolean
            - `SensitiveValue` SensitiveValue
              - …
            - `Value` string
          - `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
  - `Version` integer, 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)