---
id: deployment-strategy-update
title: "Update deployment strategy"
description: "Updates an existing deployment strategy"
sidebar_label: "Update deployment strategy"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "patch api-method"
info_path: docs/api/deployments
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Update deployment strategy"}
>
</Heading>

<MethodEndpoint
  method={"patch"}
  path={"/deployment_strategy/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Updates an existing deployment strategy

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"name":"id","in":"path","required":true,"description":"Deployment strategy ID.","example":"12345","schema":{"type":"string"}}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The name of the deployment strategy.","example":"Updated deployment strategy."},"description":{"type":"string","description":"A brief description of the deployment strategy.","example":"Updated strategy for critical deployments that checks error rate and rollbacks if needed."},"dimensions":{"type":"object","description":"Strategy dimensions for matching scopes.","additionalProperties":true,"default":{},"example":{"environment":"staging"}},"parameters":{"type":"object","description":"JSON Schema for validating strategy parameters.","additionalProperties":true,"default":{}},"scope_type_ids":{"type":"array","items":{"type":"string"},"description":"List of scope type IDs associated with this strategy.","example":["12345","67890"]}},"title":"updateDeploymentStrategy"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"Deployment strategy updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the deployment strategy.","example":"12345"},"name":{"type":"string","description":"Name of the deployment strategy.","example":"Critical deployment strategy"},"description":{"type":"string","description":"Description of the deployment strategy.","example":"Strategy for critical deployments that checks error rate and rollbacks if needed"},"nrn":{"type":"string","description":"The NRN of the entity that the deployment strategy is associated with.","example":"organization=1:account=2:namespace=3:application=4"},"dimensions":{"type":"object","description":"Strategy dimensions for matching scopes.","additionalProperties":true,"example":{"environment":"staging"}},"parameters":{"type":"object","description":"JSON Schema for validating strategy parameters.","additionalProperties":true,"default":{},"example":{"type":"object","title":"Deployment strategy parameters","properties":{"metrics":{"type":"object","description":"Configure metric-based rollback","properties":{"enabled":{"type":"boolean","default":true},"rules":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","examples":["http.error_rate"]},"threshold":{"type":"number"},"operator":{"type":"string","enum":["greater_than","less_than","equals"]}},"required":["name","threshold","operator"]},"default":[{"name":"http.error_rate","threshold":0.5,"operator":"less_than"}]}},"required":["enabled"]},"traffic":{"type":"object","description":"Configure traffic switching","properties":{"enable_auto_switch":{"type":"boolean","default":false},"interval":{"type":"integer","default":10},"step":{"oneOf":[{"const":0.1,"title":"10%"},{"const":0.5,"title":"50%"},{"const":1,"title":"100%"}],"default":0.1}},"required":["enable_auto_switch","interval","step"]}},"required":["metrics","traffic"]}},"scope_type_ids":{"type":"array","items":{"type":"string"},"description":"List of scope type IDs associated with this strategy.","example":["12345","67890"]},"created_by":{"type":"string","description":"ID of the user who created the strategy.","example":"123"},"updated_by":{"type":"string","description":"ID of the user who last updated the strategy.","example":"456"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when the strategy was created.","example":"2023-10-01T12:34:56Z"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when the strategy was last updated.","example":"2023-10-01T12:34:56Z"}},"required":["id","name","nrn"],"title":"deploymentStrategy"}}}},"400":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"500":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>