---
id: deployment-strategy-read
title: "Read a deployment strategy by ID"
description: "Retrieves a specific deployment strategy by its ID."
sidebar_label: "Read a deployment strategy by ID"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get 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={"Read a deployment strategy by ID"}
>
</Heading>

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



Retrieves a specific deployment strategy by its ID.

<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={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"Deployment strategy details","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>