---
title: "Modify an existing action template."
method: PUT
path: "/actiontemplates/{id}"
tags: ["ActionTemplates"]
---

# Modify an existing action template.

`PUT /actiontemplates/{id}`

## Path parameters

- `id` string, required

## Request body

- ModifyActionTemplateCommand
  - `Description` string — The description of the Action Template.
  - `GitDependencies` GitDependencyResource[]
    - `DefaultBranch` string, required
    - `FilePathFilters` string[]
    - `GitCredentialId` string
    - `GitCredentialType` string, required
    - `GitHubConnectionId` string
    - `Name` string, required
    - `RepositoryUri` string, required
    - `StepPackageInputsReferenceId` string
  - `Id` string, required — The id of the existing Action Template.
  - `Inputs` StepPackageInputsResource
    - `Value` unknown
  - `Name` string, required — The name of the Action Template.
  - `Packages` PackageReferenceResource[]
    - `AcquisitionLocation` string — The package-acquisition location. One of PackageAcquisitionLocationResource or a variable-expression
    - `FeedId` string — Feed ID, name or a variable-expression
    - `Id` string
    - `Name` string — A name for the package-reference. This may be empty. This is used to discriminate the package-references. Package ID isn't suitable because an action may potentially have multiple references to the same package ID (e.g. if you wanted to use different versions of the same package). Also, the package ID may be a variable-expression.
    - `PackageId` string — Package ID or a variable-expression
    - `Properties` object
    - `StepPackageInputsReferenceId` string — This reference identifier is populated when a step package step contains a package reference It allows us to correlate the reference within the step package inputs to this Server package reference
    - `Version` string — Specific version to use for this package. If not specified, package can be selected at release creation or runbook run time.
  - `Parameters` 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
  - `Properties` object
  - `SpaceId` string, required — The id of the Space that contains the Action Template.
  - `StepPackageVersion` string

## Response `200`

Confirmation that the Action Template was modified, including the updated template.

- ActionTemplateResource
  - `ActionType` string, required
  - `CommunityActionTemplateId` string
  - `Description` 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 — Gets or sets a unique identifier for this resource.
  - `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.
  - `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, required
  - `Packages` PackageReferenceResource[]
    - `AcquisitionLocation` string — The package-acquisition location. One of PackageAcquisitionLocationResource or a variable-expression
    - `FeedId` string — Feed ID, name or a variable-expression
    - `Id` string
    - `Name` string — A name for the package-reference. This may be empty. This is used to discriminate the package-references. Package ID isn't suitable because an action may potentially have multiple references to the same package ID (e.g. if you wanted to use different versions of the same package). Also, the package ID may be a variable-expression.
    - `PackageId` string — Package ID or a variable-expression
    - `Properties` object
    - `StepPackageInputsReferenceId` string — This reference identifier is populated when a step package step contains a package reference It allows us to correlate the reference within the step package inputs to this Server package reference
    - `Version` string — Specific version to use for this package. If not specified, package can be selected at release creation or runbook run time.
  - `Parameters` 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
  - `Properties` object
  - `SpaceId` string
  - `Version` 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)