---
id: dimension-write
title: "Update a dimension"
description: "Updates an dimension."
sidebar_label: "Update a dimension"
hide_title: true
hide_table_of_contents: true
api: eJzdWNtu2zgQ/RVinlJAcZzbXgTkwU27aPahCFIHLZAGwVgcS2wlUiUpu66hf18MJdtS7DbZbbIL7IssS6O5HJ5DcrgESS6xqvTKaIjhupToyQnUQqqCtFNGDyACU5JFtrmQEMP6VTy3yhNE4DF1EN/Aq9UbuI2gRIsFebL8agmKA5ToM4hAY0EQg5IQgUsyKhDiJfhFGZ5qTylZqCOw9KVSliTE3lYU3ct2nJG4eCXMVPiM+gnTVyzKnCA+PDo+qW8bT+T8SyMXHCox2pP2fItlmaskVHfwybHj5XZOZvKJEg8RlJax8IpcsPPoK9exc94qnXICuioYEUy8mjFESre3t53sVq/rCIyVZHegEEGhtCrY2+EuAEqrjFV+IXym3AYEMVd5LjKckZhnpGlGVthKe1WQSIyeqrRqRlTMMK94yC2JgmxKUuzlZk5WlJbywIZMpRlZoatiQta96MFb1xF45UMxrf+7nv+7dUrvA1nqmj9xlFScdWDGhNCSHVU+g/jmthktVxrtGpCPhkP+2S59zUoxRydclSTk3LTKmQBPNMBK7hySfi4j4RbOU7E/V5JEpdWXKhDTUmnJkfZKpw9RdKWJbSZt182WW6zveoTXeqas0QUjwGh/l6bbzhvbxn2XUIN/QmqXV+nDYUehon1JVs1IisbqsegB9WvVVj8c8e3VW7GHXhgrJpSb+QsWiaV+GBGIQ64fztgUtfoW6HR2GGOSmEr7s6OYa3AlJnR2HHcod3byHOrO0D25rvukrCNoPOwSyXaiq2gzVDlOchJTY3cw6DnVFVLoFfH7b7/+8vPK2uEY3nlM2cnPiWv3wO0K/FzCe1Bru4p3m+KfUG0h0NNp7vHr0l2I/He+aBexkw8fthem81yR9oKsNVas1zEhKxLeCKVnmCsplC6rAEihnGPQN5uln1q9Nhumm5aY50YyYUI+PN2Qc5gG3uzaygTrhzX5Zjy+XJE5MZK2CeRKStRUJSLp4rFHg3QQiZPhkC+HfDnmy0l/8jkZDmsGQT5CtiNRYJIpTfuWUIapp4kV8vIZepGgp9RY9Y1ckxtZnjanqPLK3uP2BOVdu1dkfjewPSKJiVU0jURWFag3mXSsVtNKkxy7W6HxEV6iFFdN0I/AD641Vj4LKcuP0Aena80prkb04SSlVHyLuZDkUeVO4MRUfpNWPw5PWC0UYYNVYD41tiApArrao9Ik15TuMriuG4Wc7lLIuwb++wpRWgae65TbD+VcRcLokNzo8kI4Jel/Jg3XBaIlwylL43R4xJfj/sCf/neq4GKtxvyuMbprIPvX9HHRhhctdV6zTaMUfqISEtd6vfXYEszOz59VOiMtKk1fS0o8ybYkkySVtSQH4jIndCS8XQhMUWnB2zG7Uk3Iy2dGNu1ywv1yaJtjOFivQAdLJWtunkNFTYNd2RxiyLwvXXxwgKUa6CrPyxw9y3aQmAK4t1q1Xu9YKQ3Buw3YGgp2tGrPw8wYjCBqb/4wtkAPMfz5fhzWTlbg1abLfr0CY9Mlb7Yv7XaYN5lKTw0bcRkN2IeD4WAIm8V4fajgeMxK43yBQevtKUJzaCGw1wv1xq/T73/3iKOt2tNXf1DmqDQHC5AuW/hvoBsgVpJnisw4z6+Wywk6urZ5XfPjLxVZbm5veRdtFdMyjJFUju8lxFPM3f0TjW6ee1ftfPVC/OCcY2fW7UPUC2g38RADRPCZFs2hS31bR5ARhkG4WbYvzpvY+2P+fPPh1ixbR6svRklCpf+h7W2HzZej8fkbJlB7CFOEqQwsznl6xnmTpQlgBF6GZ0vIUadV0Ck0Tplu2GfrPXaGsnbisFw2FmPzmXRdr2Hx/J+Rqeu/AKV/pgA=
sidebar_class_name: "patch api-method"
info_path: docs/api/dimensions
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 a dimension"}
>
</Heading>

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



Updates an dimension.

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

<ParamsDetails
  parameters={[{"in":"path","name":"id","schema":{"type":"integer"},"required":true,"description":"The ID of the dimension.","example":1234}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["active","inactive"],"example":"active"},"order":{"type":"integer","minimum":1,"description":"The priority this dimension will have whenever runtime configuration values are merged (lower prelates higher numbers)","example":1}},"title":"runtime_configuration_dimensionWrite"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"A system-wide unique ID representing the dimension.","example":1234},"name":{"type":"string","description":"The name of the dimension","example":"Environment"},"status":{"type":"string","description":"The status of this dimension.","enum":["active","inactive"],"example":"active"},"slug":{"type":"string","description":"A name-derived string representing the dimension.","example":"environment"},"nrn":{"type":"string","description":"NRN (at or below) where the dimension applies.","example":"organization=1:account=2:namespace=3:application=4"},"order":{"type":"integer","minimum":1,"description":"The priority this dimension has whenever runtime configuration values are merged (lower prelates higher numbers).","example":1},"values":{"type":"object","description":"The values available for this dimension.","properties":{"id":{"type":"integer","description":"A system-wide unique ID representing the value.","example":9876},"name":{"type":"string","description":"The name of the dimension value.","example":"Staging"},"status":{"type":"string","description":"The status of this runtime configuration dimension value.","enum":["active","inactive"],"example":"active"},"slug":{"type":"string","description":"A string representing the dimension value.","example":"staging"},"nrn":{"type":"string","description":"NRN (at or below) where the dimension value applies.","example":"organization=1:account=2:namespace=3:application=4"}},"title":"runtime_configuration_dimension_value"}},"title":"runtime_configuration_dimension"}}}},"4XX":{"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."}}}}}},"5XX":{"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>