---
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","description":"The number of results returned per page. Defaults to 30.","example":30}}},"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>