---
id: deployment-strategy-list
title: "List deployment strategies"
description: "Retrieves a paginated list of deployment strategies"
sidebar_label: "List deployment strategies"
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={"List deployment strategies"}
>
</Heading>

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



Retrieves a paginated list of deployment strategies

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

<ParamsDetails
  parameters={[{"name":"offset","in":"query","description":"Number of items to skip.","required":false,"schema":{"type":"integer","default":0},"example":0},{"name":"limit","in":"query","description":"Maximum number of items to return.","required":false,"schema":{"type":"integer","default":50,"maximum":100},"example":50},{"name":"nrn","in":"query","description":"Filter by NRN.","required":true,"schema":{"type":"string"},"example":"organization=1:account=2:namespace=3:application=4"},{"name":"scope_type_id","in":"query","description":"Filter by scope type ID.","required":false,"schema":{"type":"string"},"example":"12345"},{"name":"include","in":"query","description":"Include related entities (types).","required":false,"schema":{"type":"string","enum":["types"]}}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"List of deployment strategies matching the query\"","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"properties":{"paging":{"required":["offset","limit","total"],"properties":{"total":{"type":"integer","description":"The total number of results matching the query.","example":30},"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"results":{"type":"array","items":{"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"}}},"title":"deploymentStrategyPaginatedList"}}}},"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>