---
title: "Modifies an existing approval policy in the specified Octopus Deploy space."
method: PUT
path: "/spaces/{spaceIdentifier}/approvalpolicies/{id}"
tags: ["ApprovalPolicies"]
---

# Modifies an existing approval policy in the specified Octopus Deploy space.

`PUT /spaces/{spaceIdentifier}/approvalpolicies/{id}`

## Path parameters

- `spaceIdentifier` string, required
- `id` string, required

## Request body

- ModifyApprovalPolicyCommand
  - `AllowSelfApproval` boolean — Whether deployment creators are allowed to approve their own deployments
  - `ApprovingTeamIds` string[] — A list of team ids who are authorized to approve deployments
  - `ApprovingUserIds` string[] — A list of user ids who are authorized to approve deployments
  - `Description` string
  - `Id` string, required
  - `IdScopes` ApprovalPolicyIdScopeResource[] — A list of project and environment ids this approval policy will apply to
    - `EnvironmentIds` string[], required — IDs of Environments to include in the scope
    - `Id` string
    - `ProjectId` string, required — ID of Project to include in the scope
  - `IsDisabled` boolean — Whether this approval policy is disabled
  - `MinimumApproversRequired` integer — Set a number of minimum approvers required to authorize the deployment
  - `Name` string, required
  - `ScopingStrategy` string — How to scope this approval policy. ["Tag", "Id"]
  - `SpaceId` string, required
  - `TagScopes` ApprovalPolicyTagScopeResource[] — A list of project and environment tags this approval policy will apply to
    - `EnvironmentTags` string[], required — Canonical IDs or Names of Environment tags to include in the scope
    - `Id` string
    - `ProjectTags` string[], required — Canonical IDs or Names of Project tags to include in the scope
  - `TenantApprovalStrategy` string

## Response `200`

Success

- ApprovalPolicyResource
  - `AllowSelfApproval` boolean
  - `ApprovingTeamIds` string[]
  - `ApprovingUserIds` string[]
  - `Description` string
  - `Id` string, required
  - `IdScopes` ApprovalPolicyIdScopeResource[]
    - `EnvironmentIds` string[], required — IDs of Environments to include in the scope
    - `Id` string
    - `ProjectId` string, required — ID of Project to include in the scope
  - `IsDisabled` boolean
  - `MinimumApproversRequired` integer
  - `Name` string, required
  - `ScopingStrategy` string
  - `SpaceId` string, required
  - `TagScopes` ApprovalPolicyTagScopeResource[]
    - `EnvironmentTags` string[], required — Canonical IDs or Names of Environment tags to include in the scope
    - `Id` string
    - `ProjectTags` string[], required — Canonical IDs or Names of Project tags to include in the scope
  - `TenantApprovalStrategy` string

## 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)