---
id: nrn-write
title: "Replace an NRN"
description: "Replaces an NRN. This operation overwrites any previous value."
sidebar_label: "Replace an NRN"
hide_title: true
hide_table_of_contents: true
api: eJzdV9tuGzcQ/RWCT4mxlpTEflnAARwnQV2ghuHISABbMEbkSMt6l9zwIkUR9hv63qd+Rr+nP9BfKIZcSSvJSZqiN+RlvaaG5JnDc2aHSy7RCatqr4zmOb/CugSBjoFmF1cXPTYslGOmRgsUwcwM7dwqHyMWrLY4UyY4NoMyYO9W3+rnt/o5++3nX37/9Sd2cPASa4sizdXGK4EHB23MzsqVmhaejZFZrMwMJVOa+QLZJPhgscfe0i/CVBVqyYJTespuLq2ZKYnWjR71pRGuX68G+gR0pnD+mCntPILs8YyvdzuXPOfa6jzmwjPuYep4fsMvri74KOM1WKjQo6XBJddQYZrAM66Ipxp8wTNu8X1QFiXPvQ2Y7ZA5LJBIZN6wUEvwSBicKLACni+5X9S0qvNW6SlvMo4foKpLGjN2Clp9jFhPnuQghAnanzzNCYmrQeDJsxzqulSJ25Mj3owSHHT+hZEL2kAY7VF7eu3E9n90hG65j8SMf0Th+W4ap5qlX9i8QIvsHheOWTpYh9rHDOPxO2Ysq62ZqBIdpbrOZ8lh7nolVGMJr4MWtPBF4vSHxWog7jvD0tQVap/ncYqZ3lkEifbOmsiMxFl6zXhtjQxx6qeCKSK9Nxn3ysfBC6vPLIJH3jRNk3GHIljlF/GkxwgW7WnwBc9vRolTVxvt0FEaTwcD+rN/zBsdz8ExF4RA5yahJBr+8jFs1HXTam99/C7lH6mOgrWEwKsEk4L3BLZ3rMwtnMfqcK4ksqDV+4Ds/CWbGMssOhOswK1T/KQqid0Osq8WFIIoSFUbUTkGbL1ixkBLpnxbZZiK1aldgcgFpakc3OPiMEXUoOyuArcBTkszhjLSbyo8vMcFEUWvcYVWGmuGvyKlDiAqX6slGMxAlTAuMRLsqfhRgd0G2d2wY4Y1znUSn0HeNcYXJ4I2vkDbyTomvvIKCSmNHL17t6/8s1JRBUBrk2aSUZgMSDVP6RmUigp5HTzVhkq5WLc31fVvs4fz4IM7M5IKQ8TDM16hczDFfX90ojfrKu1xinbvaL8bDi9ZmsGEkbhR6eqMXY1CTZRgosvHI+xNexk7Ggzo8YQez+hx9Hjr0I8Gg4ZI2MLySctWIAql8ZDqXBRT2ivi8gV4JsDj1Fj1EV3ChnaGlk1AlfQZ3fLzGORd+8mIn59I258AMbYKJxkrQgV6g6QTxcwkbp7A0XIrNm75C5DsKm16y2ngWkPwRYQsb/k2Od1ogrg60S+DlFLRK5RMogdVOgZjE/wG1vY+VMNbKmIFr6CcGFuhZJHdaOnYkyRJdxW88szxQw55k+jfdYjSMupcT6mUKecCMpP6ndPLc+aUxG/MGq5LRCuGY7LG8eApPZ5tH/zxf+cKStZqKO9S0F2i7F/zx3m7PWul84piklNoRAlk13r9MdkzzIPT/1HrnGoWNH6oUXiUbUpGiGAtyh67LBEcMm8XDKagNCvBo+1tPjUV+sJQO14HUm5srHPe11b3l9rqhlrmmEpqxYMtec4L72uX9/tQq54OZVmX4MmvPWGq2Amvmro3ZJGk7G5rt+aAFlo15bEkxiCetS+vja3A85x//3bICS1Z72rTZb/6X3W4Sk8MQSGy0lk+6Q16A97pfa8uYoNgnK9Ar9qizb2vvfbtaqJzlfjGb4itLDx+8P26BKWJrqi5ZSvNVSue059RxgvjPI0ul2NweG3LpqHh9wEtXSlGGZ+BVeTVqF+pHL1Lnk+gdLtXxi7Rj67aIv6YPXiRfBBqOwh6wWljaupyzjOeur3Yzo2ajBdRRBFQ+uUsbXs4pPmbmXtfnSZbzTgVAmv/2dhRx92X10NyVXszrWJh5xbm9LGCeQJpIgvRrHFsyUvQ0xCrFk9Lkgdh28I7lo1JPUjDcpkihuYeddOsWfH0P/HSNH8AcN75AQ==
sidebar_class_name: "put api-method"
info_path: docs/api/nrn
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={"Replace an NRN"}
>
</Heading>

<MethodEndpoint
  method={"put"}
  path={"/nrn/{nrn}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Replaces an NRN. This operation overwrites any previous value.

>
> ⚠️ **Deprecation notice**
>
> This operation might be removed in the future. We recommend using [Providers](/docs/providers/overview) instead.

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

<ParamsDetails
  parameters={[{"name":"nrn","in":"path","required":true,"description":"The NRN to update.","schema":{"type":"string"},"example":"organization=1:account=2:namespace=3:application=4"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","description":"An object where keys represent NRN values or profiles.","example":{"aws.lambdaFunctionName":"MyFunction","development::aws.log_reader_role":"dev_role","production::aws.log_reader_role":"prod_role"},"title":"NrnCreate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["nrn","namespaces","profiles"],"properties":{"nrn":{"type":"string","description":"A system-wide unique ID for resource.","example":"organization=1:account=2"},"namespaces":{"type":"object","description":"An object where each key represents a namespace, and its value is an object containing key-value pairs.","example":{"namespaces":{"global":{"some-key":"some-value"}}}},"profiles":{"type":"object","description":"An object containing the profiles available for this NRN.","example":{"profiles":{"development":{"some-namespace":{"some-key":"some-value"},"production":{"some-namespace":{"some-key":"another-value"}}}}}}},"title":"nrn"}}}},"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>